RecyclingSettings Class [IIS 7 and higher]

IIS 7.0

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.

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

Community Additions

ADD
Show: