ApplicationPool Class [IIS 7 and higher]
Represents an IIS application pool.
Syntax
class ApplicationPool : Object
Methods
The following table lists the methods exposed by the ApplicationPool class.
Name |
Description |
|---|---|
Creates an application pool. |
|
Returns the run-time state of an application pool. |
|
Recycles an application pool. |
|
Reverts an application pool's configuration value or values to those of its parent application pool. |
|
Starts an application pool. |
|
Stops an application pool. |
Properties
The following table lists the properties exposed by the ApplicationPool class.
Name |
Description |
|---|---|
AutoStart |
A read/write boolean value. true if the World Wide Web Publishing Service (WWW service) will start the application pool automatically either when the application pool is created or when IIS is started; otherwise, false. The default is true. |
Cpu |
An ApplicationPoolProcessorSettings object that contains the CPU settings for an application pool. |
Enable32BitAppOnWin64 |
A read/write boolean value. true if 32-bit applications (both managed and native) can run on 64-bit versions of Windows; otherwise, false. The default is false. |
Failure |
An ApplicationPoolFailureSettings object that defines the properties that determine the actions to be taken when an application pool or worker process fails. |
ManagedPipelineMode |
A read/write sint32 value that indicates the managed pipeline mode. The possible values are listed in the Remarks section. |
ManagedRuntimeVersion |
A read/write string value that contains the version of the common language runtime (CLR) that the application pool preloads. The default is "v2.0". If the property is written to, IIS recycles the application pool and loads the newly specified .NET Framework version for it. |
Name |
A read-only string value that contains the unique name of the application pool. The key property. The maximum length is 64 characters. Spaces and periods are permitted, but the following characters cannot be used: & / \ : * ? | " < > [ ] + = ; , @ |
PassAnonymousToken |
A read/write boolean value. true if the Windows Process Activation Service (WAS) creates and passes a token for the built-in IUSR anonymous user account to the Anonymous authentication module; otherwise, false. The default is true. The Anonymous authentication module uses the token to impersonate the built-in account. When PassAnonymousToken is false, the token will not be passed. .gif "Note") Note:
The IUSR anonymous user account replaces the IIS_MachineName anonymous account. The IUSR account can be used by IIS or other applications. It does not have any privileges assigned to it during setup.
|
ProcessModel |
A ProcessModelSettings object that defines the configuration settings for IIS worker processes. |
QueueLength |
A read/write uint32 value that indicates the number of requests that HTTP.sys will queue for an application pool before rejecting further requests. The default is 1000. When the limit is exceeded, HTTP.sys rejects additional requests with a 503 (service unavailable) error. |
Recycling |
A RecyclingSettings object that defines the recycling configuration settings for application pools and worker processes. |
Subclasses
This class contains no subclasses.
Remarks
An application pool is a group of one or more URLs that are served by a worker process or a set of worker processes. Application pools set boundaries for the applications they contain, which means that any applications that are running outside a specified application pool cannot affect the applications within that application pool.
If a managed application runs in an application pool with Integrated mode, the server will use the integrated request-processing pipelines of IIS and ASP.NET to process the request. However, if a managed application runs in an application pool with ISAPI mode, the server will continue to route requests for managed code through Aspnet_isapi.dll and process requests as if they were running in IIS 6.0.
Most managed applications should run successfully in application pools with Integrated mode, but you may have to run applications in ISAPI mode for compatibility reasons. Test the applications in Integrated mode first to determine whether you really need ISAPI mode.
The following table lists the possible values for the ManagedPipelineMode property. The default is 0 (Integrated).
Value |
Keyword |
Description |
|---|---|---|
0 |
Integrated |
The managed pipeline runs in Integrated mode. |
1 |
Classic |
The managed pipeline runs in ISAPI mode. |
Example
The following example displays the name and mode (Integrated or ISAPI) of the application pools on a server.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Retrieve the application pools on the server.
Set oAppPools = oWebAdmin.ExecQuery("SELECT * FROM ApplicationPool")
For Each oAppPool In oAppPools
WScript.Echo "--------------------------------------"
WScript.Echo "Application pool name: " & oAppPool.Name
If oAppPool.ManagedPipelineMode = 0 Then
sAppPoolMode = "Integrated"
ElseIf oAppPool.ManagedPipelineMode = 1 Then
sAppPoolMode = "ISAPI"
End if
WScript.Echo "Application pool mode: " & sAppPoolMode
Next
Inheritance Hierarchy
Application Pool
Requirements
Type |
Description |
|---|---|
Client |
Requires IIS 7 on Windows Vista. |
Server |
Requires IIS 7 on Windows Server 2008. |
Product |
IIS 7 |
MOF file |
WebAdministration.mof |
See Also
Reference
Object Class [IIS 7 and higher]