Set-WSManQuickConfig

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

语法

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

说明

cmdlet Set-WSManQuickConfig 将计算机配置为接收使用 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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

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

此参数对服务器版本的 Windows 没有影响,默认情况下,Windows 具有适用于公用网络的本地子网防火墙规则。 如果在 Windows 的服务器版本上禁用了本地子网防火墙规则, Enable-PSRemoting 请重新启用它,而不考虑此参数的值。

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

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

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

此 cmdlet 不接受任何输入。

输出

None

此 cmdlet 不会生成任何输出。