Exchange 2007 Resource Manager::AllocateMailbox

This procedure allocates mailbox storage.

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

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