Sdílet prostřednictvím

Enable-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntaxe

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

Description

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čilou rutinu, která je navržená tak, aby je správci systému používali 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 rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-NoServiceRestart

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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

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