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:localhost

/unencrypted 指定遠端殼層的訊息不會加密。 此參數適用於疑難排解、或已使用 ipsec 加密網路流量,或強制執行實體安全性時。

根據預設,訊息會使用 Kerberos 或 NTLM 金鑰加密。

選取 HTTPS 傳輸時,會忽略此命令列選項。

/username:<username> 指定命令列上的使用者名稱。

如果未指定,此工具會使用交涉驗證或提示名稱。

如果指定了 /username,也必須指定 /password

/password:<password> 指定命令列上的密碼。

如果未指定 /password,但指定了 /username,工具會提示輸入密碼。

如果指定了 /password,也必須指定 /username

/timeout:<seconds> 即將淘汰此選項。
/directory:<path> 指定遠端殼層的起始目錄。

如果未指定,遠端殼層會在環境變數 %USERPROFILE% 所定義的使用者主目錄中啟動。

/environment:<string>=<value> 指定要在殼層啟動時設定的單一環境變數,以允許變更殼層的預設環境。

此切換的多次發生必須用來指定多個環境變數。

/noecho 指定應該停用回應。 noecho 可能需要確保使用者對遠端提示的解答不會在本機顯示。

預設為開啟回應。

/noprofile 指定不應該載入使用者的設定檔。

根據預設,伺服器會嘗試載入使用者設定檔。

如果遠端使用者不是目標系統上的本機系統管理員,則需要此選項 (預設會導致錯誤)。

/allowdelegate 指定使用者認證可用來存取遠端共用,例如:與目標端點不同的電腦。
/compression 開啟壓縮。 遠端電腦上較舊的安裝可能不支援壓縮。

預設設定為關閉,因為遠端電腦上較舊的安裝可能不支援壓縮。

/usessl 使用遠端端點時,請使用 SSL 連線。 指定 SSL 而不是傳輸 https: 使用預設 WinRM 預設連接埠。
/? 在命令提示字元顯示說明。

備註

  • 所有命令列選項都接受簡短形式或長形式。 例如:/r/remote 都是有效的。
  • 若要終止 /remote 命令,使用者可以輸入 Ctrl-CCtrl-break,這會傳送至遠端殼層。 第二個 Ctrl-C 會強制終止 winrs.exe
  • 若要管理作用中的遠端殼層或 winrs 設定,請使用 WinRM 工具。 管理作用中殼層的 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