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.

Start PowerShell met de optie Uitvoeren als administrator om uit te voerenSet-WSManQuickConfig.

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. Deze opdracht maakt 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 useSSL-parameter geeft aan dat HTTPS wordt gebruikt om te communiceren met de computer.

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 om bevestiging van de gebruiker te vragen.

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipNetworkProfileCheck

Hiermee configureert u Windows-clientversies voor externe toegang wanneer de computer zich in een openbaar netwerk bevindt. Met deze parameter wordt een firewallregel ingeschakeld voor openbare netwerken die alleen externe toegang 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 vanaf alle locaties in openbare netwerken wilt inschakelen, 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
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
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden