Set-WSManQuickConfig

参考

模块:: Microsoft.WSMan.Management

配置用于远程管理的本地计算机。

语法

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
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 对象返回。

通过