Freigeben über

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.

Mit dem Cmdlet Set-WSManQuickConfig wird der Computer so konfiguriert, dass PowerShell-Remotebefehle empfangen werden, die mithilfe der Webdienste für die Verwaltung (WS-Management) -Technologie 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 automatisch fest.
  • Erstellt einen Listener, um Anforderungen an eine beliebige IP-Adresse zu akzeptieren. Der Standardtransport ist HTTP-.
  • Aktiviert eine Firewall-Ausnahme für WinRM-Datenverkehr.

Um Set-WSManQuickConfigauszuführen, starten Sie PowerShell 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 für 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 parameter UseSSL gibt an, dass HTTPS- für die Kommunikation mit dem Computer verwendet wird.

Set-WSManQuickConfig -UseSSL

Anmerkung

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

Parameter

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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 ermöglicht 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 sie unabhängig vom Wert dieses Parameters erneut aktiviert.

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

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.