WebSite Element

WiX Help

WebSite Element

Description

IIs Web Site

Windows Installer references
None
Parents
Component, Fragment, Include, Module, Product
Inner Text
None
Children
Sequence (min: 1, max: 1)
  1. WebAddress (min: 1, max: unbounded)
  2. WebApplication (min: 0, max: 1)
  3. 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 Reference to WebDirProperties element.  
Sequence Integer Sequence that the web site is to be created in.  
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
Wix Schema