Exchange 2007 Resource Manager::AllocateConsumerUserMailbox

  • Article

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