共用方式為


使用 Windows Server 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 操作的基礎。

  2011-12-05