Enable-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntax

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í Disable-PSSessionConfiguration rutin nebo Disable-PSRemoting parametru AccessMode .Register-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í ovlivněných konfigurací 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 Neodebere ani 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í výchozí konfiguraci relace Microsoft.PowerShellu v počítači.

Enable-PSSessionConfiguration

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

Tento příklad znovu povolí konfiguraci relace MaintenanceShellu a Správa Shellu v počítači.

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 zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 do Enable-PSSessionConfiguration.

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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í se pouze odepřít všechny položky z popisovače zabezpečení.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 selže ve veřejné síti.

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 na webu Enable-PSRemoting.

Tento parametr byl představen v PowerShellu 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Do této rutiny můžete připojit objekt konfigurace relace.

String

Do této rutiny můžete převést řetězec, který obsahuje název konfigurace relace.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Tato rutina je dostupná jenom na platformách Windows.

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