ApplicationPool Class1

IIS アプリケーション プールを表します。

構文

class ApplicationPool : Object  

メソッド

次の表に、ApplicationPool クラスによって公開されるメソッドの一覧を示します。

名前 説明
作成 アプリケーション プールを作成します。
GetState アプリケーション プールの実行時の状態を返します。
Recycle アプリケーション プールをリサイクルします。
RevertToParent アプリケーション プールの構成値または値を、その親アプリケーション プールの値に戻します。
Start アプリケーション プールを開始します。
停止 アプリケーション プールを停止します。

プロパティ

次の表は、ApplicationPool クラスによって公開されるプロパティの一覧です。

名前 説明
AutoStart 読み取り/書き込みの boolean 値。 World Wide Web 発行サービス (WWW サービス) が、アプリケーション プールの作成時または IIS の起動時にアプリケーション プールを自動的に開始する場合は、true。そうでない場合は false です。 既定値は、true です。
Cpu アプリケーション プールの CPU 設定が含まれた ApplicationPoolProcessorSettings オブジェクト。
Enable32BitAppOnWin64 読み取り/書き込みの boolean 値。 32 ビット アプリケーション (マネージドとネイティブの両方) を 64 ビット バージョンの Windows で実行できる場合は true。それ以外の場合は false。 既定値は、false です。
Failure アプリケーション プールまたはワーカー プロセスが失敗したときに実行するアクションを決定するプロパティを定義する ApplicationPoolFailureSettings オブジェクト。
ManagedPipelineMode マネージド パイプライン モードを示す読み取り/書き込みの sint32 値。 使用できる値の一覧は、「注釈」セクションに示します。
ManagedRuntimeVersion アプリケーション プールが事前に読み込む共通言語ランタイム (CLR) のバージョンを含む読み取り/書き込みの string 値。 既定値は "v2.0" です。 プロパティが書き込まれた場合、IIS はアプリケーション プールをリサイクルし、新しく指定された .NET Framework バージョンを読み込みます。
Name アプリケーション プールの一意の名前を含む読み取り専用の string 値。 キー プロパティ。 最大長は 64 文字です。 スペースとピリオドは使用できますが、次の文字は使用できません。

PassAnonymousToken 読み取り/書き込みの boolean 値。 組み込みの IUSR 匿名ユーザー アカウントのトークンを Windows プロセス アクティブ化サービス (WAS) が作成し、匿名認証モジュールに渡す場合は true。それ以外の場合は false。 既定値は、true です。

匿名認証モジュールは、そのトークンを使用して組み込みアカウントの権限を借用します。 PassAnonymousTokenfalse, の場合、トークンは渡されません。 注: IUSR 匿名ユーザー アカウントは、IIS_MachineName 匿名アカウントを置き換えます。 IUSR アカウントは、IIS または他のアプリケーションで使用できます。 セットアップ中に割り当てられる特権はありません。
ProcessModel IIS ワーカー プロセスの構成設定を定義する ProcessModelSettings オブジェクト。
QueueLength さらなる要求を拒否する前に、HTTP.sys がアプリケーション プールに対してキューに入れる要求の数を示す読み取り/書き込みの uint32 値。 既定値は 1000 です。 制限を超えると、HTTP.sys は 503 (サービス利用不可) エラーで追加の要求を拒否します。
Recycling アプリケーション プールとワーカー プロセスのリサイクル構成設定を定義する RecyclingSettings オブジェクト。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

アプリケーション プールは、ワーカー プロセスまたは一連のワーカー プロセスによって提供される 1 つ以上の URL のグループです。 アプリケーション プールは、含まれているアプリケーションの境界を設定します。つまり、指定されたアプリケーション プールの外部で実行されているアプリケーションは、そのアプリケーション プール内のアプリケーションに影響を与えることはできません。

マネージド アプリケーションが統合モードのアプリケーション プールで実行されている場合、サーバーは IIS と ASP.NET の統合要求処理パイプラインを使用して要求を処理します。 ただし、マネージド アプリケーションが ISAPI モードのアプリケーション プールで実行されている場合、サーバーは引き続き Aspnet_isapi.dll を介してマネージド コードの要求をルーティングし、IIS 6.0 で実行されているかのように要求を処理します。

ほとんどのマネージド アプリケーションは統合モードのアプリケーション プールで正常に実行されますが、互換性の理由から、ISAPI モードでアプリケーションを実行する必要が生じる場合があります。 まず統合モードでアプリケーションをテストし、ISAPI モードが本当に必要かどうかを判断します。

次の表に、ManagedPipelineMode プロパティとして使用できる値の一覧を示します。 既定値は 0 (Integrated) です。

Value キーワード 説明
0 Integrated マネージド パイプラインは統合モードで実行されます。
1 Classic マネージド パイプラインは ISAPI モードで実行されます。

次の例では、サーバー上のアプリケーション プールの名前とモード (統合または ISAPI) を表示します。

' 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  

継承階層

Object

Application Pool

要件

説明
クライアント - Windows Vista 上の IIS 7.0
- Windows 7 上の IIS 7.5
- Windows 8 上の IIS 8.0
- Windows 10 上の IIS 10.0
[サーバー] - Windows Server 2008 上の IIS 7.0
- Windows Server 2008 R2 上の IIS 7.5
- Windows Server 2012 上の IIS 8.0
- Windows Server 2012 R2 上の IIS 8.5
- Windows Server 2016 上の IIS 10.0
Product - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル WebAdministration.mof

参照

Object クラス
IIS 7.0 でのアプリケーション プールの構成