Udostępnij za pośrednictwem

winrs (Windows Remote Shell)

Zdalne zarządzanie systemem Windows za pomocą polecenia winrs umożliwia zdalne zarządzanie i wykonywanie programów.

Składnia

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

Parametry

Parametr Opis
/remote:<endpoint> Określa docelowy punkt końcowy przy użyciu nazwy NetBIOS lub standardowego połączenia:

- <Adres URL>: [<transport>://]<target>[:<port>]

Jeśli nie zostanie określony, jest używany /r:localhost .
/Niezaszyfrowane Określa, że komunikaty do zdalnej powłoki nie są szyfrowane. Ten parametr jest przydatny do rozwiązywania problemów lub gdy ruch sieciowy jest już szyfrowany przy użyciu protokołu ipsec lub gdy zabezpieczenia fizyczne są wymuszane.

Domyślnie komunikaty są szyfrowane przy użyciu kluczy Kerberos lub NTLM.

Ta opcja wiersza polecenia jest ignorowana po wybraniu transportu HTTPS.
/nazwa_użytkownika:<nazwa użytkownika> Określa nazwę użytkownika w wierszu polecenia.

Jeśli nie zostanie określony, narzędzie używa uwierzytelniania negocjującego lub monitu o podanie nazwy.

Jeśli /username jest określony, /password musi być również określony.
/password:<hasło> Określa hasło w wierszu polecenia.

Jeśli /password nie jest określony, ale /username is, narzędzie monituje o hasło.

Jeśli /password jest określony, /username musi być również określony.
/timeout:<s> Ta opcja jest przestarzała.
/katalog:<ścieżka> Określa katalog początkowy dla zdalnej powłoki.

Jeśli nie zostanie określona, powłoka zdalna zostanie uruchomiona w katalogu głównym użytkownika zdefiniowanym przez zmienną środowiskową %USERPROFILE%.
/environment:<string>=<wartość> Określa pojedynczą zmienną środowiskową, która ma być ustawiana podczas uruchamiania powłoki, co umożliwia zmianę domyślnego środowiska dla powłoki.

Aby określić wiele zmiennych środowiskowych, należy użyć wielu wystąpień tego przełącznika.
/noecho powiedział: Określa, że echo powinno być wyłączone. Noecho może być konieczne, aby upewnić się, że odpowiedzi użytkownika na zdalne monity nie są wyświetlane lokalnie.

Domyślnie echo jest włączone.
/noprofile Określa, że profil użytkownika nie powinien być ładowany.

Domyślnie serwer próbuje załadować profil użytkownika.

Jeśli użytkownik zdalny nie jest administratorem lokalnym w systemie docelowym, ta opcja jest wymagana (wartość domyślna powoduje błąd).
/allowdelegate (zezwalaj) Określa, że poświadczenia użytkownika mogą służyć do uzyskiwania dostępu do udziału zdalnego, na przykład innej maszyny niż docelowy punkt końcowy.
/kompresja Włącz kompresję. Starsze instalacje na maszynach zdalnych mogą nie obsługiwać kompresji.

Ustawienie domyślne jest wyłączone, ponieważ starsze instalacje na maszynach zdalnych mogą nie obsługiwać kompresji.
/usessl Użyj połączenia SSL podczas korzystania z zdalnego punktu końcowego. Określanie protokołu SSL zamiast protokołu HTTPS transportu : używa domyślnego portu usługi WinRM .
/? Wyświetla pomoc w wierszu polecenia.

Uwagi

  • Wszystkie opcje wiersza polecenia akceptują krótki formularz lub długi formularz. Na przykład zarówno /r , jak i /remote są prawidłowe.
  • Aby zakończyć /remote polecenia, użytkownik może wpisać Ctrl-C lub Ctrl-break, który jest wysyłany do zdalnej powłoki. Drugi ctrl-C wymusza zakończenie winrs.exe.
  • Aby zarządzać aktywnymi powłokami zdalnymi lub konfiguracją winrs, użyj narzędzia WinRM. Alias identyfikatora URI do zarządzania aktywnymi powłokami to shell/cmd. Alias identyfikatora URI dla konfiguracji winrs to winrm/config/winrs.

Przykłady

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