Dela via

Enable-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Aktiverar sessionskonfigurationerna på den lokala datorn.

Syntax

Default (Standard) 

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 av cmdletarna Disable-PSSessionConfiguration eller Disable-PSRemoting, eller parametern AccessMode för Register-PSSessionConfiguration. 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 aktiverar Enable-PSSessionConfiguration konfigurationen Microsoft.PowerShell, 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 accepterar 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 True. Men Enable-PSSessionConfiguration tar inte bort eller ändrar Network_Deny_All (AccessMode=Local) säkerhetsbeskrivningsinställning 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 Microsoft.PowerShell standardkonfiguration av sessioner på datorn.

Enable-PSSessionConfiguration

Exempel 2: Återaktivera angivna sessioner

Det här exemplet aktiverar MaintenanceShell och AdminShell sessionskonfigurationer 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 något av dem.

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 sessionskonfiguration och anger en ny säkerhetsbeskrivning 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Anger att cmdleten inte uppmanar dig att bekräfta och startar om WinRM-tjänsten utan att fråga. Om du startar om tjänsten blir konfigurationsändringen effektiv.

Om du vill förhindra en omstart och ignorera omstartsprompten använder du parametern NoServiceRestart.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 för att Enable-PSSessionConfiguration.

Om du utelämnar den här parametern aktiverar Enable-PSSessionConfigurationMicrosoft.PowerShell- sessionskonfiguration.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NoServiceRestart

Anger att cmdleten inte startar om tjänsten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 tar Enable-PSSessionConfiguration bara bort neka alla objekt från säkerhetsbeskrivningen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SkipNetworkProfileCheck

Anger att den här cmdleten aktiverar sessionskonfigurationen när datorn finns 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 misslyckas 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. 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Du kan skicka ett sessionskonfigurationsobjekt till den här cmdleten.

String

Du kan skicka en sträng som innehåller namnet på en sessionskonfiguration till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

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.