使用 Windows Server AppFabric Cmdlet 配置自动启动

本主题介绍如何使用 AppFabric cmdlet 配置应用程序或服务的自动启动。

启用应用程序的自动启动

在 AppFabric Windows PowerShell 控制台中,执行 Set-ASApplication cmdlet,将 -AutoStartMode 参数设置为“All”或“Custom”,从而为应用程序中的服务启用自动启动。将 –AutoStartMode 参数设置为“All”可为应用程序中的所有服务启用自动启动。将 –AutoStartMode 参数设置为“Custom”可指定除了专为某个服务启用自动启动(通过执行 Enable-ASAppServiceAutoStart)之外,不会为应用程序中的任何服务启用自动启动。

启用应用程序的自动启动将添加 serviceAutoStartEnabled,以将服务器级别的 applicationHost.config 文件中的相应值设置为“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”,从而为包含服务的应用程序启用自动启动。如果为服务启用自动启动,会在应用程序 Web.config 文件中将 serviceAddress 行添加到该服务的 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 以禁用服务的自动启动。如果为服务禁用自动启动,会在应用程序 Web.config 文件中从该服务的 serviceAutoStart 属性中删除 serviceAddress 行。您可以通过使用 –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