IIS Types Introduction

The following four IIS Types share a common implementation. All four export, Install, and delete data stored in the IIS metabase. As a result there are a common set of functions, formats, and errors.

Exported/Internal File Format

All four IIS types use an XML format to store their section of the metabase. The present XML format does not support metabase properties of type NTACL (such as AdminACL); if any are encountered while reading/writing to the metabase, they are ignored. Also, properties of type IPSec (such as IPSecurity) are written out as serialized objects, and as a result they are not human-readable (during either direct examination, or as difference results).

M-I Difference

During a snapshot the current state of the metabase is exported into an XML file. During an M-I difference the metabase is re-exported and compared against the original XML file. The standard XML differentiator is used to generate differences between these files.

Error Conditions

Table 5–11 IIS Types Introduction Error Conditions

Action	Condition	Result
Install/Export	IIS Does not exist or is the improper version	Install/Export fails
Install/Uninstall	Remote Agent does not have administrator privileges	Install/Uninstall fails

IIS Web Site or Virtual Directory Settings

Represents the settings for an IIS Website or Virtual Directory. Please note that this resource type only contains the settings for a website or virtual directory. The content on the web site must be checked in as a separate resource.

Browsing

Table 5–12 IIS Types Introduction Browsing Behavior

Root Path	List of web sites on the target system
Delimiter	“\”
Ordering	web sites and virtual directories appear in the order they occur in the metabase. This corresponds to the order they appear in the IIS Control panel and are NOT alphabetical.
Selection Type	User can single select a web site or virtual directory. Selecting a web site is considered recursive. Double-clicking on a web site provides a listing of the virtual directories underneath the web site.
Sample Path	Website1\VirturalDir2
Filters	None

Installation

Installation occurs by reading the XML file and importing into the target system metabase. If a web site with the same name exists it is overwritten. If there are multiple web sites with the same name on the system the first matching one will be removed and overwritten.

Special cases include untyped keys/nodes (see below for more info) and SSL certificates, which are not deployed. The relevant settings for SSL certs in IIS (SSLCertHash and SSLStoreName) are preserved during a deployment if they exist on the target, but if they do not exist they are not added.

To bring up a secure site after being deployed (or redeployed) requires a restart of IIS.

Un-Install

The entire web site is removed on the target system. All Virtual Directories underneath the web site are removed regardless of whether they were installed by the provisioning software. If the settings are just for a virtual directory only that directory is removed, not its containing site. Note the matching for uninstall is done via name, so the first web site with the same name found on the system will be uninstalled. Once this is complete the XML file used during installation is removed.