Enable-PSSessionConfiguration

参考

模块:: Microsoft.PowerShell.Core

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

语法

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）的“已启用 ”属性 的值设置为 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
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

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

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

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

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

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

类型:	String[]
Position:	0
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	True

-NoServiceRestart

指示 cmdlet 不会重启服务。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecurityDescriptorSddl

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

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipNetworkProfileCheck

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

此参数专为 Windows作系统的客户端版本而设计。 Windows作系统的服务器版本具有公用网络的本地子网防火墙规则。但是，如果在 Windows作系统的服务器版本上禁用了本地子网防火墙规则，则此参数将重新启用它。

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

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

String

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

输出

None

此 cmdlet 不返回任何输出。

备注

此 cmdlet 仅在 Windows 平台上可用。

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

通过