RecyclingSettings Class1

Article
05/20/2022

Specifies recycling settings for worker processes.

Syntax

class RecyclingSettings : EmbeddedObject

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by RecyclingSettings.

Name	Description
`DisallowOverlappingRotation`	A read/write `boolean` value. `true` if the Windows Process Activation Service (WAS) starts up another worker process to replace one that is still running; otherwise, `false`. The default is `false`. Set `DisallowOverlappingRotation` to `true` if the worker process loads any application code that does not support two worker processes at the same time.
`DisallowRotationOnConfigChange`	A read/write `boolean` value. `true` if WAS rotates worker processes in an application pool after the application pool configuration has changed; otherwise, `false`. The default is `false`. Application pool configuration changes do not affect worker processes that are already running. Set `DisallowRotationOnConfigChange` to `true` if the worker process loads any application code that does not support two worker processes at the same time.
`LogEventOnRecycle`	A read/write `sint32` value that contains a mask that specifies which recycling events will be logged. The possible values are listed later in the Remarks section.
`PeriodicRestart`	A PeriodicRestartSettings object that specifies the conditions under which worker processes will be recycled.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the Recycling property of the ApplicationPool class and the ApplicationPoolElementDefaults class. ApplicationPoolElementDefaults is in turn exposed as the GlobalApplicationPoolDefaults property on the Server class.

The following table lists the possible values and the associated keywords and recycling events for the LogEventOnRecycle property. The defaults are 1 (Time), 8 (Memory), and 128 (PrivateMemory).

Value	Keyword	Recycling event
1	`Time`	The time specified in PeriodicRestartSettings.Time has elapsed since the last recycle. Enabled by default.
2	`Requests`	The number of requests specified in PeriodicRestartSettings.Requests has been reached.
4	`Schedule`	A scheduled recycle specified in PeriodicRestartSettings.Schedule has occurred.
8	`Memory`	A used or virtual memory limit specified in PeriodicRestartSettings.Memory has been reached. Enabled by default.
16	`IsapiUnhealthy`	An ISAPI has failed to respond to a health-monitoring request.
32	`OnDemand`	An administrator has manually triggered a recycle.
64	`ConfigChange`	Application pool configuration changes have been made.
128	`PrivateMemory`	Private memory has reached the amount specified in PeriodicRestartSettings.PrivateMemory. Enabled by default.

Inheritance Hierarchy

EmbeddedObject

RecyclingSettings

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof