当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 启用 PSSessionConfiguration (Microsoft.PowerShell.Core)

作者:精品下载站 日期:2024-12-14 02:16:33 浏览:13 分类:玩电脑

启用 PSSessionConfiguration (Microsoft.PowerShell.Core)


启用-PSSessionConfiguration

模块 :Microsoft.PowerShell.Core

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

句法

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

描述

此 cmdlet 仅适用于 Windows 平台。

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

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

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

示例

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

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

Enable-PSSessionConfiguration

示例 2:重新启用指定会话

此示例重新启用计算机上的 MaintenanceShellAdminShell 会话配置。

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

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Force

指示 cmdlet 不提示您确认,并在不提示的情况下重新启动 WinRM 服务。重新启动服务使配置更改生效。

要防止重新启动并抑制重新启动提示,请使用 NoServiceRestart 参数。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Name

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

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

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

类型 :

String[]

位置:

0

默认值:

None

必需的:

False

接受管道输入:

True

接受通配符:

True

-NoServiceRestart

指示 cmdlet 不会重新启动服务。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-SecurityDescriptorSddl

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

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

类型 :

String

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-SkipNetworkProfileCheck

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

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

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

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

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-WhatIf

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

类型 :

SwitchParameter

别名:

wi

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

字符串

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

输出

此 cmdlet 不返回任何输出。

笔记

此 cmdlet 仅在 Windows 平台上可用。

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

您需要 登录账户 后才能发表评论

取消回复欢迎 发表评论:

关灯