使用 AppFabric Cmdlet 來控制應用程式

此主題說明如何使用 AppFabric Cmdlet 來停止與啟動應用程式。為停止應用程式，Stop-ASApplication Cmdlet 會停用所有應用程式通訊協定並停止應用程式的自動啟動。為啟動應用程式，Start-ASApplication Cmdlet 會重新啟用所有應用程式通訊協定並還原應用程式的自動啟動。您也可以執行 Get-ASApplication Cmdlet 來判斷應用程式通訊協定與自動啟動的狀態。

如需有關執行 Cmdlet 的詳細資訊，請參閱執行 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	應用程式使用的應用程式集區名稱。

  2012-03-05