Export (0) Print
Expand All

add Element for applicationPools [IIS Settings Schema]

IIS 7.0

NoteNote:

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.

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.

Community Additions

ADD
Show:
© 2014 Microsoft