Exchange 2007 Resource Manager::AllocateMailbox

  • Article

This procedure allocates mailbox storage.

Arguments

Input Arguments Required Description

<organization>

Yes

The Lightweight directory access protocol (LDAP) path of the organization or a container element for organization properties elements.

<mailbox>

Yes

The LDAP path for the Active Directory object or a Container element for an instance of mailbox properties elements.

<kilobytes>

Yes

The storage required or allocated to the mailbox.

<preferredDomainController>

Yes

The Fully Qualified Domain Names (FQDN) or IP Address of the domain controller to use for this procedure.

<mailstore>

No

The container node for mailStore settings

<mailStore/@autoAllocate>

No

This parameter specifies the selection algorithm to use when automatically allocating storage space to the customer organization for the mailbox. Enum

  • level - a new algorithm which will facilitate global leveling across all registered mail stores. If the organization has already been granted sufficient space for the allocation, that space should be used.

  • tightPack - allocations are packed tightly to minimize the number of servers used.

  • minStoreCount - minStoreCount attempts to minimize the number of stores allocated to each organization.

<mailStore/@algorithm>

No

This parameter specifies the selection algorithm to use when selecting an Exchange mail store for the new mailbox. Enum

  • tightPack - tightPack attempts to use the smallest number of mail stores.

  • level - level seeks to spread allocations evenly across available stores.

<mailStore/ serverName>

No

The name of a server to allocate a user's mailbox to. This node will only be acknowledged if the mailStoreName optional node is also present.

<mailStore/ mailStoreName>

No

The name of a mailstore to allocate a mailbox to. This node will only be acknowledged if the serverName optional node is also present.

<mailStore/ shared>

No

This parameter only has meaning if the autoAllocate parameter is specified and serverName and mailStoreName are not specified. 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 .
Output Arguments Description

<mailStore>

The Container element for Mail Store details.

<mailStore/ serverName>

The NETBIOS name of the Exchange server.

<mailStore/ mailStoreName>

The name of the mailstore.

Remarks

Security

The caller must be at least a member of role: UserCreators

Sample Code

Example XML Request

<request>  
        <data>  
                <organization> LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com </organization> 
                <mailbox> LDAP://cn=ExchUser1,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com </mailbox> 
                <kilobytes>10000 </kilobytes> 
                <preferredDomainController>AD01.Fabrikam.com </preferredDomainController> 
        </data> 
        <procedure>  
                <execute namespace="Exchange 2007 Resource Manager" procedure="AllocateMailbox" impersonate="1" >  
                        <before source="data" destination="executeData" mode="merge" /> 
                        <after source="executeData" destination="data" mode="merge" /> 
                </execute> 
        </procedure> 
</request>

Example XML Response

<response>  
        <data>  
                <mailStore>  
                        <serverName>EXBE01 </serverName> 
                        <mailStoreName>Mailbox Store (EXBE01) </mailStoreName> 
                </mailStore> 
        </data> 
</response>

Applies To

Exchange 2007 Resource Manager Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

Exchange 2007 Resource Manager::DeAllocateMailbox