SYNTAX = (GROSSBUCHSTABEN = Wert, der vom Benutzer bereitgestellt werden muss.) winrs -/ARGUMENT[:WERT BEFEHL BEFEHL - Beliebige ...

SYNTAX
=====
(GROSSBUCHSTABEN = Wert, der vom Benutzer bereitgestellt werden muss.)

winrs [-/ARGUMENT[:WERT]] BEFEHL

BEFEHL - Beliebige Zeichenfolge, die in der Shell "cmd.exe" als Befehl ausgeführt werden kann.

ARGUMENTE
========
(Für alle Argumente wird sowohl die Kurzform als auch die Langform akzeptiert.
Zum Beispiel ist sowohl "-r" als auch "-remote" gültig.)

-r[emote]:ENDPUNKT      - Der Zielendpunkt, für den ein NetBIOS-Name oder die Standardverbindungs-URL verwendet wird:
 [TRANSPORT://]ZIEL[:PORT].
Ist dieses Argument nicht angegeben, wird "-r:localhost" verwendet.

-un[encrypted]          - Gibt an, dass die an die Remoteshell gesendeten Meldungen nicht verschlüsselt werden. Dies ist nützlich zur Problembehandlung, wenn der Netzwerkdatenverkehr bereits mit IPsec verschlüsselt wird oder wenn physische Sicherheit erzwungen wird. Die Meldungen werden standardmäßig mit Kerberos- oder NTLM-Schlüsseln verschlüsselt. Dieses Argument wird ignoriert, wenn der HTTPS-Transport ausgewählt ist. 

-u[sername]:BENUTZERNAME    - Geben Sie den Benutzernamen in der Befehlszeile an. Ist der Benutzername nicht angegeben, wird die Negotiate-Authentifizierung verwendet oder nach dem Namen gefragt. 
Wenn "-username" angegeben ist, muss "-password" ebenfalls angegeben werden.

-p[assword]:KENNWORT    - Geben Sie das Kennwort in der Befehlszeile an. Ist "-password" nicht, jedoch "-username" angegeben, wird das Kennwort abgefragt. Ist "-password"" angegeben, muss "-user" ebenfalls angegeben werden.

-t[imeout]:SEKUNDEN      - Diese Option ist veraltet. 

-d[irectory]:PFAD       - Gibt das Startverzeichnis für die Remoteshell an. Ist dieses Argument nicht angegeben, wird die Remoteshell in dem Basisverzeichnis des Benutzers gestartet, das durch %USERPROFILE% definiert ist.

-env[ironment]:ZEICHENFOLGE=WERT   - Gibt eine einzelne Umgebungsvariable an, die beim Starten der Shell festgelegt wird und das Ändern der Standardumgebung für die Shell ermöglicht. Wenn Sie mehrere Umgebungsvariablen angeben möchten, müssen Sie dieses Argument entsprechend oft verwenden.

-noe[cho]               - Gibt an, dass Echo deaktiviert werden soll. Dies kann erforderlich sein, um sicherzustellen, dass die Antworten des Benutzers auf Remoteeingabeaufforderungen nicht lokal angezeigt werden. Standardmäßig ist Echo aktiviert.

-nop[rofile]            - Gibt an, dass das Profil des Benutzers nicht geladen werden soll. Standardmäßig versucht der Server, das Benutzerprofil zu laden. Ist der Remotebenutzer auf dem Zielsystem kein lokaler Administrator, ist diese Option erforderlich (die Standardeinstellung führt zu einem Fehler).

-comp[ression]          - Aktiviert die Komprimierung. Die Komprimierung wird von älteren Installationen auf Remotecomputern möglicherweise nicht unterstützt, weshalb sie standardmäßig deaktiviert ist.

-[use]ssl               - Es wird eine SSL-Verbindung verwendet, wenn ein Remoteendpunkt verwendet wird. Ist diese Option anstelle des Transports "https:" angegeben, wird der WinRM-Standardport verwendet. 

-?                      - Hilfe

Zum Beenden des Remotebefehls kann der Benutzer STRG+C oder STRG+UNTBR anschlagen. Diese Tastenkombination wird an die Remoteshell gesendet. Das zweite Anschlagen von STRG+C erzwingt, dass "winrs.exe" beendet wird.

Zum Verwalten der aktiven Remoteshells oder der WinRS-Konfiguration wird das Tool WinRM verwendet. Der URI-Alias zum Verwalten aktiver Shells lautet "shell/cmd". Der URI-Alias zum Konfigurieren von WinRS lautet "winrm/config/winrs". Syntaxbeispiele sind im Tool WinRM zu finden, indem "WinRM -?" eingegeben wird.

Beispiele:
winrs -r:https://myserver.com Befehl
winrs -r:myserver.com -usessl Befehl
winrs -r:myserver Befehl
winrs -r:http://127.0.0.1 Befehl
winrs -r:http://169.51.2.101:80 -unencrypted Befehl
winrs -r:https://[::FFFF:129.144.52.38] Befehl
winrs -r:http://[1080:0:0:0:8:800:200C:417A]:80 Befehl
winrs -r:https://myserver.com -t:600 -u:administrator -p:$%fgh7 ipconfig
winrs -r:myserver -env:PATH=^%PATH^%;c:	ools -env:TEMP=d:	emp config.cmd
winrs -r:myserver netdom join myserver /domain:testdomain /userd:johns /passwordd:$%fgh789