Set-WSManQuickConfig
配置用于远程管理的本地计算机。
语法
All
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 |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-SkipNetworkProfileCheck
配置 Windows 客户端版本,以便在计算机位于公用网络上时进行远程处理。 此参数为公共网络启用一条防火墙规则,该规则仅允许来自同一本地子网内计算机的远程访问。
此参数对 Windows 的服务器版本没有影响,默认情况下,该版本具有公用网络的本地子网防火墙规则。 如果在 Windows 的服务器版本中禁用了本地子网防火墙规则,Enable-PSRemoting
重新启用它,而不考虑此参数的值。
若要删除本地子网限制并启用来自公共网络上所有位置的远程访问,请使用 Set-NetFirewallRule
模块中的 cmdlet。
此参数是在 PowerShell 3.0 中引入的。
参数属性
类型: | SwitchParameter |
默认值: | False |
支持通配符: | False |
不显示: | False |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-UseSSL
指定安全套接字层 (SSL) 协议用于建立与远程计算机的连接。 默认情况下,不使用 SSL。
WS-Management 加密通过网络传输的所有 PowerShell 内容。 使用 UseSSL 参数可以指定 HTTPS 的附加保护,而不是 HTTP。 如果使用此参数,并且 SSL 在用于连接的端口上不可用,则命令将失败。
HTTPS 需要手动配置 WinRM 和防火墙规则。 有关详细信息,请参阅 如何:为 HTTPS配置 WINRM。
参数属性
类型: | SwitchParameter |
默认值: | False |
支持通配符: | False |
不显示: | False |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
None
不能用管道将对象传送到此 cmdlet。
输出
String
此 cmdlet 将消息作为描述作后配置状态的 String 对象返回。