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

语法

Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

说明

Enable-PSSessionConfiguration cmdlet 重新启用已使用 Disable-PSSessionConfiguration cmdlet 禁用的已注册会话配置。这是一个高级 cmdlet,供系统管理员为其用户管理自定义会话配置时使用。

如果不使用参数,Enable-PSSessionConfiguration 将重新启用 Microsoft.PowerShell 配置,即用于会话的默认配置。

此 cmdlet 对启用的每个配置执行以下操作:

-- 从该配置的安全描述符中删除“拒绝所有用户”设置,或用指定的安全描述符替换原有安全描述符。

-- 启用侦听器以接收任意 IP 地址上的请求。

-- 重新启动 WinRM 服务。

Enable-PSSessionConfiguration cmdlet 将调用 Set-WSManQuickConfig cmdlet。但是,不能使用它在计算机上启用远程处理,而应使用功能更全面的 Enable-PSRemoting cmdlet。

参数

-Force

禁止显示所有用户提示,并重新启动 WinRM 服务而不显示提示。重新启动服务将使配置更改生效。

若要阻止重新启动并禁止显示重新启动提示,请使用 NoServiceRestart 参数。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Name <string[]>

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

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

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

是否为必需?

false

位置?

1

默认值

是否接受管道输入?

true (ByValue, ByPropertyName)

是否接受通配符?

true

-SecurityDescriptorSDDL <string>

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

如果省略此参数,则 Enable-PSSessionConfiguration 只是从安全描述符中删除“全部拒绝”项。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Confirm

在执行命令之前提示您进行确认。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-WhatIf

描述如果执行该命令会发生什么情况(无需实际执行该命令)。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String

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

输出

None

此 cmdlet 不返回任何对象。

说明

若要在 Windows Vista、Windows Server 2008 以及更高版本的 Windows 上运行此 cmdlet,您必须使用“以管理员身份运行”选项启动 Windows PowerShell。

示例 1

C:\PS>Enable-PSSessionConfiguration

说明
-----------
此命令重新启用计算机上的 Microsoft.PowerShell 默认会话配置。






示例 2

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell

说明
-----------
此命令重新启用计算机上的 MaintenanceShell 和 AdminShell 会话配置。






示例 3

C:\PS>Enable-PSSessionConfiguration -name *

C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration

说明
-----------
这些命令重新启用计算机上的所有会话配置。这些命令是等效的,因此您可以使用其中任何一个。

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






示例 4

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"

说明
-----------
此命令重新启用 MaintenanceShell 会话配置并为该配置指定新的安全描述符。






另请参阅




目录