RecyclingSettings Class1

Specifies recycling settings for worker processes.


class RecyclingSettings : EmbeddedObject  


This class contains no methods.


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.


This class contains no subclasses.


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




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

See Also

ApplicationPool Class
ApplicationPoolElementDefaults Class
Server Class
EmbeddedObject Class