使用 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