Delen via

Set-WSManQuickConfig

  • Referentie
Module:
Microsoft.WsMan.Management

Hiermee configureert u de lokale computer voor extern beheer.

Syntaxis

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

Description

De Set-WSManQuickConfig-cmdlet configureert de computer voor het ontvangen van externe PowerShell-opdrachten die worden verzonden met behulp van de technologie webservices voor beheer (WS-Management).

Set-WSManQuickConfig voert de volgende acties uit:

  • Controleert of de WinRM-service wordt uitgevoerd. Als de WinRM-service niet wordt uitgevoerd, wordt de service gestart.
  • Hiermee stelt u het opstarttype van de WinRM-service in op automatisch.
  • Hiermee maakt u een listener voor het accepteren van aanvragen op elk IP-adres. Het standaardtransport is HTTP-.
  • Hiermee schakelt u een firewall-uitzondering in voor WinRM-verkeer.

Als u Set-WSManQuickConfigwilt uitvoeren, start u PowerShell met de optie Als administrator uitvoeren.

Voorbeelden

Voorbeeld 1: Extern beheer van de lokale computer via HTTP inschakelen

In dit voorbeeld wordt de vereiste configuratie ingesteld om extern beheer van de lokale computer in te schakelen. Met deze opdracht wordt standaard een WS-Management listener gemaakt op HTTP-.

Set-WSManQuickConfig

Voorbeeld 2: Extern beheer van de lokale computer via HTTPS inschakelen

In dit voorbeeld wordt de vereiste configuratie ingesteld om extern beheer van de lokale computer in te schakelen. De parameter UseSSL geeft aan dat HTTPS- wordt gebruikt om met de computer te communiceren.

Set-WSManQuickConfig -UseSSL

Notitie

voor HTTPS- is handmatige configuratie vereist. Zie de beschrijving van de parameter UseSSL voor meer informatie.

Parameters

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipNetworkProfileCheck

Hiermee configureert u Windows-clientversies voor externe communicatie wanneer de computer zich op een openbaar netwerk bevindt. Met deze parameter wordt een firewallregel ingeschakeld voor openbare netwerken die externe toegang alleen vanaf computers in hetzelfde lokale subnet toestaat.

Deze parameter heeft geen effect op serverversies van Windows, die standaard een lokale subnetfirewallregel hebben voor openbare netwerken. Als de firewallregel voor het lokale subnet is uitgeschakeld op de serverversie van Windows, Enable-PSRemoting deze opnieuw inschakelt, ongeacht de waarde van deze parameter.

Als u de beperking van het lokale subnet wilt verwijderen en externe toegang vanaf alle locaties in openbare netwerken wilt inschakelen, gebruikt u de cmdlet Set-NetFirewallRule in de module NetSecurity.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseSSL

Hiermee geeft u op dat het SSL-protocol (Secure Sockets Layer) wordt gebruikt om een verbinding met de externe computer tot stand te brengen. SSL wordt standaard niet gebruikt.

WS-Management versleutelt alle PowerShell-inhoud die via het netwerk wordt verzonden. Met de parameter UseSSL kunt u de extra beveiliging van HTTPS opgeven in plaats van HTTP. Als u deze parameter gebruikt en SSL niet beschikbaar is op de poort die wordt gebruikt voor de verbinding, mislukt de opdracht.

HTTPS- vereist handmatige configuratie van WinRM- en firewallregels. Zie Procedure: WINRM configureren voor HTTPS-voor meer informatie.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden

None

Met deze cmdlet wordt geen uitvoer gegenereerd.