Web Hosting Resource Manager::ModifyServers

  • Article

This procedure modifies IIS Web Servers in 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>: The name of the server. (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>/<serverName> 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).

  2. <megabytes>: The relative amount of storage capacity in megabytes to increase or decrease the server capacity by. Positive numbers increase the capacity. Negative numbers decrease the capacity.

  3. <maxWebSites>: The relative amount of maximum number of Web sites capacity that can be hosted on this sever. Positive numbers increase the capacity. Negative numbers decrease the capacity.

  4. <serverClassName>: User defined value indicating which server class resource group the server should be added to.

  5. <warningPercentage>: Percentage that represents the allocation level at which to raise a warning notification for the operator. Default is 80.

<servers>/<server>/@provisionable:

No

Optional attribute allowing the setting of the provisionable status of the server. 1 = provisionable and 0 = non-provisionable. Setting this value to 0 allows you to make a server unavailable for new allocations. This is useful for migration scenarios or maintenance scenarios.

Remarks

Access Level

Public.

Provisioning Steps

  1. Find the server(s) in Active Directory.

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

  3. Update resource capacity if provided.

  4. Update max and fill percentages if provided.

  5. Update server class if provided.

  6. Update provisionable status if provided

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="ModifyServers" impersonate="1"> 
 
      <executeData> 
 
        <servers> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB01</serverName> 
 
            <serverClassName>SQLServerProfessional</serverClassName> 
 
          </server> 
 
          <server> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB07</serverName> 
 
            <megabytes>500</megabytes> 
 
          </server> 
 
          <server provisionable="0"> 
 
            <container>LDAP://CN=Computers,DC=fabrikam,DC=Com</container> 
 
            <serverName>WEB08</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::RemoveServers
Web Hosting Resource Manager::QueryAllServers