Enable-PSRemoting
将计算机配置为接收远程命令。
语法
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 所返回对象的类型。
输入 |
无 不能通过管道将输入传递给此 cmdlet。 |
输出 |
System.String Enable-PSRemoting 返回描述其结果的字符串。 |
示例 1
C:\PS>enable-psremoting
说明
-----------
此命令将计算机配置为接收远程命令。
示例 2
C:\PS>enable-psremoting -force
说明
-----------
此命令将计算机配置为接收远程命令。它使用 Force 参数禁止显示用户提示。
另请参阅
概念
about_Remote
about_Session_Configurations
Disable-PSRemoting
Get-PSSessionConfiguration
Enable-PSSessionConfiguration
Disable-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
WSMan Provider