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 です。匿名認証モジュールは、そのトークンを使用して組み込みアカウントの権限を借用します。 PassAnonymousToken が false, の場合、トークンは渡されません。 注: 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
継承階層
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 |