winrs

适用范围:Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012

通过使用 winrs 命令的 Windows 远程管理,可以远程管理和执行程序。

语法

winrs [/<parameter>[:<value>]] <command>

参数

参数 说明
/remote:<endpoint> 使用 NetBIOS 名称或标准连接指定目标终结点:

- <url>: [<transport>://]<target>[:<port>]

如果未指定,则使用 /r:localhostt。

/unencrypted 指定不加密发送到远程 shell 的消息。 此参数对于故障排除,或如果使用 ipsec 加密了网络流量,或强制实施了物理安全性的情况非常有用。

默认情况下,消息使用 Kerberos 或 NTLM 密钥进行加密。

选择 HTTPS 传输时,将忽略此命令行选项。

/username:<username> 在命令行上指定用户名。

如果未指定,该工具会使用协商身份验证或提示输入用户名。

如果指定了 /username,也必须指定 /password。

/password:<password> 在命令行上指定密码。

如果未指定 /password,但指定了 /username,则该工具会提示输入密码。

如果指定了 /password,也必须指定 /username。

/timeout:<seconds> 此选项已弃用。
/directory:<path> 指定远程 shell 的起始目录。

如果未指定,远程 shell 会在环境变量 %USERPROFILE% 定义的用户主目录中启动。

/environment:<string>=<value> 指定在 shell 启动时要设置的单个环境变量,该变量允许更改 shell 的默认环境。

必须使用多次出现的此开关来指定多个环境变量。

/noecho 指定应禁用回显。 可能需要 noecho 以确保用户对远程提示的答复不会在本地显示。

默认情况下,回显处于打开状态。

/noprofile 指定不应加载用户的配置文件。

默认情况下,服务器会尝试加载用户配置文件。

如果远程用户不是目标系统上的本地管理员,则需要此选项(默认值会导致错误)。

/allowdelegate 指定用户的凭据可用于访问远程共享,例如,在与目标终结点不同的计算机上。
/compression 开启压缩。 远程计算机上的旧安装可能不支持压缩。

默认设置为关闭,因为远程计算机上较旧的安装可能不支持压缩。

/usessl 在使用远程终结点时使用 SSL 连接。 指定 SSL 而不是传输 https: 会使用默认的 WinRM 默认端口。
/? 在命令提示符下显示帮助。

注解

  • 所有命令行选项都接受短格式或长格式。 例如,/r 和 /remote 都有效。
  • 若要终止 /remote 命令,用户可以键入 Ctrl-C 或 Ctrl-break,这些命令会发送到远程 shell。 第二个 Ctrl-C 强制终止 winrs.exe。
  • 若要管理活动的远程 shell 或 winrs 配置,请使用 WinRM 工具。 用于管理活动 shell 的 URI 别名为 shell/cmd。 winrs 配置的 URI 别名为 winrm/config/winrs。

示例

winrs /r:https://contoso.com command
winrs /r:contoso.com /usessl command
winrs /r:myserver command
winrs /r:http://127.0.0.1 command
winrs /r:http://169.51.2.101:80 /unencrypted command
winrs /r:https://[::FFFF:129.144.52.38] command
winrs /r:http://[1080:0:0:0:8:800:200C:417A]:80 command
winrs /r:https://contoso.com /t:600 /u:administrator /p:$%fgh7 ipconfig
winrs /r:myserver /env:path=^%path^%;c:\tools /env:TEMP=d:\temp config.cmd
winrs /r:myserver netdom join myserver /domain:testdomain /userd:johns /passwordd:$%fgh789
winrs /r:myserver /ad /u:administrator /p:$%fgh7 dir \\anotherserver\share