表示 IIS 應用程式集區。
Syntax
class ApplicationPool : Object
方法
下表列出 類別所 ApplicationPool 公開的方法。
| 名稱 | 描述 |
|---|---|
| 建立 | 建立應用程式集區。 |
| GetState | 傳回應用程式集區的運行時間狀態。 |
| 再循環 | 回收應用程式集區。 |
| RevertToParent | 將應用程式集區的組態值或值還原為其父應用程式集區的值。 |
| 啟動 | 啟動應用程式集區。 |
| 停止 | 停止應用程式集區。 |
屬性
下表列出 類別所 ApplicationPool 公開的屬性。
| 名稱 | 描述 |
|---|---|
AutoStart |
讀取/寫入 boolean 值。 true 如果 World Wide Web Publishing Service (WWW 服務) 會在建立應用程式集區或 IIS 啟動時自動啟動應用程式集區;否則為 false。 預設值為 true。 |
Cpu |
ApplicationPoolProcessorSettings 物件,其中包含應用程式集區的 CPU 設定。 |
Enable32BitAppOnWin64 |
讀取/寫入 boolean 值。 true 如果 32 位應用程式 (Managed 和原生) 可以在 64 位版本的 Windows 上執行;否則為 false。 預設值為 false。 |
Failure |
ApplicationPoolFailureSettings 對象,定義屬性,以決定應用程式集區或背景工作進程失敗時要採取的動作。 |
ManagedPipelineMode |
表示受管理管線模式的讀取/寫入 sint32 值。 可能的值列在一節中。 |
ManagedRuntimeVersion |
讀取/寫入 string 值,其中包含應用程式集區預先載入的 Common Language Runtime (CLR 版本) 。 預設值為 「v2.0」。。 如果屬性寫入其中,IIS 會回收應用程式集區,併為其載入新指定的 .NET Framework 版本。 |
Name |
唯讀 string 值,其中包含應用程式集區的唯一名稱。 索引鍵屬性。 最大長度為64個字元。 允許空格和句號,但無法使用下列字元:& / \ : * ? |“ <> [ ] + = ; ,@ |
PassAnonymousToken |
讀取/寫入 boolean 值。 true 如果 Windows Process Activation Service (WAS) 建立並傳遞內建 IUSR 匿名用戶帳戶的令牌至匿名驗證模組;否則為 false。 預設為 true。匿名驗證模組會使用令牌來模擬內建帳戶。 PassAnonymousTokenfalse,何時不會傳遞令牌。 注意: IUSR 匿名用戶帳戶會取代IIS_MachineName匿名帳戶。 IIS 或其他應用程式可以使用 IUSR 帳戶。 在安裝期間,它沒有指派給它的任何許可權。 |
ProcessModel |
ProcessModelSettings 對象,定義 IIS 背景工作進程的組態設定。 |
QueueLength |
讀取/寫入 uint32 值,指出 HTTP.sys 在拒絕進一步要求之前,HTTP.sys 會排入應用程式集區佇列的要求數目。 預設值是 1000。 超過限制時,HTTP.sys 拒絕其他要求,並出現 503 (服務無法使用) 錯誤。 |
Recycling |
RecyclingSettings 對象,定義應用程式集區和背景工作進程的回收組態設定。 |
子類別
這個類別不包含子類別。
備註
應用程式集區是一組由背景工作進程或一組背景工作進程提供服務的一或多個URL。 應用程式集區會為其包含的應用程式設定界限,這表示任何在指定應用程式集區外部執行的應用程式都不會影響該應用程式集區內的應用程式。
如果受控應用程式以整合模式在應用程式集區中執行,伺服器將會使用 IIS 的整合式要求處理管線,並 ASP.NET 來處理要求。 不過,如果受控應用程式是以 ISAPI 模式在應用程式集區中執行,伺服器將會繼續透過 Aspnet_isapi.dll 路由傳送 Managed 程式代碼的要求,並處理要求,就像是在 IIS 6.0 中執行一樣。
大部分受控應用程式應該在具有整合模式的應用程式集區中順利執行,但基於相容性考慮,您可能必須在 ISAPI 模式中執行應用程式。 先測試整合模式中的應用程式,以判斷您是否真的需要 ISAPI 模式。
下表列出 屬性的可能值 ManagedPipelineMode 。 預設值為 0 (Integrated) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | Integrated |
Managed 管線會在整合模式中執行。 |
| 1 | Classic |
Managed 管線會在 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
規格需求
| 類型 | Description |
|---|---|
| 用戶端 | - 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 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 檔案 | WebAdministration.mof |