recycling Element for add for applicationPools [IIS Settings Schema]

Article
10/21/2021

Note

For more information about the recycling element, see the following topic on the Microsoft IIS.net Web site: Recycling Settings for an Application Pool <recycling>.

Configures recycling settings for an application pool.

Note

Individual application pool settings override default settings unless the default settings are locked.

Syntax

Attributes and Elements

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

Attributes

disallowOverlappingRotation

Optional Boolean attribute.

Specifies whether the WWW Service should start another worker process to replace the existing worker process while that process is shutting down. The value of this property should be set to true if the worker process loads any application code that does not support multiple worker processes.

The default value is false.

disallowRotationOnConfigChange

Optional Boolean attribute.

Specifies whether the WWW Service should rotate worker processes in an application pool when the configuration has changed.

The default value is false.

logEventOnRecycle

Optional flags attribute.

Specifies that IIS should log an event when an application pool is recycled. The logEventOnRecycle property must have a bit set corresponding to the reason for the recycle if IIS is to log the event.

The logEventOnRecycle attribute can be one or more of the following possible values. If you specify more than one value, separate them with a comma (,). The default values are Time, Memory, and PrivateMemory.

Value	Description
ConfigChange	Log an event when an application pool recycles because of a configuration change. The numeric value is 64.
IsapiUnhealthy	Log an event when an application pool recycles after an ISAPI extension reports to the worker process that it is in an unhealthy state. The numeric value is 16.
Memory	Log an event when an application pool recycles after it uses a specified amount of virtual memory. The numeric value is 8.
OnDemand	Log an event when an application pool is recycled immediately to correct a problem. The numeric value is 32.
PrivateMemory	Log an event when an application pool recycles after it uses a specified amount of virtual memory. The numeric value is 128.
Requests	Log an event when an application pool recycles after it reaches a configured number of requests. The numeric value is 2.
Schedule	Log an event when an application pool recycles after it reaches a configured time of day. The numeric value is 4.
Time	Log an event when an application pool recycles after a configured time. The numeric value is 1.

Child Elements

Element	Description
periodicRestart	Optional element. Specifies conditions under which application pools are recycled.

periodicRestart

Optional element.

Specifies conditions under which application pools are recycled.

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.
applicationPools	Contains default configuration settings for all application pools on the server and defines configuration settings for specific application pools.
add	Configures an application pool in the server configuration.

Remarks

For more information about the recycling element, see the following topic on the Microsoft IIS.net Web site: Recycling Settings for an Application Pool <recycling>.

Element Information

Configuration locations	ApplicationHost.config
Requirements	Microsoft Internet Information Services (IIS) version 7.0