Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Windows-Remoteverwaltung ermöglicht über den Befehl „winrs“ die Remoteverwaltung und -ausführung von Programmen.
Syntax
winrs [/<parameter>[:<value>]] <command>
Parameters
| Parameter | Description |
|---|---|
| /remote:<Endpunkt> | 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 oder wenn der Netzwerkdatenverkehr bereits mit IPsec verschlüsselt ist oder wenn die 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. |
| /Benutzername:<Benutzername> | 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 , fordert das Tool zur Eingabe des Kennworts auf. Wenn /password angegeben ist, muss auch /username angegeben werden. |
| /timeout:<Sekunden> | Diese Option ist veraltet. |
| /Verzeichnis:<Pfad> | Gibt das Startverzeichnis für die Remoteshell an. Wenn nicht angegeben, startet die Remote-Shell im Home-Verzeichnis des Benutzers, das durch die Umgebungsvariable%USERPROFILE%definiert wird . |
| /environment:<string>=<Wert> | 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. Beim Angeben von SSL anstelle des Transports https wird der standardmäßige WinRM-Standardport verwendet. |
| /? | Zeigt die Hilfe an der Eingabeaufforderung an. |
Remarks
- Alle Befehlszeilenoptionen akzeptieren entweder Kurz- oder Langformen. Beispielsweise sind sowohl /r als auch /remote gültig.
- Um den Befehl /remote zu beenden, kann der Benutzer Strg-C oder Strg-Pause eingeben, der an die Remote-Shell gesendet wird. Die zweite 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 lautet shell/cmd. Der URI-Alias für die winrs-Konfiguration lautet winrm/config/winrs.
Examples
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