Enable-PSSessionConfiguration

模块:
Microsoft.PowerShell.Core Module

在本地计算机上启用会话配置。

语法

Default (默认值) 

Enable-PSSessionConfiguration
    [[-Name] <String[]>]
    [-Force]
    [-SecurityDescriptorSddl <String>]
    [-SkipNetworkProfileCheck]
    [-NoServiceRestart]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

该 Enable-PSSessionConfiguration cmdlet 启用已禁用的已注册会话配置，例如使用 Disable-PSSessionConfiguration 或 Disable-PSRemoting cmdlet 或 AccessMode 参数 Register-PSSessionConfiguration。 这是一个高级 cmdlet，旨在由系统管理员用来管理其用户的自定义会话配置。

如果没有参数，Enable-PSSessionConfiguration启用 Microsoft。PowerShell配置，这是用于会话的默认配置。

Enable-PSSessionConfiguration 从受影响会话配置的安全描述符中删除 Deny_All 设置，打开接受任何 IP 地址请求的侦听器，并重启 WinRM 服务。 从 PowerShell 3.0 开始，Enable-PSSessionConfiguration还将会话配置 （WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled） 的 Enabled 属性的值设置为 True。 但是， Enable-PSSessionConfiguration 不删除或更改仅允许本地计算机用户用于会话配置的 Network_Deny_All （AccessMode=Local） 安全描述符设置。

示例

示例 1：重新启用默认会话

此示例重新启用 Microsoft。PowerShell计算机上的默认会话配置。

Enable-PSSessionConfiguration

示例 2：重新启用指定的会话

此示例在计算机上重新启用 MaintenanceShell 和 AdminShell 会话配置。

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

示例 3：重新启用所有会话

此示例在计算机上重新启用所有会话配置。 这些命令是等效的。 因此，可以使用任一项。

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration 如果启用已启用的会话配置，则不会生成错误。

示例 4：重新启用会话并指定新的安全描述符

此示例重新启用 MaintenanceShell 会话配置，并为配置指定新的安全描述符。

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:Cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Force

指示该 cmdlet 不会提示你进行确认，并且不会提示重启 WinRM 服务。 重启服务会使配置更改生效。

若要防止重启并取消重启提示，请使用 NoServiceRestart 参数。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

指定要启用的会话配置的名称。 输入一个或多个配置名称。 允许使用通配符。

还可以通过管道将包含配置名称或会话配置对象的字符串传递给 Enable-PSSessionConfiguration。

如果省略此参数，Enable-PSSessionConfiguration启用 Microsoft。PowerShell会话配置。

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-NoServiceRestart

指示 cmdlet 不会重启服务。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SecurityDescriptorSddl

指定此 cmdlet 替换会话配置上的安全描述符的安全描述符。

如果省略此参数， Enable-PSSessionConfiguration 则仅从安全描述符中删除拒绝所有项。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SkipNetworkProfileCheck

指示当计算机位于公用网络上时，此 cmdlet 启用会话配置。 此参数为仅允许从同一本地子网中的计算机进行远程访问的公共网络启用防火墙规则。 默认情况下， Enable-PSSessionConfiguration 公共网络上失败。

此参数适用于Windows操作系统的客户端版本。 Windows操作系统的服务器版本具有公用网络的本地子网防火墙规则。 但是，如果在Windows操作系统的服务器版本中禁用本地子网防火墙规则，则此参数将重新启用它。

若要删除本地子网限制并启用从公共网络上的所有位置进行远程访问，请使用 Set-NetFirewallRule NetSecurity 模块中的 cmdlet。 有关详细信息，请参阅 Enable-PSRemoting。

此参数是在 PowerShell 3.0 中引入的。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

可以通过管道将会话配置对象传递给此 cmdlet。

String

可以通过管道将包含会话配置名称的字符串传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

备注

此 cmdlet 仅在 Windows 平台上可用。

若要使用此 cmdlet，必须使用 “以管理员身份运行 ”选项启动 PowerShell。