Web Hosting Resource Manager::DeallocateDedicatedWebServer

  • Article

This procedure de-allocates a dedicated Web server from an organization and returns it to the resource pool.

Note

All Web sites must first be de-allocated from the server before the server can be de-allocated from the organization.

Arguments

Input argument Required Description

<org> or <orgGUID>

Yes

The org LDAP path or objectGUID

<serverName> or <serverGUID>

Yes

The name of objectGUID of the IIS Web Server.

<preferredDomainController>

Yes

<container>

No

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

Remarks

Access Level

Private.

Provisioning Steps

  1. De-allocate the specified Web server from the organization

Security

  1. Impersonate Caller.

Note

The access level of this procedure is private. It is intended to be called from other namespaces that perform their own security checks.

Sample Code

Example XML Request

<request> 
  <procedure> 
 
    <execute namespace="Web Hosting Resource Manager" procedure="DeallocateDedicatedWebServer" impersonate="1"> 
 
      <executeData> 
 
        <org>LDAP://OU=alpineskihouse,OU=consolidatedmessenger,OU=Hosting,DC=fabrikam,DC=Com</org> 
 
        <preferredDomainController>AD01-wh.fabrikam.com</preferredDomainController> 
 
        <serverName>SQ01</serverName> 
 
      </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::AllocateDedicatedWebServer