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