WebSite Element (Iis Extension)

Description

IIs Web Site

Windows Installer references

None

Parents

Component, Fragment, Module, Product

Inner Text

None

Children

Choice of elements (min: 0, max: unbounded)

• CertificateRef (min: 0, max: unbounded)
• HttpHeader (min: 0, max: unbounded)
• MimeMap (min: 0, max: unbounded)
• WebAddress (min: 1, max: unbounded)
• WebApplication (min: 0, max: 1)
• WebDir (min: 0, max: unbounded)
• WebDirProperties (min: 0, max: 1)
• WebError (min: 0, max: unbounded)
• WebFilter (min: 0, max: unbounded)
• WebVirtualDir (min: 0, max: unbounded)

Attributes

Name	Type	Description	Required
Id	String	Identifier for the WebSite. Used within the MSI package only.	Yes
AutoStart	YesNoType	Specifies whether to automatically start the web site.
ConfigureIfExists	YesNoType	Specifies whether to configure the web site if it already exists. Note: This will not affect uninstall behavior. If the web site exists on uninstall, it will be removed.
ConnectionTimeout	NonNegativeInteger	Sets the timeout value for connections in seconds.
Description	String	This is the name of the web site that will show up in the IIS management console.	Yes
Directory	String	Root directory of the web site. Resolved to a directory in the Directory table at install time by the server custom actions.
DirProperties	String	References the Id attribute for a WebDirProperties element that specifies the security and access properties for this website root directory. This attribute may not be specified if a WebDirProperties element is directly nested in this element.
Sequence	Integer	Sequence that the web site is to be created in.
SiteId	String	Optional attribute to directly specify the site id of the WebSite. Use this to ensure all web sites in a web garden get the same site id. If a number is provided, the site id must be unique on all target machines. If "*" is used, the Description attribute will be hashed to create a unique value for the site id. This value must be a positive number or a "*" or a formatted value that resolves to "-1" (for the same behavior as "*") or a positive number or blank. If this attribute is absent then the web site will be located using the WebAddress element associated with the web site.
StartOnInstall	YesNoType	Specifies whether to start the web site on install.
WebApplication	String	Reference to a WebApplication that is to be installed as part of this web site.
WebLog	String	Reference to WebLog definition.

Remarks

Nesting WebSite under a Component element will result in a WebSite being installed to the machine as the package is installed.

Nesting WebSite under Product, Fragment, or Module results in a web site "locator" record being created in the IIsWebSite table. This means that the web site itself is neither installed nor uninstalled by the MSI package. It does make the database available for referencing from a WebApplication, WebVirtualDir or WebDir record. This allows an MSI to install WebApplications, WebVirtualDirs or WebDirs to already existing web sites on the machine. The install will fail if the web site does not exist in these cases.

See Also

Iis Schema