Exchange 2007 Resource Manager::DeAllocateMailbox

This procedure deallocates a non-dynamicQuota mailbox.

This procedure for Hosted Messaging and Collaboration version 4.5 is modified to accept a <GUID> node that will override the required <mailbox> node.

Arguments

Input Arguments for Hosted Messaging and Collaboration version 4.0

Input Arguments Required Type Description

<mailbox>

Yes

string

The Lightweight directory access protocol (LDAP) path for the Active Directory object or a Container element for an instance of mailbox properties elements.

<preferredDomainController>

Yes

string

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

Input Arguments for Hosted Messaging and Collaboration version 4.5

Input Arguments Required Type Description

<mailbox>

*Required if no GUID specified.

string

The Lightweight directory access protocol (LDAP) path for the Active Directory object or a Container element for an instance of mailbox properties elements.

<GUID>

*Required if no GUID specified.

string

The GUID of the mailbox that is to be deallocated in Resource Manager (RM). It should only be specified when the mailbox object is no longer found in Active Directory.

<preferredDomainController>

Yes

string

The domain controller to use for Active Directory operations. Use the fully qualified domain name (FQDN) of the domain controller that you want to use.

Remarks

Security

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

Error Handling

Error Condition Error Text

Missing mailbox and GUID parameters

You must supply either a mailbox or GUID element.

Active Directory object referenced by GUID exists.

The object with GUID %GUID% was found in Active Directory. This GUID parameter should only be used when the corresponding Active Directory object has been deleted.

Sample Code

Example XML Request 1

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

Example XML Request 2

<request> 
  <data> 
    <!--This is the GUID of the mailbox to remove from Resource Manager.--> 
    <GUID>D387F793E56BD043989EE82B6F334F1A</GUID> 
    <!-- 
                    The LDAP path for the Active Directory object or a Container element for an instance of mailbox properties elements. 
                  --> 
    <mailbox>LDAP://CN=JohnC@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</mailbox> 
    <!-- 
                    The FQDN or IP Address of the domain controller to use for this procedure. 
                  --> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
  </data> 
  <procedure> 
    <execute namespace="Exchange 2007 Resource Manager" procedure="DeallocateMailbox" impersonate="1"> 
      <before source="data" sourcePath="GUID" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="mailbox" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <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

See also

Tasks

Exchange 2007 Resource Manager::AllocateMailbox