使用 Windows Server AppFabric Cmdlet 來控制應用程式
此主題說明如何使用 AppFabric Cmdlet 來停止與啟動應用程式。為停止應用程式,Stop-ASApplication Cmdlet 會停用所有應用程式通訊協定並停止應用程式的自動啟動。為啟動應用程式,Start-ASApplication Cmdlet 會重新啟用所有應用程式通訊協定並還原應用程式的自動啟動。您也可以執行 Get-ASApplication Cmdlet 來判斷應用程式通訊協定與自動啟動的狀態。
如需有關執行 Cmdlet 的詳細資訊,請參閱執行 Windows Server AppFabric Cmdlet。
停止應用程式
在 AppFabric Windows PowerShell 主控台,執行 Stop-ASApplication Cmdlet 以適當地停止應用程式。此 Cmdlet 會執行下列動作:
在特定虛擬應用程式的 applicationHost.config 檔案中,將 enabledProtocols 屬性的所有內容複製到 \configuration\system.applicationHost\sites\site\application 元素的 previouslyEnabledProtocols 屬性 (一律覆寫其內容),以停用應用程式的所有應用程式通訊協定 (停用訊息流量)。接著,此 Cmdlet 會清除 "enabledProtocols" 屬性的內容。
將 applicationHost.config 檔案之虛擬應用程式組態中的 serviceAutoStartEnabled 屬性設定為 “false”,以停止應用程式的自動啟動。
語法選項:
語法 1
Stop-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-Confirm] [-WhatIf] [<CommonParameters>]
語法 2
Stop-ASApplication [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]
語法 3
Stop-ASApplication -ApplicationObject <ApplicationInfo> [-Confirm] [-WhatIf] [<CommonParameters>]
參數 | 描述 |
---|---|
-SiteName <字串> -VirtualPath <字串> |
網站或應用程式的指標,指定要停止的應用程式。如果設定的參數指定網站,則此 Cmdlet 會停止該網站中的所有應用程式。 |
-Uri <Uri> |
特定網站或應用程式的指標,指定要停止的應用程式。如果設定的參數指定網站,則此 Cmdlet 會停止該網站中的所有應用程式。 |
-ApplicationObject <服務資訊> |
要停止之特定應用程式的指標。 |
-Confirm |
若指定此參數,則系統會在執行命令之前提示您確認。 |
-WhatIf |
若指定此參數,則系統會顯示說明命令執行效果的訊息,而非執行命令。 |
啟動應用程式
在 AppFabric Windows PowerShell 主控台,執行 Start-ASApplication Cmdlet 以適當地啟動應用程式。此 Cmdlet 會執行下列動作:
將 “previouslyEnabledProtocols” 的內容複製到 “enabledProtocols”,然後移除 "previouslyEnabledProtocols" 屬性,以重新啟用 applicationHost.config 檔案中的所有應用程式通訊協定。
將 applicationHost.config 檔案中的 serviceAutoStartEnabled 設定為“True”(若 applicationHost.config 檔案中的應用程式 serviceAutoStartMode 屬性是“All”或“Custom”),以還原應用程式自動啟動。
語法選項:
語法 1
Start-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] [-StartApplicationPool] [<CommonParameters>]
語法 2
Start-ASApplication [-Uri] <Uri> [-StartApplicationPool] [<CommonParameters>]
語法 3
Start-ASApplication -ApplicationObject <ApplicationInfo> [-StartApplicationPool] [<CommonParameters>]
參數 | 描述 |
---|---|
-SiteName <字串> -VirtualPath <字串> |
網站或應用程式的指標,指定要啟動的應用程式。如果設定的參數指定網站,則此 Cmdlet 會啟動該網站中的所有應用程式。 |
-Uri <Uri> |
特定網站或應用程式的指標,指定要啟動的應用程式。如果設定的參數指定網站,則此 Cmdlet 會啟動該網站中的所有應用程式。 |
-ApplicationObject <服務資訊> |
要啟動之特定應用程式的指標。 |
-StartApplicationPool |
若指定此旗標,且應用程式集區不在執行中,則此 Cmdlet 會啟動應用程式集區。若要啟用此功能,您必須將應用程式 appPool 的 startMode 設定為“AlwaysRunning”。 |
判斷應用程式的狀態
在 AppFabric Windows PowerShell 主控台,執行 Get-ASApplication Cmdlet 以傳回關於操作狀態的資訊。Get-ASApplication 會傳回 ApplicationInfo 物件。您可以透過 ApplicationInfo 物件中的 MessageFlowStatus、AutoStartEnabled 與 AutoStartMode 屬性來判斷應用程式的狀態。
語法選項:
語法 1
Get-ASApplication [[-SiteName] <String>] [[-VirtualPath] <String>] [[-ApplicationPoolName] <String>] [<CommonParameters>]
參數 | 描述 |
---|---|
-SiteName <字串> -VirtualPath <字串> |
要傳回其資訊之網站或應用程式的指標。如果設定的參數指定網站,則此 Cmdlet 會傳回該網站中所有應用程式的資訊。 |
-ApplicationPoolName |
應用程式使用的應用程式集區名稱。 |
2011-12-05