Sdílet prostřednictvím

Enable-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Povolí konfigurace relací na místním počítači.

Syntax

Default (Výchozí) 

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Enable-PSSessionConfiguration umožňuje registrované konfigurace relací, které byly zakázány, například pomocí rutin Disable-PSSessionConfiguration nebo Disable-PSRemoting nebo parametru AccessModeRegister-PSSessionConfiguration. Jedná se o pokročilý cmdlet navržený pro správce systému ke správě přizpůsobených konfigurací relací pro své uživatele.

Bez parametrů Enable-PSSessionConfiguration povolí konfiguraci Microsoft.PowerShellu, což je výchozí konfigurace, která se používá pro relace.

Enable-PSSessionConfiguration odebere nastavení Deny_All z popisovače zabezpečení konfigurace ovlivněné relace, zapne naslouchací proces, který přijímá požadavky na libovolnou IP adresu, a restartuje službu WinRM. Počínaje PowerShellem 3.0 Enable-PSSessionConfiguration také nastaví hodnotu vlastnosti Enabled konfigurace relace (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) na Hodnotu True. Enable-PSSessionConfiguration ale neodebere nebo nezmění nastavení popisovače zabezpečení Network_Deny_All (AccessMode=Local), které umožňuje použití konfigurace relace pouze uživatelům místního počítače.

Příklady

Příklad 1: Opětovné povolení výchozí relace

Tento příklad znovu povolí Microsoft.PowerShell výchozí konfiguraci relace v počítači.

Enable-PSSessionConfiguration

Příklad 2: Opětovné povolení zadaných relací

V tomto příkladu se znovu povolí konfigurace relace MaintenanceShellu a AdminShellu.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Příklad 3: Opětovné povolení všech relací

Tento příklad znovu povolí všechny konfigurace relací v počítači. Tyto příkazy jsou ekvivalentní. Proto můžete použít jednu z těchto akcí.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration negeneruje chybu, pokud povolíte konfiguraci relace, která je již povolená.

Příklad 4: Opětovné povolení relace a zadání nového popisovače zabezpečení

Tento příklad znovu povolí konfiguraci relace MaintenanceShellu a určí nový popisovač zabezpečení pro konfiguraci.

$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

Parametry

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Force

Označuje, že rutina nezobrazí výzvu k potvrzení a restartuje službu WinRM bez výzvy. Restartováním služby se změna konfigurace projeví.

Pokud chcete zabránit restartování a potlačit výzvu k restartování, použijte parametr NoServiceRestart.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Určuje názvy konfigurací relací, které se mají povolit. Zadejte jeden nebo více názvů konfigurací. Jsou povoleny zástupné znaky.

Můžete také převést řetězec, který obsahuje název konfigurace nebo objekt konfigurace relace Enable-PSSessionConfiguration.

Pokud tento parametr vynecháte, Enable-PSSessionConfiguration povolí konfiguraci relace Microsoft.PowerShellu.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-NoServiceRestart

Označuje, že rutina službu nerestartuje.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SecurityDescriptorSddl

Určuje popisovač zabezpečení, kterým tato rutina nahradí popisovač zabezpečení v konfiguraci relace.

Pokud tento parametr vynecháte, Enable-PSSessionConfiguration odstraní pouze odepřít všechny položky z popisovače zabezpečení.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SkipNetworkProfileCheck

Označuje, že tato rutina povolí konfiguraci relace, když je počítač ve veřejné síti. Tento parametr povolí pravidlo brány firewall pro veřejné sítě, které povolí vzdálený přístup jenom z počítačů ve stejné místní podsíti. Ve výchozím nastavení Enable-PSSessionConfiguration ve veřejné síti selže.

Tento parametr je určený pro klientské verze operačního systému Windows. Verze operačního systému Windows mají pravidlo brány firewall místní podsítě pro veřejné sítě. Pokud je však pravidlo brány firewall místní podsítě zakázané na serverové verzi operačního systému Windows, tento parametr ho znovu povolí.

Pokud chcete odebrat omezení místní podsítě a povolit vzdálený přístup ze všech umístění ve veřejných sítích, použijte rutinu Set-NetFirewallRule v modulu NetSecurity. Další informace najdete v tématu Enable-PSRemoting.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Objekt konfigurace relace nebo řetězec, který obsahuje název konfigurace relace, můžete připojit k této rutině.

Výstupy

None

Tato rutina nevrací žádné objekty.

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.

Pokud chcete tuto rutinu použít, musíte PowerShell spustit pomocí možnosti Spustit jako správce.