Enable-PSSessionConfiguration
Hiermee schakelt u de sessieconfiguraties op de lokale computer in.
Syntax
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Deze cmdlet is alleen beschikbaar op het Windows-platform.
De Enable-PSSessionConfiguration
cmdlet maakt geregistreerde sessieconfiguraties mogelijk die zijn uitgeschakeld, bijvoorbeeld met behulp van de Disable-PSSessionConfiguration
cmdlets of Disable-PSRemoting
de parameter AccessMode van Register-PSSessionConfiguration
. Dit is een geavanceerde cmdlet die is ontworpen om te worden gebruikt door systeembeheerders om aangepaste sessieconfiguraties voor hun gebruikers te beheren.
Zonder parameters schakelt Enable-PSSessionConfiguration
u 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 de listener in die aanvragen op een IP-adres accepteert en start de WinRM-service opnieuw. Vanaf PowerShell 3.0 Enable-PSSessionConfiguration
stelt u ook de waarde van de eigenschap Ingeschakeld van de sessieconfiguratie (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled
) in op Waar. Enable-PSSessionConfiguration
Verwijdert of wijzigt echter niet de beveiligingsdescriptorinstelling Network_Deny_All (AccessMode=Local
) waarmee alleen gebruikers van de lokale computer de sessieconfiguratie kunnen gebruiken.
Voorbeelden
Voorbeeld 1: De standaardsessie opnieuw inschakelen
In dit voorbeeld wordt de standaardsessieconfiguratie Microsoft.PowerShell opnieuw ingeschakeld 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
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Geeft aan dat de cmdlet u niet om bevestiging vraagt en de WinRM-service opnieuw start zonder te vragen. Als u de service opnieuw start, wordt de configuratiewijziging van kracht.
Gebruik de parameter NoServiceRestart om opnieuw opstarten te voorkomen en de prompt voor opnieuw opstarten te onderdrukken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de namen van sessieconfiguraties in te schakelen. Voer een of meer configuratienamen in. Jokertekens zijn toegestaan.
U kunt ook een tekenreeks met een configuratienaam of een sessieconfiguratieobject doorspezen naar Enable-PSSessionConfiguration
.
Als u deze parameter weglaat, Enable-PSSessionConfiguration
schakelt u de microsoft.PowerShell-sessieconfiguratie in.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoServiceRestart
Geeft aan dat de cmdlet de service niet opnieuw start.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
Hiermee geeft u een security descriptor op waarmee deze cmdlet de security descriptor in de sessieconfiguratie vervangt.
Als u deze parameter weglaat, Enable-PSSessionConfiguration
wordt alleen het item Alles weigeren uit de beveiligingsdescriptor verwijderd.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 alleen externe toegang toestaat vanaf computers in hetzelfde lokale subnet. Mislukt standaard 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 lokale subnetfirewallregel echter is uitgeschakeld op een serverversie van het Windows-besturingssysteem, schakelt deze parameter deze opnieuw in.
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. Voor meer informatie raadpleegt u Enable-PSRemoting
.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
U kunt een sessieconfiguratieobject of een tekenreeks met de naam van een sessieconfiguratie doorspezen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen objecten.
Notities
Deze cmdlet is alleen beschikbaar op Windows-platforms.
Als u deze cmdlet wilt gebruiken, moet u PowerShell starten met behulp van de optie Als administrator uitvoeren .
Verwante koppelingen
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Provider
- about_Session_Configurations
- about_Session_Configuration_Files