Web Hosting Resource Manager::RemoveServers

  • Article

This procedure removes IIS Web Servers from the Resource Manager IIS Web Server resource pool.

Arguments

Input argument Required Description

<servers>/<server>

Yes

One or more server nodes defining a IIS Web Server resource:

  1. <serverName> or <GUID>: The name of the server or the objectGUID of the computer object. (followed by one or more optional server attributes described in the Optional Input section).

<preferredDomainController>

Yes

<servers>/<server>

No

One or more server nodes defining a IIS Web Server resource. The following additional elements are supported as optional elements:

  1. <container>: A starting LDAP container to look for the server in. The procedure performs an LDAP search to resolve the <server>/<name> to the Active Directory computer object. You can improve the performance of this search by specifying a default container (e.g. LDAP://OU=Computers,DC=fabrikam,DC=Com).

Note

All Web sites must first be de-allocated from a server before it can be removed.

Remarks

Access Level

Public.

Provisioning Steps

  1. Find the resource instances(s) in Resource Manager.

  2. Remove the resource instance(s) from the pool.

Security

  1. Impersonate Caller.

  2. Caller Tested for domain admin permissions:

    1. Domain admins

Sample Code

Example XML Request

<request> 
  <procedure> 
 
    <execute namespace="Web Hosting Resource Manager" procedure="RemoveServers" impseronate="1"> 
 
      <executeData> 
 
        <servers> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB01</serverName> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB02</serverName> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB03</serverName> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB04</serverName> 
 
          </server> 
 
        </servers> 
 
        <preferredDomainController>AD01-wh.fabrikam.com</preferredDomainController> 
 
      </executeData> 
 
      <after source="executeData" destination="data" mode="merge"/> 
 
    </execute> 
 
  </procedure> 
 
</request>

Example XML Response

No example XML response.

Applies To

Web Hosting Resource Manager Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Web Hosting Resource Manager::AddServers
Web Hosting Resource Manager::ModifyServers
Web Hosting Resource Manager::QueryAllServers