Configure the Request-Processing Mode for an Application Pool (IIS 7)

Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Vista

In IIS 7, there are two request-processing modes for application pools: integrated mode and classic mode. When you configure an application pool with integrated mode, IIS processes requests for managed content with the new integrated IIS and ASP.NET request processing pipeline. When you configure an application pool with classic mode, IIS continues to process requests for managed content using the separate IIS and ASP.NET request-processing pipelines. Use classic mode only for applications that cannot run in integrated mode.

Prerequisites

For information about the levels at which you can perform this procedure, and the modules, handlers, and permissions that are required to perform this procedure, see Application Pools Feature Requirements (IIS 7).

Exceptions to Feature Requirements

  • None

To configure the request-processing mode for an application pool

You can perform this procedure by using the user interface (UI), by running Appcmd.exe commands in a command-line window, by editing configuration files directly, or by writing WMI scripts.

User Interface

To use the UI

  1. Open IIS Manager. For information about opening IIS Manager, see Open IIS Manager (IIS 7).

  2. In the Connections pane, expand the server node and click Application Pools.

  3. On the Application Pools page, click to select an application pool from the list.

  4. In the Actions pane**,** click Basic Settings.

  5. From the Managed pipeline mode list, select one of the following options:

    • Integrated, if you want to use integrated IIS and ASP.NET request-processing.

    • Classic, if you want to use IIS and ASP.NET request-processing modes separately.

  6. Click OK.

Command Line

To configure the managed request-processing pipeline mode for an application pool, use the following syntax:

**appcmd set apppool /apppool.name:**string /managedPipelineMode: Integrated|Classic

The variable string is the name of the application pool that you want to change, and the value that you specify for managedPipelineMode is the mode that IIS uses to process requests for managed code.

For example, to configure an application pool named Marketing to use Classic mode, type the following at the command prompt, and then press Enter:

appcmd set apppool /apppool.name:Marketing /managedPipelineMode:Classic

For more information about Appcmd.exe, see Appcmd.exe (IIS 7).

Configuration

The procedure in this topic affects the following configuration elements:

managedPipeline attribute of the <add> element under <applicationPools>

For more information about IIS 7 configuration, see IIS 7.0: IIS Settings Schema on MSDN.

WMI

Use the following WMI classes, methods, or properties to perform this procedure:

  • ApplicationPool.ManagedPipelineMode property

For more information about WMI and IIS, see Windows Management Instrumentation (WMI) in IIS 7. For more information about the classes, methods, or properties associated with this procedure, see the IIS WMI Provider Reference on the MSDN site.

See Also

Concepts

Managing Application Pools in IIS 7