Exchange 2007 Resource Manager::AllocateConsumerUserMailbox
This procedure allocates mailbox storage for a consumer user.
Arguments
Input Arguments | Required | Description |
---|---|---|
<userPrincipalName> |
Yes |
The user's principal name. |
<mailbox> |
Yes |
The Lightweight directory access protocol (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. |
<mailStoreServer> |
No |
This parameter provides a deprecated mechanism for specifying which server to allocate the user's mailbox to. The recommend method for doing so is to use the <mailStore/> element and its children to specify a server and store to allocate the user's mailbox to. The <mailStoreServer/> and <mailStore/> elements should not be supplied in the same request. If neither is supplied, the target server and store will automatically be selected by the Resource Manager. |
<mailstore> |
No |
The name of a server to allocate a user's mailbox to. If this optional parameter is present then mailStoreName must also be present. The mail store must be defined as a consumer mail store in resource management. |
<mailStore/ serverName> |
No |
The name of a server to allocate a user's mailbox to. If this optional parameter is present, mailStoreName must also be present. The mail store must be defined as a consumer mail store in resource management. |
<mailStore/ mailStoreName> |
No |
The name of a mailstore to allocate a user's mailbox to. If this optional parameter is present, serverName must also be present. The mail store must be defined as a consumer mail store in resource management. |
Remarks
Security
The caller must be at least a member of role: UserCreators
Sample Code
Example XML Request
<request>
<data>
<userPrincipalName>bob@litwareinc.com </userPrincipalName>
<mailbox> LDAP://CN=bob@litwareinc.com,OU=Litwareinc,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="AllocateConsumerUserMailbox" impersonate="1" >
<before source="data" destination="executeData" mode="merge" />
<after source="executeData" destination="data" mode="merge" />
</execute>
</procedure>
</request>
Applies To
Exchange 2007 Resource Manager Namespace for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0