设置 WSManQuickConfig (Microsoft.WSMan.Management)

设置 WSManQuickConfig

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

句法

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

描述

此 cmdlet 仅适用于 Windows 平台。

Set-WSManQuickConfig cmdlet 将计算机配置为接收使用 Web 管理服务 (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

命名

False

False

False

False

-SkipNetworkProfileCheck

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

此参数对 Windows 服务器版本没有影响，默认情况下，Windows 具有针对公共网络的本地子网防火墙规则。如果在 Windows 服务器版本上禁用本地子网防火墙规则，Enable-PSRemoting 会重新启用它，无论此参数的值如何。

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

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

SwitchParameter

命名

False

False

False

False

-UseSSL

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

WS-Management 对通过网络传输的所有 PowerShell 内容进行加密。 UseSSL 参数允许您指定 HTTPS 而不是 HTTP 的附加保护。如果使用此参数并且 SSL 在用于连接的端口上不可用，则该命令将失败。

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

SwitchParameter

命名

False

False

False

False

输入

无

您无法将对象通过管道传输到此 cmdlet。

输出

字符串

此 cmdlet 以 String 对象形式返回一条消息，描述操作后的配置状态。