Enable-PSSessionConfiguration
Hiermee schakelt u de sessieconfiguraties op de lokale computer in.
Syntax
Default (Standaard)
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Deze cmdlet is alleen beschikbaar op het Windows-platform.
Met Enable-PSSessionConfiguration de cmdlet worden geregistreerde sessieconfiguraties ingeschakeld 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 in. PowerShell configuratie, 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 accepteert op een IP-adres en start de WinRM-service opnieuw. Vanaf PowerShell 3.0 Enable-PSSessionConfiguration wordt ook de waarde van de eigenschap Ingeschakeld van de sessieconfiguratie (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) ingesteld 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 opnieuw ingeschakeld. PowerShell standaardsessieconfiguratie op de computer.
Enable-PSSessionConfiguration
Voorbeeld 2: Opgegeven sessies opnieuw inschakelen
In dit voorbeeld worden de onderhoudsshell - en AdminShell-sessieconfiguraties opnieuw ingeschakeld op de computer.
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
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 in. PowerShell sessieconfiguratie.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-NoServiceRestart
Geeft aan dat de cmdlet de service niet opnieuw start.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-SecurityDescriptorSddl
Hiermee geeft u een beveiligingsdescriptor op waarmee deze cmdlet de beveiligingsdescriptor voor de sessieconfiguratie vervangt.
Als u deze parameter weglaat, Enable-PSSessionConfiguration verwijdert u alleen het item weigeren uit de beveiligingsdescriptor.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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. Mislukt standaard Enable-PSSessionConfiguration in 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 wilt inschakelen vanaf alle locaties in openbare netwerken, gebruikt u de Set-NetFirewallRule cmdlet in de NetSecurity-module. Zie Enable-PSRemoting voor meer informatie.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
U kunt een sessieconfiguratieobject doorsluisen naar deze cmdlet.
String
U kunt een tekenreeks met de naam van een sessieconfiguratie doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
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
- Schakel-PSSessieConfiguratie uit
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Testen-PSSessieConfiguratiebestand
- Unregister-PSSessionConfiguration
- WSMan-provider
- about_Session_Configurations
- over_Sessie_Configuratie_Bestanden