Set-WSManQuickConfig

  • Referenz
Modul:
Microsoft.WSMan.Management

Konfiguriert den lokalen Computer für die Remoteverwaltung.

Syntax

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Set-WSManQuickConfig Cmdlet konfiguriert den Computer für den Empfang von PowerShell-Remotebefehlen, die mithilfe der WS-Management-Technologie (Web Services for Management) gesendet werden.

Set-WSManQuickConfig führt die folgenden Aktionen aus:

  • Überprüft, ob der WinRM-Dienst ausgeführt wird. Wenn der WinRM-Dienst nicht ausgeführt wird, wird der Dienst gestartet.
  • Legt den Starttyp des WinRM-Diensts auf "Automatic" fest.
  • Erstellt einen Listener, um Anforderungen an beliebige IP-Adressen zu akzeptieren. Der Standardtransport ist HTTP.
  • Aktiviert eine Firewall-Ausnahme für WinRM-Datenverkehr.

Starten Sie Zum Ausführen Set-WSManQuickConfigPowerShell mit der Option "Als Administrator ausführen".

Beispiele

Beispiel 1: Aktivieren der Remoteverwaltung des lokalen Computers über HTTP

In diesem Beispiel wird die erforderliche Konfiguration festgelegt, um die Remoteverwaltung des lokalen Computers zu ermöglichen. Standardmäßig erstellt dieser Befehl einen WS-Management-Listener unter HTTP.

Set-WSManQuickConfig

Beispiel 2: Aktivieren der Remoteverwaltung des lokalen Computers über HTTPS

In diesem Beispiel wird die erforderliche Konfiguration festgelegt, um die Remoteverwaltung des lokalen Computers zu ermöglichen. Der UseSSL-Parameter gibt an, dass HTTPS für die Kommunikation mit dem Computer verwendet wird.

Set-WSManQuickConfig -UseSSL

Hinweis

HTTPS erfordert eine manuelle Konfiguration. Weitere Informationen finden Sie in der Beschreibung des UseSSL-Parameters .

Parameter

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipNetworkProfileCheck

Konfiguriert Windows-Clientversionen für Remoting, wenn sich der Computer in einem öffentlichen Netzwerk befindet. Dieser Parameter aktiviert eine Firewallregel für öffentliche Netzwerke, die den Remotezugriff nur von Computern im selben lokalen Subnetz zulässt.

Dieser Parameter hat keine Auswirkungen auf Serverversionen von Windows, die standardmäßig über eine lokale Subnetzfirewallregel für öffentliche Netzwerke verfügen. Wenn die lokale Subnetzfirewallregel auf der Serverversion von Windows deaktiviert ist, Enable-PSRemoting wird sie unabhängig vom Wert dieses Parameters erneut aktiviert.

Verwenden Sie das Set-NetFirewallRule Cmdlet im NetSecurity-Modul , um die lokale Subnetzeinschränkung zu entfernen und den Remotezugriff von allen Standorten in öffentlichen Netzwerken zu aktivieren.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseSSL

Gibt an, dass das SSL-Protokoll (Secure Sockets Layer) verwendet wird, um eine Verbindung mit dem Remotecomputer herzustellen. Standardmäßig wird SSL nicht verwendet.

WS-Management verschlüsselt alle PowerShell-Inhalte, die über das Netzwerk übertragen werden. Mit dem UseSSL-Parameter können Sie den zusätzlichen Schutz von HTTPS anstelle von HTTP angeben. Wenn Sie diesen Parameter verwenden und SSL für den Port, der für die Verbindung verwendet wird, nicht verfügbar ist, schlägt der Befehl fehl.

HTTPS erfordert eine manuelle Konfiguration von WinRM- und Firewallregeln. Weitere Informationen finden Sie unter How To: Configure WINRM for HTTPS.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

String

Dieses Cmdlet gibt eine Nachricht als String-Objekt zurück, das den Status der Konfiguration nach dem Vorgang beschreibt.