winrs

  • Artikel

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

Die Windows-Remoteverwaltung ermöglicht über den Befehl „winrs“ die Remoteverwaltung und -ausführung von Programmen.

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>]

wenn nicht angegeben, wird /r:localhost verwendet.
/unencrypted Gibt an, dass die Nachrichten an die Remoteshell nicht verschlüsselt sind. Dieser Parameter ist nützlich für die Problembehandlung, wenn der Netzwerkdatenverkehr bereits mit ipsec verschlüsselt ist oder wenn physische Sicherheit erzwungen wird.

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

Diese Befehlszeilenoption wird ignoriert, wenn HTTPS-Transport ausgewählt ist.
/username:<username> Gibt den Benutzernamen in der Befehlszeile an.

Wenn nicht angegeben, verwendet das Tool die Aushandlungsauthentifizierung oder die Aufforderung zur Eingabe des Namens.

Wenn /username angegeben ist, muss auch /password angegeben werden.
/password:<Kennwort> Gibt das Kennwort in der Befehlszeile an.

Wenn /password nicht angegeben ist, aber /username ist, fordert das Tool zur Eingabe des Kennworts auf.

Wenn /password angegeben ist, muss auch /username angegeben werden.
/timeout:<Sekunden> Diese Option ist veraltet.
/directory:<path> Gibt das Startverzeichnis für die Remoteshell an.

Wenn nicht angegeben, wird die Remoteshell im Basisverzeichnis von Benutzer*innen gestartet, das durch die Umgebungsvariable %USERPROFILE% definiert wird.
/environment:<string>=<value> Gibt eine einzelne Umgebungsvariable an, die beim Starten der Shell festgelegt werden soll. Damit können Sie die Standardumgebung für shell ändern.

Mehrere Vorkommen dieses Switches müssen verwendet werden, um mehrere Umgebungsvariablen anzugeben.
/noecho Gibt an, dass echo deaktiviert werden soll. „noecho“ kann erforderlich sein, um sicherzustellen, dass die Antworten von Benutzer*innen auf Remoteaufforderungen nicht lokal angezeigt werden.

Das Echo ist standardmäßig aktiviert.
/noprofile Gibt an, dass das Profil von Benutzer*innen nicht geladen werden soll.

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

Wenn der*die Remotebenutzer*in kein lokaler Administrator bzw. keine lokale Administratorin auf dem Zielsystem ist, ist diese Option erforderlich (der Standardwert führt zu einem Fehler).
/allowdelegate Gibt an, dass die Anmeldeinformationen von Benutzer*innen für den Zugriff auf eine Remotefreigabe verwendet werden können, z. B. auf einem anderen Computer als dem Zielendpunkt.
/compression Schaltet die Komprimierung ein. Ältere Installationen auf Remotecomputern unterstützen möglicherweise keine Komprimierung.

Die Standardeinstellung ist deaktiviert, da ältere Installationen auf Remotecomputern möglicherweise keine Komprimierung unterstützen.
/usessl Verwenden Sie eine SSL-Verbindung, wenn Sie einen Remoteendpunkt verwenden. Wenn Sie SSL anstelle der Transportmethode https: angeben, wird der WinRM-Standardport verwendet.
/? Zeigt die Hilfe an der Eingabeaufforderung an.

Bemerkungen

  • Alle Befehlszeilenoptionen akzeptieren entweder Kurz- oder Langformen. Beispielsweise sind sowohl /r als auch /remote gültig.
  • Um den Befehl /remote zu beenden, können Benutzer*innen STRG+C oder STRG-UNTBR eingeben. Diese Eingabe wird an die Remoteshell gesendet. Die zweite Eingabe von STRG+C erzwingt die Beendigung von winrs.exe.
  • Verwenden Sie das WinRM-Tool, um aktive Remoteshells oder winrs-Konfigurationen zu verwalten. Der URI-Alias zum Verwalten aktiver Shells ist shell/cmd. Der URI-Alias für die 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