启用本地计算机上的会话配置。
语法
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 会话配置并为该配置指定新的安全描述符。
另请参阅