ApplicationPoolProcessorSettings Class [IIS 7 and higher]

IIS 7.0

Configures the CPU settings for an application pool.

class ApplicationPoolProcessorSettings : EmbeddedObject

This class contains no methods.

The following table lists the properties exposed by the ApplicationPoolProcessorSettings class.

Name

Description

Action

A read/write sint32 value that specifies the actions that IIS takes when an application pool exceeds the CPU limit specified by the Limit property. The possible values are listed later in the Remarks section.

Limit

A read/write uint32 value that indicates the percentage of CPU time to which worker processes are restricted during the interval specified by the ResetInterval property. The default is 0, which disables CPU usage restrictions on worker processes. If the value in the Limit property is exceeded, an event is written to the event log and the action specified by the Action property is taken.

ResetInterval

A read/write datetime value that represents the reset interval for the Limit property. When the time elapsed since the last reset equals the value specified in the ResetInterval property, IIS will reset the CPU timers for Limit. Setting ResetInterval to 0 will disable CPU monitoring. The default is 5.

SmpAffinitized

A read/write boolean value. true if the SmpProcessorAffinityMask property will be allowed to assign a worker process to a particular processor; otherwise, false. The default is false.

SmpProcessorAffinityMask

A read/write uint32 value that contains a hexadecimal mask that indicates which CPU the worker processes in an application pool should be bound to. This setting is for the first 32 processors on a multiprocessor server. To enable the SmpProcessorAffinityMask property, first set the SmpAffinitized property to true.

NoteNote:
Although the IIS_Schema.xml file specifies 4294967295 (unlimited) as the default for this property, the default returned by the WMI provider is -1. Setting this property to 0 will cause an error condition because no SMP affinity will be configured.

SmpProcessorAffinityMask2

A read/write uint32 value that contains a hexadecimal mask that indicates which CPU the worker processes in an application pool should be bound to. This setting is for the second set of 32 processors on a multiprocessor server. To enable the SmpProcessorAffinityMask property, first set the SmpAffinitized property to true.

NoteNote:
Although the IIS_Schema.xml file specifies 4294967295 (unlimited) as the default for this property, the default returned by the WMI provider is -1. Setting this property to 0 will cause an error condition because no SMP affinity will be configured.

Instances of this class are contained in the Cpu property of the ApplicationPool class.

The following table lists the possible values and the associated keywords and actions for the Action property. The default is 0 (NoAction).

Value

Keyword

Action

0

NoAction

Writes a warning to the event log, but takes no other action.

1

KillW3WP

Shuts down the application pool worker processes when the value of the Limit property is exceeded.

For more information on date/time values in Windows Management Instrumentation (WMI), see CIM_DATETIME.

For more information on setting processor affinity, see Set Processor Affinity.

EmbeddedObject

   ApplicationPoolProcessorSettings

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: