add Element for applicationPools [IIS Settings Schema]
 Note: |
|---|
For more information about the add element, see the following topic on the Microsoft IIS.net Web site: Adding Application Pools <add>. |
Configures an application pool in the server configuration.
The following sections describe attributes, child elements, and parent elements for this section.
Attributes
Attribute | Description |
|---|---|
autoStart | Optional Boolean attribute. When true, indicates to the World Wide Web Publishing Service (W3SVC) that the application pool should be automatically started when it is created or when IIS is started. The default value is true. |
CLRConfigFile | Optional string value.Specifies the .NET configuration file for the application pool.Note: This attribute was added in IIS 7.5.There is no default value. |
enable32BitAppOnWin64 | Optional Boolean attribute. When true, enables a 32-bit application to run on a computer that runs a 64-bit version of Windows. The default value is false. |
enableConfigurationOverride | Optional Boolean attribute.When true, indicates that delegated settings in Web.config files will processed for applications within this application pool. When false, all settings in Web.config files will be ignored for this application pool.The default value is true. |
managedPipelineMode | Optional enum attribute. Specifies the request-processing mode that is used to process requests for managed content. The managedPipelineMode attribute can be one of the following possible values. The default is Integrated. ValueDescription ClassicSpecifies that the application pool use separate IIS and ASP.NET request-processing pipelines, which works with ASP.NET 1.1 applications, and ASP.NET 2.0 applications that do not work in Integrated mode.The numeric value is 1. IntegratedSpecifies that the application pool use the integrated IIS and ASP.NET request-processing pipeline, which works with only ASP.NET 2.0 applications.The numeric value is 0. |
managedRuntimeVersion | Optional string attribute. Specifies the .NET Framework version to be used by the application pool. The managedRuntimeVersion attribute can be one of the following possible values. The default value is v2.0. ValueDescription v1.1Specifies that the application pool use the .NET Framework version 1.1. v2.0Specifies that the application pool use the .NET Framework version 2.0. |
name | Required string attribute. Specifies a unique name for an application pool on the server. |
passAnonymousToken | Optional Boolean attribute.If true, the Windows Process Activation Service (WAS) creates and passes a token for the built-in IUSR anonymous user account to the Anonymous authentication module. The Anonymous authentication module uses the token to impersonate the built-in account. When PassAnonymousToken is false, the token will not be passed.Note: The IUSR anonymous user account replaces the IIS_MachineName anonymous account. The IUSR account can be used by IIS or other applications. It does not have any privileges assigned to it during setup.The default value is true. |
queueLength | Optional uint attribute. Indicates to HTTP.sys how many requests to queue for an application pool before rejecting future requests. The default value is 1000. When the value set for this property is exceeded, IIS rejects subsequent requests with a 503 error. If the loadBalancerCapabilities setting is true, the connection is closed instead of rejecting requests with a 503. |
startMode | Optional enum value.Specifies the startup type for the application pool.Note: This attribute was added in IIS 7.5.The startMode attribute can be one of the following possible values. ValueDescription AlwaysRunningSpecifies that the Windows Process Activation Service (WAS) will always start the application pool. This behavior allows an application to load the operating environment before any serving any HTTP requests, which reduces the start-up processing for initial HTTP requests for the application.The numeric value is 1. OnDemandSpecifies that the Windows Process Activation Service (WAS) will start the application pool when an HTTP request is made for an application that is hosted in the application pool. This behavior resembles the WAS behavior in previous versions of IIS.The numeric value is 0. |
Child Elements
Element | Description |
|---|---|
cpu | Configures CPU affinity and CPU actions. |
failure | Configures actions to take when an application pool fails. |
processModel | Configures process management attributes for an application pool. |
recycling | Configures application pool recycling. |
Parent Elements
Element | Description |
|---|---|
configuration | Specifies the root element in every configuration file that is used by IIS 7. |
system.applicationHost | Specifies the root element for configuring Web process settings. |
For more information about the add element, see the following topic on the Microsoft IIS.net Web site: Adding Application Pools <add>.
The applicationPools element can be declared in ApplicationHost.config only. Any attempt to declare applicationPools in a configuration file at a different level in the hierarchy results in an error message.