Removing IIS resources by using XML

Use the RemoveIISResources procedure of the IIS Resource Manager namespace to remove IIS disk volumes, IP addresses, and possibly all computers running IIS from the pool of resources managed by IIS Resource Manager. The IIS computer resource is deleted automatically if all of its disk volumes and IP address are removed.

This procedure generates an error if you try to remove a resource from the pool when the resource is being used by a Web site. You have to deallocate the resource before you remove it from the pool. When volumes are removed, the system deletes the associated hosting directory created in the volume when the resource was added.

This procedure runs as the Microsoft Provisioning Framework service account for calls to the Resource Manager database, and it impersonates the caller when creating directories and when creating and setting Web and FTP site permissions.

Important

To run this procedure, you must be a member of the Domain Admins group or the local Administrators group on the server being provisioned.

Example of a request that calls the RemoveIISResources procedure

<request>
  <execute namespace="IIS Resource Manager" procedure="RemoveIISResources">
	<executeData>
	<servers>
		<server>
		<serverName>machine01</serverName>
		<volumes>
			<volume>
			<location>c:</location>
			</volume>
			<volume>
			<location>d:</location>
			</volume>
		</volumes>
		<IPAddresses>
			<IPAddress>157.60.0.1</IPAddress>
			<IPAddress>157.60.0.2</IPAddress>
			<IPAddress>157.60.0.3</IPAddress>
		</IPAddresses>
		</server>
	 </servers>
	 </executeData>
  </execute>
</request>

Input for RemoveIISResources

You can supply input for more than one server in the same request by supplying multiple <server> tags. The following input is valid for this request:

Server DNS name
In the <serverName> tag, you specify the internal Domain Name System (DNS) name of the server to remove from the pool of servers managed by Resource Manager.
```
<serverName>DNS name of server</serverName>
```
Disk volumes (optional)
In the <volume> tag, specify the disk volumes to remove from the pool of disk resources managed by Resource Manager.
```
<volume>
	<location>drive letter:</path>
  </volume>
```
IP addresses to remove (optional)
In the <IPAddress> tag, you can optionally specify the IP addresses to be removed from the pool of IP addresses that are managed by the Resource Manager.
```
<IPAddress>IP address</IPAddress>
```

Typical response for RemoveIISResources

The response to this procedure does not contain significant data.

Important

Although Active Directory is not case-sensitive for elements such as the Lightweight Directory Access Protocol (LDAP) path, XML is case-sensitive. To ensure that the procedure executes appropriately, specify all tags, elements, and data using uppercase and lowercase letters exactly as shown in the XML examples. For additional guidelines on how to use XML, see the Microsoft Web site (http://www.microsoft.com/).