Share via

Exchange Resource Manager Ex::RemoveExchangeResources

  • Article

Removes Exchange resource from the pool of resources managed by Exchange Resource Manager and Exchange Resource Manager Ex. This call is restricted to Domain Admins.

This procedure throws an error if you try to remove a resource from the pool when the resource is being used. You have to deallocate the resource before you remove it from the pool.

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 Active Directory tree.

<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.

<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

<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="RemoveExchangeResources" 
    impersonate="1"> 
     <executeData> 
      <publicStores> 
        <publicStore> 
          <serverName>EXCHANGE_01</serverName> 
        </publicStore> 
      </publicStores> 
      <mailStores> 
        <mailStore> 
          <serverName>EXCHANGE_02</serverName> 
          <mailStoreName>Shared MailStore 01</mailStoreName> 
        </mailStore> 
        <mailStore> 
          <serverName>EXCHANGE_02</serverName> 
          <mailStoreName>Dedicated MailStore 02</mailStoreName> 
        </mailStore> 
        <mailStore> 
          <serverName>EXCHANGE_02</serverName> 
          <mailStoreName>Dedicated MailStore 03</mailStoreName> 
        </mailStore> 
      </mailStores> 
      <consumerMailStores> 
        <mailStore> 
          <serverName>EXBE01</serverName> 
          <mailStoreName>ConsumerMailStore1</mailStoreName> 
        </mailStore> 
      </consumerMailStores> 
      <frontEndServers> 
        <frontEndServer> 
          <serverName>EXCHANGE_FE01</serverName> 
        </frontEndServer> 
      </frontEndServers> 
    </executeData> 
    <after source="executeData" destination="data" mode="merge" /> 
  </execute> 
  </procedure> 
</request>

Example XML Response

No example XML response.

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::AddExchangeResources