Dela via

Enable-PSSessionConfiguration

  • Referens
Modul:
Microsoft.PowerShell.Core

Aktiverar sessionskonfigurationerna på den lokala datorn.

Syntax

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

Description

Cmdleten Enable-PSSessionConfiguration aktiverar registrerade sessionskonfigurationer som har inaktiverats, till exempel med hjälp Disable-PSSessionConfiguration av cmdletar eller Disable-PSRemotingAccessMode-parameternRegister-PSSessionConfigurationför . Detta är en avancerad cmdlet som är utformad för att användas av systemadministratörer för att hantera anpassade sessionskonfigurationer för sina användare.

Utan parametrar Enable-PSSessionConfiguration aktiverar microsoft.PowerShell-konfigurationen , som ä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 accepterar begäranden på alla IP-adresser och startar om WinRM-tjänsten. Från och med PowerShell 3.0 Enable-PSSessionConfiguration anger ä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 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 standardsessionskonfigurationen för Microsoft.PowerShell på datorn.

Enable-PSSessionConfiguration

Exempel 2: Återaktivera angivna sessioner

Det här exemplet återaktivering av Sessionskonfigurationerna MaintenanceShell och AdminShell 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 du 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 den här cmdleten 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 den här cmdleten 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. Som standard Enable-PSSessionConfiguration misslyckas det 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 begränsningen för det lokala undernätet 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 den här cmdleten.

Utdata

None

Den här cmdleten 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 .