Share via

Exchange Resource Manager::ModifyExchangeResources

  • Article

This procedure modifies public store and mail store resources in Exchange Resource Manager. This call is restricted to Domain Admins.

Arguments

Input argument Required Description

preferredDomainController

No

sendCredentials

No

True if credentials will be included in the xml request.

publicStoresXMLString

No

Defines public store resources to remove from the resource pool. Note that this property can be passed in as null if you aren't removing public stores. This property is passed in as an XML fragment string in the following format (one or more publicStore nodes should be included in the fragment):

<publicStores> 
        <publicStore> 
        <serverName>RAVEN1</serverName> 
        <megabytes>10000</megabytes> 
        </publicStore> 
</publicStores>

mailStoresXmlString

No

Defines mail store resources to remove from the resource pool. Note that this property can be passed in as null if you aren't removing mail stores. This property is passed in as an XML fragment string in the following format (one or more mailStore nodes should be included in the fragment):

<mailStores> 
        <mailStore> 
        <serverName>RAVEN1</serverName> 
        <mailStoreName>Mailbox Store (RAVEN1)</mailStoreName> 
        <megabytes>8000</megabytes> 
        <shared>1</shared> 
        </mailStore> 
        <mailStore> 
        <serverName>RAVEN1</serverName> 
        <mailStoreName>Mailbox Store 2 (RAVEN1)</mailStoreName> 
        <megabytes>8000</megabytes> 
        <shared>0</shared> 
        </mailStore> 
        <mailStore> 
        <serverName>RAVEN1</serverName> 
        <mailStoreName>Mailbox Store 3 (RAVEN1)</mailStoreName> 
        <megabytes>8000</megabytes> 
        <shared>0</shared> 
        </mailStore> 
</mailStores>

provisionableXmlString

No

The provisionable state of all mail stores and public stores on the specified server will be set to the value of the serverName/@provisionable attribute.

Remarks

Method Syntax

public string ModifyExchangeResources( 
string preferredDomainController, 
string publicStoresXMLString,  
string mailStoresXmlString, 
string provisionableXmlString, 
bool sendCredentials)

Sample Code

Example XML Request

No example XML request.

Example XML Response

MPS XML Response in string format; shown for format only, content may vary:

<response> 
  <data> 
    <preferredDomainController>AD01-wh.fabrikam.com</preferredDomainController> 
    <mailStores> 
      <mailStore> 
        <serverName>EXBE01-wh</serverName> 
        <mailStoreName>BusinessMailstore2</mailStoreName> 
      </mailStore> 
    </mailStores> 
  </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.ModifyExchangeResources(publicStoresXMLString, publicStoresXMLString, mailStoresXmlString, provisianableXmlString, 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::AddExchangeResources
Exchange Resource Manager::RemoveExchangeResources