Delen via

Enable-PSSessionConfiguration

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee schakelt u de sessieconfiguraties op de lokale computer in.

Syntaxis

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met de Enable-PSSessionConfiguration-cmdlet kunt u geregistreerde sessieconfiguraties inschakelen die zijn uitgeschakeld, zoals met behulp van de Disable-PSSessionConfiguration- of Disable-PSRemoting-cmdlets, of de parameter AccessMode van Register-PSSessionConfiguration. Dit is een geavanceerde cmdlet die is ontworpen om te worden gebruikt door systeembeheerders voor het beheren van aangepaste sessieconfiguraties voor hun gebruikers.

Zonder parameters schakelt Enable-PSSessionConfiguration de Microsoft.PowerShell--configuratie in. Dit is de standaardconfiguratie die wordt gebruikt voor sessies.

Enable-PSSessionConfiguration verwijdert de Deny_All-instelling uit de beveiligingsdescriptor van de betrokken sessieconfiguraties, schakelt u de listener in die aanvragen accepteert op elk IP-adres en start u de WinRM-service opnieuw. Vanaf PowerShell 3.0 stelt Enable-PSSessionConfiguration ook de waarde van de eigenschap Enabled van de sessieconfiguratie (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) in op Waar. Enable-PSSessionConfiguration verwijdert of wijzigt echter niet de Network_Deny_All (AccessMode=Local) beveiligingsdescriptorinstelling waarmee alleen gebruikers van de lokale computer de sessieconfiguratie kunnen gebruiken.

Voorbeelden

Voorbeeld 1: De standaardsessie opnieuw inschakelen

In dit voorbeeld wordt de Microsoft.PowerShell opnieuw ingeschakeld standaardsessieconfiguratie op de computer.

Enable-PSSessionConfiguration

Voorbeeld 2: Opgegeven sessies opnieuw inschakelen

In dit voorbeeld worden de MaintenanceShell- en AdminShell sessieconfiguraties op de computer opnieuw ingeschakeld.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Voorbeeld 3: Alle sessies opnieuw inschakelen

In dit voorbeeld worden alle sessieconfiguraties op de computer opnieuw ingeschakeld. Deze opdrachten zijn gelijkwaardig. Daarom kunt u beide gebruiken.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration genereert geen fout als u een sessieconfiguratie inschakelt die al is ingeschakeld.

Voorbeeld 4: Een sessie opnieuw inschakelen en een nieuwe beveiligingsdescriptor opgeven

In dit voorbeeld wordt de MaintenanceShell sessieconfiguratie opnieuw ingeschakeld en wordt een nieuwe beveiligingsdescriptor voor de configuratie opgegeven.

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Force

Geeft aan dat de cmdlet u niet om bevestiging vraagt en de WinRM-service opnieuw start zonder dat u hierom wordt gevraagd. Als u de service opnieuw start, wordt de configuratiewijziging effectief.

Gebruik de parameter NoServiceRestart om opnieuw opstarten te voorkomen en de prompt voor opnieuw opstarten te onderdrukken.

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

-Name

Hiermee geeft u de namen van sessieconfiguraties die moeten worden ingeschakeld. Voer een of meer configuratienamen in. Jokertekens zijn toegestaan.

U kunt ook een tekenreeks met een configuratienaam of een sessieconfiguratieobject doorsluisen naar Enable-PSSessionConfiguration.

Als u deze parameter weglaat, schakelt Enable-PSSessionConfiguration de Microsoft.PowerShell sessieconfiguratie in.

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-NoServiceRestart

Geeft aan dat de cmdlet de service niet opnieuw start.

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

-SecurityDescriptorSddl

Hiermee geeft u een beveiligingsdescriptor op waarmee deze cmdlet de beveiligingsdescriptor voor de sessieconfiguratie vervangt.

Als u deze parameter weglaat, Enable-PSSessionConfiguration alleen het weigeren van alle items uit de beveiligingsdescriptor verwijdert.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipNetworkProfileCheck

Geeft aan dat deze cmdlet de sessieconfiguratie inschakelt wanneer de computer zich in 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. Standaard mislukt Enable-PSSessionConfiguration op een openbaar netwerk.

Deze parameter is ontworpen voor clientversies van het Windows-besturingssysteem. Serverversies van het Windows-besturingssysteem hebben een lokale subnetfirewallregel voor openbare netwerken. Als de firewallregel voor het lokale subnet echter is uitgeschakeld op een serverversie van het Windows-besturingssysteem, wordt deze parameter opnieuw ingeschakeld.

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. Zie Enable-PSRemotingvoor meer informatie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

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

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

U kunt een sessieconfiguratieobject of een tekenreeks met de naam van een sessieconfiguratie doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Met deze cmdlet worden geen objecten geretourneerd.

Notities

Als u deze cmdlet wilt gebruiken, moet u PowerShell starten met behulp van de optie Als administrator uitvoeren.