Exchange 2007 Resource Manager::QueryAllExchangeResources

  • Article

This procedure returns all of the mail stores, public folders stores, front end servers, and consumer mail stores.

This procedure for Hosted Messaging & Collaboration version 4.5 is modified to handle missing Exchange Public Stores and Exchange Mailbox store object in Active Directory. Missing orphaned objects will be identified by an empty <publicStoreName> node for all ExchPublicStore07 resources, and an empty <mailStoreName> node for all ExchMailStore07 resources. Missing Stores of type ExchConsumerMailStore07 should be handled in the same way.

Arguments

Input Arguments Required Type Description

<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.
Output Arguments Description

<frontEndServers>

The container element for child frontEndServer elements.

<frontEndServers/ serverName>

This parameter is required if the publicStore element is present. The NETBIOS name of the Exchange server.

<publicStores>

The container element for each set of child public store elements.

<publicStores/ publicStore>

The container element for each set of child public store properties elements.

<publicStores/ publicStore/ serverName>

This parameter is required if the publicStore element is present. The NETBIOS name of the Exchange server.

<publicStores/ publicStore/ publicStoreName>

Defaults to Public Folder Store (ServerName). Must be unique amongst all the public folder stores in the Active Directory tree.

Note for Hosted Messaging and Collaboration version 4.5: Empty value denotes a missing or inaccessible Public Store object in Active Directory.

<publicStores/ publicStore/ megabytes>

The size of disk storage or the size of an adjustment.

<publicStores/ publicStore/ megabytesFree>

The number of megabytes yet to be allocated for the public store or mailstore.

<mailstores>

The container element for each set of child mailstore elements.

<mailStores/ mailStore>

The container element for each set of child mailstore properties elements.

<mailStores/ mailStore/ serverName>

Required if the publicStore element is present. The NETBIOS name of the Exchange server.

<mailStores/ mailStore/ mailStoreName>

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

Note for Hosted Messaging and Collaboration version 4.5: Empty value denotes a missing or inaccessible Mailbox Store object in Active Directory.

<mailStores/ mailStore/ megabytes>

The size of disk storage or the size of an adjustment.

<mailStores/ mailStore/ megabytesFree>

The number of megabytes yet to be allocated for the public store or mailstore.

<mailStores/ mailStore/ shared>

If 1, this mailstore may be shared by multiple organizations. Otherwise it will be allocated to a single organization.

<consumerMailStores>

The container element for child mailstore elements.

<consumerMailStores/ mailStore>

The container element for each set of child mailstore properties elements.

<consumerMailStores/ mailStore/ mailStoreName>

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

Note for Hosted Messaging and Collaboration version 4.5: Empty value denotes a missing or inaccessible Mailbox Store object in Active Directory.

<consumerMailStores/ mailStore/ serverName>

Required if the publicStore element is present. The NETBIOS name of the Exchange server.

<consumerMailStores/ mailStore/ megabytes>

The size of disk storage or the size of an adjustment.

<consumerMailStores/ mailStore/ megabytesFree>

The number of megabytes yet to be allocated for the public store or mailstore.

<consumerMailStores/ mailStore/ warning>

The percentage of resource allocated before warning.

<consumerMailStores/ mailStore/ maxfill >

Remarks

Security

The caller must be at least a member of role: DomainAdmin.

Sample Code

Example XML Request

<request> 
  <data> 
    <!-- 
                    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="QueryAllExchangeResources" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response> 
  <data> 
    <!-- 
                    Container element for child frontEndServer elements. 
                  --> 
    <frontEndServers> 
      <!-- 
                          The NETBIOS name of the Exchange server. 
                        --> 
      <serverName>ExCASOAB01</serverName> 
    </frontEndServers> 
    <!-- 
                    Container element for child publicStore elements. 
                  --> 
    <publicStores> 
      <!-- 
                          Container element for each set of child public store properties elements. 
                        --> 
      <publicStore> 
        <serverName>EXMBXOAB01</serverName> 
        <publicStoreName>PublicFolderStore01</publicStoreName> 
        <megabytes>10000</megabytes> 
        <megabytesFree>9000</megabytesFree> 
      </publicStore> 
    </publicStores> 
    <!-- 
                    Container element for child mailStore elements. 
                  --> 
    <mailStores> 
      <!-- 
                          Container element for each set of child mailstore properties elements. 
                        --> 
      <mailStore> 
        <serverName>EXMBX01-NODE1</serverName> 
        <mailStoreName>HostedMailstore01</mailStoreName> 
        <megabytes>8000</megabytes> 
        <megabytesFree>6980</megabytesFree> 
        <shared>1</shared> 
      </mailStore> 
    </mailStores> 
    <!-- 
                    Container element for child mailstore elements. 
                  --> 
    <consumerMailStores> 
      <!-- 
                          Container element for each set of child mailstore properties elements. 
                        --> 
      <mailStore> 
        <mailStoreName>HostedMailstore02</mailStoreName> 
        <serverName>EXMBX01-NODE1</serverName> 
        <megabytes>50000</megabytes> 
        <megabytesFree>49980</megabytesFree> 
        <warning>90</warning> 
        <maxfill>100</maxfill> 
      </mailStore> 
    </consumerMailStores> 
  </data> 
</response>

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::AddExchangeResources
Exchange 2007 Resource Manager::ModifyExchangeResources