使用 AppFabric Cmdlet 來設定自動啟動功能
此主題說明如何使用 AppFabric Cmdlet 來設定應用程式或服務的自動啟動。
啟用應用程式的自動啟動
在 AppFabric Windows PowerShell 主控台，執行 Set-ASApplication Cmdlet (將 -AutoStartMode 參數設定為“All”或“Custom”)，以針對應用程式中的服務啟用自動啟動。將 –AutoStartMode 參數設定為“All”會針對應用程式中的所有服務啟用自動啟動。將 –AutoStartMode 參數設定為“Custom”可指定應用程式中的所有服務都不啟用自動啟動，除非明確針對服務啟用自動啟動 (透過執行 Enable-ASAppServiceAutoStart)。
針對應用程式啟用自動啟動時，會在伺服器等級的 applicationHost.config 檔案中新增 serviceAutoStartEnabled，並將其值設定為“true”。啟用應用程式中所有服務的自動啟動功能會將 applicationHost.config 檔案中應用程式的 serviceStartupMode 屬性值設定為“all”。將模式設定為 [自訂] 會將 serviceStartupMode 屬性值設定為“custom”。
Set-ASApplication 的語法選項：
語法 1
Set-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
語法 2
Set-ASApplication [-Uri] <Uri> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
語法 3
Set-ASApplication -ApplicationObject <ApplicationInfo> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
| 參數 | 描述 |
|---|---|
-SiteName |
要啟用自動啟動之 WCF 或 WF 應用程式的網站名稱。 |
-VirtualPath |
要啟用自動啟動之 WCF 或 WF 應用程式的虛擬路徑。 |
-Uri |
特定服務或應用程式的識別元。 |
-ApplicationObject |
應用程式物件的名稱，指定此參數可使用對應的 Web.config 檔案做為 Cmdlet 操作的基礎。 |
–AutoStartMode <-All|-Custom> (可省略) |
指定“All”值表示要針對應用程式中的所有服務啟用自動啟動，並忽略特定服務的自動啟動設定 (未包含 –AutoStartMode 時的預設行為)。指定“Custom”值表示要停用應用程式中所有服務的自動啟動，但已明確指定自動啟動設定的服務不受影響。服務的自動啟動模式取決於應用程式的自動啟動模式。 |
–EnableApplicationPool (可省略) |
啟用應用程式使用之應用程式集區的自動啟動。將應用程式集區的 startMode 屬性設定為“AlwaysRunning”。 |
停用應用程式的自動啟動
在 AppFabric Windows PowerShell 主控台，執行 Set-ASApplication Cmdlet (將 -AutoStartMode 參數設定為“Disable”)，以針對應用程式中的服務停用自動啟動。此動作會從 applicationHost.config 檔案刪除 serviceAutoStartMode 屬性。若未指定 serviceStartupMode 屬性，則會停用自動啟動。
Set-ASApplication 的語法選項：
語法 1
Set-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
語法 2
Set-ASApplication [-Uri] <Uri> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
語法 3
Set-ASApplication -ApplicationObject <ApplicationInfo> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
| 參數 | 描述 |
|---|---|
-SiteName (必要) |
要啟用自動啟動之 WCF 或 WF 應用程式的網站名稱。 |
-VirtualPath (必要) |
要啟用自動啟動之 WCF 或 WF 應用程式的虛擬路徑。 |
-Uri |
特定服務或應用程式的識別元。 |
-ApplicationObject |
應用程式物件的名稱，指定此參數可使用對應的 Web.config 檔案做為 Cmdlet 操作的基礎。 |
–AutoStartMode <Disable> |
指定“Disable”值可停用應用程式中所有服務的自動啟動。 |
–EnableApplicationPool (可省略) |
套用到應用程式的應用程式集區名稱。 |
取得應用程式的自動啟動設定
在 AppFabric Windows PowerShell 主控台，執行 Get-ASApplication Cmdlet 以取得應用程式的自動啟動設定。此 Cmdlet 會在 ApplicationInfo 物件中傳回設定。
Get-ASApplication 的語法選項：
語法 1
Get-ASApplication [[-SiteName] <String>] [[-VirtualPath] <String>] [[-ApplicationPoolName] <String>] [<CommonParameters>]
| 參數 | 描述 |
|---|---|
-SiteName (必要) |
要取得自動啟動之 WCF 或 WF 應用程式的網站名稱。 |
-VirtualPath (必要) |
要取得自動啟動之 WCF 或 WF 應用程式的虛擬路徑。 |
-ApplicationPoolName (必要) |
套用到應用程式的應用程式集區名稱。 |
啟用服務的自動啟動
在 AppFabric Windows PowerShell 主控台，執行 Enable-ASAppServiceAutoStart Cmdlet 以啟用服務的自動啟動。若要這樣做，請執行 Set-ASApplication (將 AutoStartMode 設定為“Custom”)，以啟用包含服務之應用程式的自動啟動。為服務啟用自動啟動功能會將 serviceAddress 行新增至應用程式 Web.config 檔案中的服務 serviceAutoStart 屬性。您可以使用 –SiteName –VirtualPath 參數集、–Uri 參數集或 ServiceObject 參數，來指定要啟用自動啟動的服務。
Enable-ASAppServiceAutoStart 的語法選項：
語法 1
Enable-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [<CommonParameters>]
語法 2
Enable-ASAppServiceAutoStart [-Uri] <Uri> [<CommonParameters>]
語法 3
Enable-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [<CommonParameters>]
| 參數 | 描述 |
|---|---|
-SiteName (必要) |
要啟用自動啟動之 WCF 或 WF 服務的網站名稱。 |
-VirtualPath (必要) |
要啟用自動啟動之 WCF 或 WF 服務的虛擬路徑。 |
-Uri |
特定服務或應用程式的識別元。 |
-ServiceObject |
服務物件的名稱，指定此參數可使用對應的 Web.config 檔案做為 Cmdlet 操作的基礎。 |
停用服務的自動啟動
在 AppFabric Windows PowerShell 主控台，執行 Disable-ASAppServiceAutoStart Cmdlet 以啟用服務的自動啟動。停用服務的自動啟動功能會將 serviceAddress 行從應用程式 Web.config 檔案的服務 serviceAutoStart 屬性移除。您可以使用 –SiteName –VirtualPath 參數集、–Uri 參數集或 ServiceObject 參數，來指定要停用自動啟動的服務。
Disable-ASAppServiceAutoStart 的語法選項：
語法 1
Disable-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [-Confirm] [-WhatIf] [<CommonParameters>]
語法 2
Disable-ASAppServiceAutoStart [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]
語法 3
Disable-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [-Confirm] [-WhatIf] [<CommonParameters>]
| 參數 | 描述 |
|---|---|
-SiteName (必要) |
要停用自動啟動之 WCF 或 WF 服務的網站名稱。 |
-VirtualPath (必要) |
要停用自動啟動之 WCF 或 WF 服務的虛擬路徑。 |
-Uri |
特定服務或應用程式的識別元。 |
-ServiceObject |
服務物件的名稱，指定此參數可使用對應的 Web.config 檔案做為 Cmdlet 操作的基礎。 |
取得服務的自動啟動設定
在 AppFabric Windows PowerShell 主控台，執行 Get-ASAppServiceAutoStart Cmdlet 以取得服務的自動啟動設定。此 Cmdlet 會在 ServiceAutoStartInfo 物件中傳回設定。您可以使用 –SiteName –VirtualPath 參數集、–Uri 參數集或 ServiceObject 參數，來指定要取得自動啟動資訊的服務。
Get-ASAppServiceAutoStart 的語法選項：
語法 1
Get-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [<CommonParameters>]
語法 2
Get-ASAppServiceAutoStart [-Uri] <Uri> [<CommonParameters>]
語法 3
Get-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [<CommonParameters>]
| 參數 | 描述 |
|---|---|
-SiteName (必要) |
要取得自動啟動資訊之 WCF 或 WF 服務的網站名稱。 |
-VirtualPath (必要) |
要取得自動啟動資訊之 WCF 或 WF 服務的虛擬路徑。 |
-Uri |
特定服務或應用程式的識別元。 |
-ServiceObject |
服務物件的名稱，指定此參數可使用對應的 Web.config 檔案做為 Cmdlet 操作的基礎。 |
2012-03-05