winrs

Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Windows Remoteverwaltung ermöglicht Es Ihnen, Programme remote zu verwalten und auszuführen.

Syntax

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

Parameter

Parameter BESCHREIBUNG
/remote:<endpoint> Gibt den Zielendpunkt mithilfe eines NetBIOS-Namens oder der Standardverbindung an:

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

falls nicht angegeben, wird /r:localhost verwendet.

/unverschlüsselt Gibt an, dass die Nachrichten an die Remoteshell nicht verschlüsselt werden. Dies ist nützlich für die Problembehandlung oder wenn der Netzwerkdatenverkehr bereits mit ipsec verschlüsselt ist oder wenn physische Sicherheit erzwungen wird.

Standardmäßig werden die Nachrichten mithilfe von Kerberos- oder NTLM-Schlüsseln verschlüsselt.

Diese Befehlszeilenoption wird ignoriert, wenn HTTPS-Transport ausgewählt ist.

/benutzername:<Benutzername> Gibt den Benutzernamen in der Befehlszeile an.

falls nicht angegeben, verwendet das Tool die Authentifizierung oder Eingabeaufforderung für den Namen.

wenn /username angegeben ist, muss auch /password angegeben werden.

/password:<password> Gibt das Kennwort in der Befehlszeile an.

wenn /password nicht angegeben, aber /benutzername ist, wird das Tool zur Eingabe des Kennworts aufgefordert.

wenn /password angegeben ist, muss auch /benutzername angegeben werden.

/timeout:<sekunden> Diese Option ist veraltet.
/directory:<path> Gibt das Startverzeichnis für Remoteshell an.

falls nicht angegeben, wird die Remoteshell im Startverzeichnis des Benutzers gestartet, das durch die Umgebungsvariable %USERPROFILE% definiert ist.

/environment:<string>=<value> Gibt eine einzelne Umgebungsvariable an, die beim Starten der Shell festgelegt werden soll, wodurch die Standardumgebung für shell geändert werden kann.

Mehrere Vorkommen dieses Switchs müssen verwendet werden, um mehrere Umgebungsvariablen anzugeben.

/noecho Gibt an, dass Echo deaktiviert werden soll. Dies kann erforderlich sein, um sicherzustellen, dass die Antworten des Benutzers auf Remoteaufforderungen nicht lokal angezeigt werden.

Standardmäßig ist Echo aktiviert.

/noprofile Gibt an, dass das Profil des Benutzers nicht geladen werden soll.

Standardmäßig versucht der Server, das Benutzerprofil zu laden.

Wenn der Remotebenutzer kein lokaler Administrator im Zielsystem ist, ist diese Option erforderlich (der Standardwert führt zu Einem Fehler).

/allowdelegate Gibt an, dass die Anmeldeinformationen des Benutzers verwendet werden können, um auf eine Remotefreigabe zuzugreifen, z. B. auf einem anderen Computer als dem Zielendpunkt.
/komprimierung Aktivieren Sie die Komprimierung. Ältere Installationen auf Remotecomputern unterstützen möglicherweise keine Komprimierung, sodass sie standardmäßig deaktiviert ist.

Die Standardeinstellung ist deaktiviert, da ältere Installationen auf Remotecomputern möglicherweise keine Komprimierung unterstützen.

/usessl Verwenden Sie eine SSL-Verbindung bei Verwendung eines Remoteendpunkts. Geben Sie dies anstelle des Transports https an: verwendet den Standardmäßigen WinRM-Standardport .
/? Zeigt die Hilfe an der Eingabeaufforderung an.

Hinweise

  • Alle Befehlszeilenoptionen akzeptieren entweder kurze Form oder lange Form. Beispielsweise sind /r und /remote gültig.
  • Um den /remote-Befehl zu beenden, kann der Benutzer STRG-C oder STRG-Umbruch eingeben, der an die Remoteshell gesendet wird. Die zweite STRG-C erzwingt die Beendigung von winrs.exe.
  • Um aktive Remoteshells oder Winrs-Konfiguration zu verwalten, verwenden Sie das WinRM-Tool. Der URI-Alias zum Verwalten aktiver Shells ist shell/cmd. Der URI-Alias für winrs-Konfiguration ist winrm/config/winrs.

Beispiele

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

Weitere Verweise