Enable-PSSessionConfiguration
Aktiverar sessionskonfigurationerna på den lokala datorn.
Syntax
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten Enable-PSSessionConfiguration
aktiverar registrerade sessionskonfigurationer som har inaktiverats, till exempel med hjälp Disable-PSSessionConfiguration
av cmdletar eller Disable-PSRemoting
AccessMode-parameternRegister-PSSessionConfiguration
för . Det här är en avancerad cmdlet som är utformad för att användas av systemadministratörer för att hantera anpassade sessionskonfigurationer för användarna.
Utan parametrar Enable-PSSessionConfiguration
aktiverar Microsoft.PowerShell-konfigurationen , vilket är standardkonfigurationen som används för sessioner.
Enable-PSSessionConfiguration
tar bort inställningen Deny_All från säkerhetsbeskrivningen för de berörda sessionskonfigurationerna, aktiverar lyssnaren som tar emot begäranden på alla IP-adresser och startar om WinRM-tjänsten. Från och med PowerShell 3.0 anger Enable-PSSessionConfiguration
även värdet för egenskapen Aktiverad för sessionskonfigurationen (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled
) till Sant. Tar dock Enable-PSSessionConfiguration
inte bort eller ändrar inte inställningen för Network_Deny_All (AccessMode=Local
) säkerhetsbeskrivning som endast tillåter användare av den lokala datorn att använda till sessionskonfigurationen.
Exempel
Exempel 1: Återaktivera standardsessionen
I det här exemplet återaktivering av standardkonfigurationen för Microsoft.PowerShell-sessioner på datorn.
Enable-PSSessionConfiguration
Exempel 2: Återaktivera angivna sessioner
I det här exemplet återaktivering av MaintenanceShell - och AdminShell-sessionskonfigurationerna på datorn.
Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell
Exempel 3: Återaktivera alla sessioner
Det här exemplet aktiverar alla sessionskonfigurationer på datorn igen. Dessa kommandon är likvärdiga. Därför kan du använda båda.
Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration
Enable-PSSessionConfiguration
genererar inget fel om du aktiverar en sessionskonfiguration som redan är aktiverad.
Exempel 4: Återaktivera en session och ange en ny säkerhetsbeskrivning
I det här exemplet återaktiveras MaintenanceShell-sessionskonfigurationen och en ny säkerhetsbeskrivning anges för konfigurationen.
$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
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Anger att cmdleten inte ber dig om bekräftelse och startar om WinRM-tjänsten utan att fråga. Om du startar om tjänsten börjar konfigurationsändringen gälla.
Om du vill förhindra en omstart och ignorera omstartsprompten använder du parametern NoServiceRestart .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Anger namnen på sessionskonfigurationer som ska aktiveras. Ange ett eller flera konfigurationsnamn. Jokertecken tillåts.
Du kan också skicka en sträng som innehåller ett konfigurationsnamn eller ett sessionskonfigurationsobjekt till Enable-PSSessionConfiguration
.
Om du utelämnar den här parametern Enable-PSSessionConfiguration
aktiverar microsoft.PowerShell-sessionskonfigurationen .
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoServiceRestart
Anger att cmdleten inte startar om tjänsten.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
Anger en säkerhetsbeskrivning som denna cmdlet ersätter säkerhetsbeskrivningen med i sessionskonfigurationen.
Om du utelämnar den här parametern Enable-PSSessionConfiguration
tar du bara bort neka alla objekt från säkerhetsbeskrivningen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipNetworkProfileCheck
Anger att denna cmdlet aktiverar sessionskonfigurationen när datorn är i ett offentligt nätverk. Den här parametern aktiverar en brandväggsregel för offentliga nätverk som endast tillåter fjärråtkomst från datorer i samma lokala undernät. Misslyckas som standard Enable-PSSessionConfiguration
i ett offentligt nätverk.
Den här parametern är utformad för klientversioner av Windows-operativsystemet. Serverversioner av Windows-operativsystemet har en brandväggsregel för lokala undernät för offentliga nätverk. Men om brandväggsregeln för det lokala undernätet är inaktiverad på en serverversion av Windows-operativsystemet aktiverar den här parametern den igen.
Om du vill ta bort den lokala undernätsbegränsningen och aktivera fjärråtkomst från alla platser i offentliga nätverk använder du cmdleten Set-NetFirewallRule
i NetSecurity-modulen. Mer information finns i Enable-PSRemoting
.
Den här parametern introducerades i PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
Du kan skicka ett sessionskonfigurationsobjekt eller en sträng som innehåller namnet på en sessionskonfiguration till denna cmdlet.
Utdata
None
Denna cmdlet returnerar inga objekt.
Kommentarer
Den här cmdleten är endast tillgänglig på Windows-plattformar.
Om du vill använda den här cmdleten måste du starta PowerShell med alternativet Kör som administratör .
Relaterade länkar
- 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