Share via

Hosted Exchange::ExchangeEnableOrganization

  • Article

This procedure enables an organization for Exchange Mailboxes. The procedure is called by CreateBusinessOrganization.

Arguments

Input argument Required Description

<path>

Yes

The Lightweight Directory Access Protocol (LDAP) path of organization.

<mailStore><megabytes>

Yes

This is the amount of storage available for mail storage. This parameter is ignored if the <sourceMailStores> parameter is supplied.

<mailStore><shared>

Yes

If this parameter is 0, the organization is given one or more mail stores which will not be shared with other organizations. (Unshared mail stores are those which were added using AddExchangeResources with their <shared> parameter as 0.) If the <mailStore><shared> parameter is 1, mail storage will be allocated from one or more shared mail stores. Shared mail stores may or may not be shared with other organizations.

<SMTPDomain>

Yes

The organization's primary SMTP domain.

<preferredDomainController>

Yes

createAddressLists

No

If present a GAL, AL, and OAL will be created for the organization.

<mailStore algorithm="minStoreCount">

No

Only used when <sourceMailStores> is not supplied. Possible values of the "algorithm" attribute are "tightPack" and "minStoreCount", with "tightPack" as default. TightPack attempts to use the smallest number of mail stores for the system as a whole, with the tradeoff that each individual org may span more mail stores. MinStoreCount attempts to minimize the number of stores allocated to each org, with the tradeoff that the system as a whole may require more stores. MinStoreCount uses stores with the largest available space first, and tightPack uses stores with the smallest available space first. If the <shared> parameter is 0, then this parameter has relatively little effect, since every share considered is completely empty.

<publicStore>/<megabytes>

No

The number of megabytes in publicstore allocation to reserve for the organization.

<publicStore>/<sourcePublicStoreServer>

No

If this parameter is supplied, it specifies the public store to put the organization's public folder storage on.

<mailStore><sourceMailStores>

No

If this parameter is supplied, then the automatic allocation behavior is overridden, and the <mailStore><megabytes> parameter is ignored. The <sourceMailStores> parameter specifies a set of mail stores to be allocated to this org. If any of the specifed stores is unavailable or has insufficient storage, then the entire call will fail. The total mail storage allocation for the org will be the total of the <megabytes> parameters in all of the supplied <sourceMailStore> parameters.

<sourceMailStore><serverName>

No

The name of the explicitly allocated store's server.

<sourceMailStore><mailStoreName>

No

The name of the mail store on the server.

<sourceMailStore><megabytes>

No

The storage to allocate on this mail store.

<createSMTPDomain>

No

If present SMTP domain will be added to recipient policies. Omit this element if you are using an SMTP Event sink.

Remarks

Provisioning Steps

  1. Managed Active Directory::TestOrgCreatorPermissions_

  2. Exchange Resource Manager::AllocateOrganization 3

  3. Exchange Provider::CreateSMTPDomain - Executes conditional based on presence of <createSMTPDomain> element in input. CreateSMTPDomain creates a recipient policy for the domain.

  4. Hosted Exchange::EnsureExchangeVirtualDirectories_ - creates OWA virtual directories on all Exchange servers.

  5. Hosted Exchange::LogEventRecord_ - Logs an event of type ExchServicesAdded.

  6. Hosted Exchange::CreateCustomerAssetRecord_ - Add the STMPDomain as a customer asset of type PrimaryDomain.

Security

  • Impersonate caller.

  • Caller tested for Org Creator role.

Sample Code

Example XML Request

<request>   
        <procedure>     
                <execute  namespace="Hosted Exchange" procedure="CreateBusinessOrganization" impersonate="1">       
                        <executeData>         
                                <path>LDAP://OU=alpineskihouse,OU=WH,OU=HOSTING,DC=fabrikam,DC=COM</path>         
                                <mailStore>           
                                        <megabytes>1000</megabytes>           
                                        <shared>1</shared>         
                                </mailStore>         
                                <publicStore>           
                                        <megabytes>500</megabytes>         
                                </publicStore>         
                                <SMTPDomain>alpineskihouse.com</SMTPDomain>       
                                <createSMTPDomain/>   
                                <preferredDomainController>AD01.fabrikam.com</preferredDomainController>         
                        </executeData>       
                        <after source="executeData" destination="data" mode="merge"/>     
                </execute>   
        </procedure> 
</request>

Example XML Response

No example XML response.

Applies To

Hosted Exchange Namespace API in Hosted Messaging and Collaboration 3.5, Hosted Messaging and Collaboration 3.0.

See also

Tasks

Hosted Exchange::CreateBusinessOrganization