WebSite Element (Iis Extension)

WiX Toolset

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)
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