Set-WSManQuickConfig

配置本地计算机以进行远程管理。

语法

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

Set-WSManQuickConfig cmdlet 将计算机配置为接收使用 Web Services for Management (WS-Management) 技术发送的 PowerShell 远程命令。

Set-WSManQuickConfig 执行以下操作:

  • 检查 WinRM 服务是否正在运行。 如果 WinRM 服务未运行,则会启动该服务。
  • 将 WinRM 服务启动类型设置为自动。
  • 创建一个可接受任何 IP 地址上的请求的侦听器。 默认情况下,传输为 HTTP
  • 对 WinRM 流量启用防火墙例外。

若要运行 Set-WSManQuickConfig,请使用“以管理员身份运行”选项启动 PowerShell。

示例

示例 1:通过 HTTP 启用本地计算机的远程管理

此示例设置所需的配置以启用本地计算机的远程管理。 默认情况下,此命令会在 HTTP 上创建 WS-Management 侦听器。

Set-WSManQuickConfig

示例 2:通过 HTTPS 启用本地计算机的远程管理

此示例设置所需的配置以启用本地计算机的远程管理。 UseSSL 参数指定使用 HTTPS 与计算机通信。

Set-WSManQuickConfig -UseSSL

注意

HTTPS 需要手动配置。 有关详细信息,请参阅 UseSSL 参数的说明。

参数

-Force

强制运行命令而不要求用户确认。

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

-SkipNetworkProfileCheck

当计算机位于公用网络上时,配置 Windows 客户端版本以供远程处理。 此参数只允许为公用网络启用防火墙规则,该规则只允许远程访问同一本地子网中的计算机。

此参数对 Windows 的服务器版本不起作用,这些版本在默认情况下具有适用于公用网络的本地子网防火墙规则。 如果本地子网防火墙规则在 Windows 的服务器版本上处于禁用状态,Enable-PSRemoting 会将其重新启用,而不考虑此参数的值。

若要删除本地子网限制并启用从公用网络上的所有位置进行远程访问,请使用 NetSecurity 模块中的 Set-NetFirewallRule cmdlet。

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

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

-UseSSL

指定使用安全套接字层 (SSL) 协议来建立与远程计算机的连接。 默认情况下,不使用 SSL。

WS-Management 对通过网络传输的所有 PowerShell 内容进行加密。 可以使用 UseSSL 参数指定 HTTPS(而非 HTTP)的额外保护措施。 如果使用此参数,并且 SSL 在用于连接的端口上不可用,该命令将失败。

HTTPS 需要手动配置 WinRM 和防火墙规则。 有关详细信息,请参阅如何为 HTTPS 配置 WINRM

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

输入

None

无法通过管道将对象传递给此 cmdlet。

输出

String

此 cmdlet 将消息作为 String 对象返回,该对象描述操作后的配置状态。