Share via

Exchange Resource Manager::ReallocateOrganizationMailNoMove

  • Article

This procedure changes the amount of mail storage that an organization is permitted to use. This procedure will fail if there is insufficient room in the system for the requested new storage, or if any explicitly requested mail store is unavailable.

Arguments

Input argument Required Description

organization

No

LDAP path of the organization owning the resource.

mailStoresXmlString

No

This is the change in mail storage available after the reallocation. If necessary, multiple mail stores may be allocated to the org to fulfill this request.

sourceMailStoresXmlString

No

If this parameter is supplied, then the automatic allocation behavior is overridden, and the <mailStore><megabytes> parameter is ignored.

<mailStore algorithm="minStoreCount"> 
        <megabytes>200</megabytes> 
        <shared>1</shared> 
        <sourceMailStores> 
        <sourceMailStore> 
        <serverName>RAVEN1</serverName> 
        <mailStoreName>Mailbox Store (RAVEN1)</mailStoreName> 
        <megabytes>200</megabytes> 
        </sourceMailStore> 
        <sourceMailStore op="allocate"> 
        <serverName>RAVEN1</serverName> 
        <mailStoreName>Mailbox Store 2 (RAVEN1)</mailStoreName> 
        <megabytes>200</megabytes> 
        </sourceMailStore> 
        <sourceMailStore op="deallocate"> 
        <serverName>RAVEN1</serverName> 
        <mailStoreName>Mailbox Store 3 (RAVEN1)</mailStoreName> 
        <megabytes>200</megabytes> 
        </sourceMailStore> 
        </sourceMailStores> 
</mailStore>

preferredDomainController

No

sendCredentials

No

True if credentials will be included in the xml request.

Remarks

Method Syntax

public string ReallocateOrganizationMailNoMove( 
string organization, 
string mailStoresXmlString, 
string preferredDomainController, 
bool sendCredentials)

Sample Code

Example XML Request

<executeData>1..1 
  <userName>1..1</userName> 
  <userPassword>1..1</userPassword> 
  <installedServer>1..1</installedServer> 
  <msiInstallHelper>1..1</msiInstallHelper> 
  <msiPackage path="..">1..1 
    <property name=".." value="..">0..unbounded</property> 
  </msiPackage> 
</executeData>

Example XML Response

<response> 
    <data> 
        <organizations> 
            <organization> 
                <GUID>{ee5c82e7-a0ec-4989-ac40-5994337bd8a1}</GUID> 
                <path>LDAP://OU=ExchOrg1,DC=raven01,DC=com</path> 
            </organization> 
            <organization> 
                <GUID>{5696e179-4857-4fb2-8b82-f062ad1aff3c}</GUID> 
                <path>LDAP://OU=ExchOrg2,DC=raven01,DC=com</path> 
            </organization> 
        </organizations> 
    </data> 
</response>

Typical C# Usage

//Get user name and password.                            
        string userName = this.Request.ServerVariables.Get("AUTH_USER"); 
        string pass = this.Request.ServerVariables.Get("AUTH_PASSWORD"); 
        //Set credentials. 
        ExchRM.PreAuthenticate = true; 
        ExchRM.Credentials = new NetworkCredential(userName,pass); 
 
        lblMsg.InnerHtml = mpsResponseHeaderLabel; 
        //Display response. 
        this.mpsResponse.DocumentSource = ""; 
        response = ExchRM. ReallocateOrganizationMailNoMove(organization, mailStoreXmlString, preferredDomainController, sendCredentials); 
                         
// set the response XML to match the return from MPF 
        responseXml.LoadXml(response); 
        this.mpsResponse.Document = responseXml; 
lblDone.InnerText = successMsg;

Applies To

Web Services API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

See also

Tasks

Exchange Resource Manager::ReallocateOrganizationPublic