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

语法

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

说明

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

只需在接收命令的每台计算机上运行一次此命令。无需在只发送命令的计算机上运行该命令。由于该配置会激活侦听器,因此谨慎的做法是仅在需要时才运行该命令。

Enable-PSRemoting cmdlet 可执行以下操作:

-- 运行 Set-WSManQuickConfig cmdlet,后者将执行以下任务:

----- 启动 WinRM 服务。

----- 将 WinRM 服务的启动类型设置为“自动”。

----- 创建一个侦听器以接受任意 IP 地址上的请求。

----- 对 WS-Management 通信启用防火墙例外。

-- 启用所有已注册的 Windows PowerShell 会话配置以从远程计算机接收指令。

----- 注册“Microsoft.PowerShell”会话配置(如果尚未注册该配置)。

----- 在 64 位计算机上注册“Microsoft.PowerShell32”会话配置(如果尚未注册该配置)。

----- 从所有已注册的会话配置的安全描述符中删除“拒绝所有用户”设置。

----- 重新启动 WinRM 服务以使上述更改生效。

若要在 Windows Vista、Windows Server 2008 以及更高版本的 Windows 上运行此 cmdlet,您必须使用“以管理员身份运行”选项启动 Windows PowerShell。

参数

-Force

禁止显示所有用户提示。默认情况下,提示您确认每个操作。

是否为必需?

false

位置?

named

默认值

False

是否接受管道输入?

false

是否接受通配符?

false

-Confirm

在执行命令之前提示您进行确认。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-WhatIf

描述如果执行该命令会发生什么情况(无需实际执行该命令)。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

None

不能通过管道将输入传递给此 cmdlet。

输出

System.String

Enable-PSRemoting 返回描述其结果的字符串。

示例 1

C:\PS>enable-psremoting

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






示例 2

C:\PS>enable-psremoting -force

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






另请参阅




目录