title | author | description | ms.date | ms.assetid | msc.legacyurl | msc.type |
---|---|---|---|---|---|---|
<system.webServer> |
rick-anderson |
Overview The <system.webServer> element specifies the root element for many of the site-level and application-level configuration settings for Internet... |
09/26/2016 |
ff101340-b38e-4127-8978-61838ad18051 |
/configreference/system.webserver |
config |
The <system.webServer>
element specifies the root element for many of the site-level and application-level configuration settings for Internet Information Services (IIS) 7 in the ApplicationHost.config file, and contains configuration elements that define the settings used by the Web server engine and modules.
Note
Unlike settings that are found in <system.applicationHost
>, settings in the <system.webServer>
element can be delegated.
Version | Notes |
---|---|
IIS 10.0 | The <applicationInitialization> element was not modified in IIS 10.0. |
IIS 8.5 | The <system.webServer> element was not modified in IIS 8.5. |
IIS 8.0 | The <applicationInitialization> and <webSocket> elements were added as child elements. |
IIS 7.5 | The <system.webServer> element was not modified in IIS 7.5. |
IIS 7.0 | The <system.webServer> element was introduced in IIS 7.0. |
IIS 6.0 | N/A |
The <system.webServer>
element is included in the default installation of IIS 7.
There are no examples that are specific to the <system.webServer>
element. For examples that configure the settings that are found within the <system.webServer>
element, see the child elements that are listed in the configuration details section of this topic.
The <system.webServer>
element is defined in the ApplicationHost.config file, although settings in <system.webServer>
element can be delegated to Web.config files.
None.
Element | Description |
---|---|
applicationInitialization |
Optional element. Configures settings for application initialization that is performed proactively before a request is received. |
asp |
Optional element. Configures settings for Active Server Pages (ASP) applications. |
caching |
Optional element. Configures output cache settings. |
cgi |
Optional element. Configures default settings for Common Gateway Interface (CGI) applications. |
defaultDocument |
Optional element. Configures settings for returning a default document to a client browser when the client does not specify a file name in a request. |
directoryBrowse |
Optional element. Configures whether directory browsing is enabled or disabled on the Web server, and specifies the information to include in a directory listing. |
fastCgi |
Optional element. Contains a collection of fastCgi application pool definitions. |
globalModules |
Optional element. Specifies configuration settings for global modules on a Web server. |
handlers |
Optional element. Specifies handlers to process requests made to sites and applications. |
httpCompression |
Optional element. Configures HTTP compression settings for a Web server. |
httpErrors |
Optional element. Configures HTTP error messages for a Web server. |
httpLogging |
Optional element. Specifies configuration settings for HTTP.sys logging. |
httpProtocol |
Optional element. Configures custom and redirect response headers to be sent from the server to the client. |
httpRedirect |
Optional element. Configures settings for redirecting client requests to a new location. |
httpTracing |
Optional element. Specifies configuration settings for HTTP.sys tracing. |
isapiFilters |
Optional element. Specifies configuration settings for ISAPI filters on a Web server. |
management |
Optional element. Configures a Web server for remote management by using IIS Manager. |
modules |
Optional element. Specifies configuration settings for modules on a Web server. |
odbcLogging |
Optional element. Configures Open Database Connectivity (ODBC) logging. |
security |
Optional element. Specifies the section group that contains security-related sections. |
serverRuntime |
Optional element. Configures request limits for applications on a Web server. |
serverSideInclude |
Optional element. Specifies whether server-side includes (SSI) #exec directives are disabled. |
staticContent |
Optional element. Configures static file request handler settings. |
tracing |
Optional element. Configures request trace settings. |
urlCompression |
Optional element. Configures compression of static and dynamic content. |
validation |
Optional element. Configures IIS 7 to detect whether an ASP.NET application that is set up to run in ISAPI mode needs any migration in order to function correctly in Integrated mode. |
webdav |
Optional element. Configures WebDAV publishing settings. |
webSocket |
Optional element. Configures communications over the WebSocket protocol. |
The following configuration sample defines a simple, static-content-only <system.webServer>
element.
[!code-xmlMain]
There are no code samples that are specific to the <system.webServer>
element. For code samples that configure the settings that are found within the <system.webServer>
element, see the child elements that are listed in the configuration details section of this topic.