Share via

Exchange Resource Manager Ex::AddExchangeResources

  • Article

This procedure adds public stores and mailbox stores to the pool of resources managed by Exchange Resource Manager. The stores must actually exist before being added. This call is restricted to Domain Admins. This procedure integrates the task of adding all exchange resources by combining calls from the Exchange Resource Manager and Exchange Resource Manager Ex namespaces.

Arguments

Input argument Required Description

<publicStores>/<publicStore>

Yes

Zero or more elements containing:

  • <serverName>: The NETBIOS name of the Exchange server.

  • <publicStoreName>: Optional. Defaults to "Public Folder Store (ServerName)". This parameter is only needed if the public folder store has been renamed. This name must be unique amongst all the public folder stores in the AD tree.

  • <megabytes>: This is the size of the disk storage available for the database.

<mailStores>/<mailStore>

Yes

Zero or more elements containing:

  • <serverName>: The name of the Exchange server.

  • <mailStoreName>: The name of the mailstore. This name must be unique amongst all of the mailbox stores in the AD tree. A naming scheme of "Mailbox Store N (ServerName)" where N is an integer that is unique on this server is recommended.

  • <megabytes>: This is the size of the disk storage available for the database.

  • <shared>: May be 0 or 1. If it is 1, then this mailstore may be shared by multiple organizations. Otherwise it will be allocated to a single organization.

<frontEndServers>/<frontEndServer>

Yes

Zero or more elements containing:

  • <serverName>: The name of the Exchange server.

<consumerMailStores>/<mailStore>

Yes

Zero or more elements containing:

  • <serverName> The name of the Exchange server.

  • <mailStoreName> The name of the mailstore. This name must be unique amongst all of the mailbox stores in the AD tree. A naming scheme of "Mailbox Store N (ServerName)" where N is an integer that is unique on this server is recommended

  • <megabytes> This is the size of the disk storage available for the database.

  • <warningPC> The percentage of resource allocated before warning

  • <defaultMaxFillPC> The maximum percentage of allocation for the resource

<preferredDomainController>

Yes

Remarks

Access Level

Public.

Security

  • Impersonates caller.

  • Call restricted to domain admins.

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Exchange Resource Manager Ex" 
          procedure="AddExchangeResources" impersonate="1"> 
      <executeData> 
        <publicStores> 
        </publicStores> 
        <mailStores> 
          <mailStore> 
            <serverName>EXBE01</serverName> 
            <mailStoreName>BusinessMailstore1</mailStoreName> 
            <megabytes>8000</megabytes> 
            <shared>1</shared> 
          </mailStore> 
          <mailStore> 
            <serverName>EXBE02</serverName> 
            <mailStoreName>BusinessMailstore2</mailStoreName> 
            <megabytes>8000</megabytes> 
            <shared>1</shared> 
          </mailStore> 
        </mailStores> 
        <frontEndServers> 
          <frontEndServer> 
            <serverName>OWA01</serverName> 
          </frontEndServer> 
        </frontEndServers> 
        <consumerMailStores> 
          <mailStore> 
            <serverName>EXBE01</serverName> 
            <mailStoreName>ConsumerMailstore1</mailStoreName> 
            <megabytes>50000</megabytes> 
            <warningPc>90</warningPc> 
            <defaultMaxFillPc>90</defaultMaxFillPc> 
          </mailStore> 
          <mailStore> 
            <serverName>EXBE02</serverName> 
            <mailStoreName>ConsumerMailstore2</mailStoreName> 
            <megabytes>50000</megabytes> 
            <warningPc>90</warningPc> 
            <defaultMaxFillPc>90</defaultMaxFillPc> 
          </mailStore> 
       </consumerMailStores> 
        <preferredDomainController>AD01.fabrikam.com</preferredDomainController> 
      </executeData> 
    </execute> 
  </procedure> 
</request>

Applies To

Exchange Resource Manager Ex Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

See also

Tasks

Exchange Resource Manager Ex::RemoveExchangeResources