add Element for applicationPools [IIS Settings Schema]

Article
10/21/2021

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.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

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.

Value	Description
Classic	Specifies 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.
Integrated	Specifies 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.

Value	Description
v1.1	Specifies that the application pool use the .NET Framework version 1.1.
v2.0	Specifies 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.

Value	Description
AlwaysRunning	Specifies 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.
OnDemand	Specifies 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.

Remarks

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.

Element Information

Configuration locations	ApplicationHost.config
Requirements	Microsoft Internet Information Services (IIS) version 7.0
IIS 7.5	The <add> element of the <applicationPools> element was updated in IIS 7.5 to include attributes that allow you to preload applications.