Set-WSManQuickConfig

  • Referentie
Module:
Microsoft.WSMan.Management

Hiermee configureert u de lokale computer voor extern beheer.

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Set-WSManQuickConfig cmdlet configureert de computer voor het ontvangen van externe PowerShell-opdrachten die worden verzonden met behulp van de WS-management-technologie (Web Services for 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 powershell wilt uitvoerenSet-WSManQuickConfig, start u PowerShell met de optie Uitvoeren als Beheer istrator.

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 maakt u standaard een WS-Management-listener 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

HTTPS vereist handmatige configuratie. 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 schakelt u deze opnieuw in, ongeacht de waarde van deze parameter.

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

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.