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 (的 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 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

指示 cmdlet 不提示进行确认，并且将在无提示的情况下重启 WinRM 服务。 重新启动服务可使配置更改生效。

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

指示 cmdlet 不会重启服务。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

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

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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

输出

None

此 cmdlet 不返回任何对象。

备注

此 cmdlet 仅在 Windows 平台上可用。

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