Enable-PSRemoting

Enable-PSRemoting
    [-Force]
    [-SkipNetworkProfileCheck]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Enable-PSRemoting cmdlet 将计算机配置为接收使用 WS-Management 技术发送的 PowerShell 远程命令。

默认情况下，在 Windows Server 2012 及更高版本上启用 PowerShell 远程处理。 可以使用 Enable-PSRemoting 在其他受支持的 Windows 版本上启用 PowerShell 远程处理，并在远程处理被禁用时重新启用远程处理。

只需在接收命令的每台计算机上运行此命令一次。 无需在仅发送命令的计算机上运行它。 由于配置启动侦听器，因此应谨慎只在需要时运行它。

从 PowerShell 3.0 开始，Enable-PSRemoting cmdlet 可以在计算机位于公共网络上时在 Windows 的客户端版本上启用 PowerShell 远程处理。 有关详细信息，请参阅 SkipNetworkProfileCheck 参数的说明。

Enable-PSRemoting cmdlet 执行以下操作：

• 运行 Set-WSManQuickConfig cmdlet，该 cmdlet 执行以下任务：
  • 启动 WinRM 服务。
  • 将 WinRM 服务上的启动类型设置为“自动”。
  • 创建一个侦听器以处理来自任意 IP 地址的请求。
  • 为 WS-Management 通信启用防火墙例外。
  • 注册 Microsoft.PowerShell，Microsoft.PowerShell.Workflow 会话配置（如果尚未注册）。
  • 在 64 位计算机上注册 Microsoft.PowerShell32 会话配置（如果尚未注册）。
  • 启用所有会话配置。
  • 更改所有会话配置的安全描述符以允许远程访问。
• 重启 WinRM 服务，使上述更改生效。

若要在 Windows 平台上运行此 cmdlet，请使用“以管理员身份运行”选项启动 PowerShell。

有关使用 PowerShell 远程处理的详细信息，请参阅以下文章：

• 关于远程要求
• 关于远程

此命令将计算机配置为接收远程命令。

Enable-PSRemoting

此命令将计算机配置为接收远程命令。 Force 参数禁止显示用户提示。

Enable-PSRemoting -Force

此示例演示如何在 Windows 操作系统的客户端版本上允许从公用网络进行远程访问。 对于不同版本的 Windows，防火墙规则的名称可能有所不同。 使用 Get-NetFirewallRule 查看规则列表。 在启用防火墙规则之前，请查看规则中的安全设置，以验证配置是否适合你的环境。

Get-NetFirewallRule -Name 'WINRM*' | Select-Object -Property Name

Name
----
WINRM-HTTP-In-TCP-NoScope
WINRM-HTTP-In-TCP
WINRM-HTTP-Compat-In-TCP-NoScope
WINRM-HTTP-Compat-In-TCP

Enable-PSRemoting -SkipNetworkProfileCheck -Force
Set-NetFirewallRule -Name 'WINRM-HTTP-In-TCP' -RemoteAddress Any

默认情况下，Enable-PSRemoting 创建允许从专用网络和域网络进行远程访问的网络规则。 该命令使用 SkipNetworkProfileCheck 参数允许从同一本地子网中的公用网络进行远程访问。 该命令指定 Force 参数来禁止确认消息。

SkipNetworkProfileCheck 参数不会影响 Windows作系统的服务器版本，默认情况下允许从同一本地子网中的公用网络进行远程访问。

Set-NetFirewallRule 模块中的 cmdlet 添加了允许从任何远程位置从公用网络远程访问的防火墙规则。 这包括不同子网中的位置。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

此 cmdlet 返回描述其结果的字符串。

从 PowerShell 3.0 开始，Enable-PSRemoting 通过将所有会话配置 已启用 属性的值设置为 $true来启用所有会话配置。

• 在 Windows 操作系统的服务器版本中，Enable-PSRemoting 为允许远程访问的专用网络和域网络创建防火墙规则，并为公共网络创建防火墙规则，该规则仅允许从同一本地子网中的计算机进行远程访问。

• 在 Windows作系统的客户端版本上，PowerShell 3.0 中的 Enable-PSRemoting 为允许不受限制的远程访问的专用和域网络创建防火墙规则。 若要为允许从同一本地子网进行远程访问的公共网络创建防火墙规则，请使用 SkipNetworkProfileCheck 参数。

• 在 Windows 操作系统的客户端或服务器版本中，若要为删除本地子网限制并允许远程访问的公共网络创建防火墙规则，请使用 NetSecurity 模块中的 Set-NetFirewallRule cmdlet 运行以下命令：Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP-PUBLIC" -RemoteAddress Any

Enable-PSRemoting 通过将所有会话配置的启用属性值设置为 $true 来启用所有会话配置。

Enable-PSRemoting 删除 Deny_All 和 Network_Deny_All 设置。 这提供对保留供本地使用的会话配置的远程访问。