Disable-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

Zakáže konfigurace relací v místním počítači.

Syntax

Disable-PSSessionConfiguration
       [[-Name] <String[]>]
       [-Force]
       [-NoServiceRestart]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Disable-PSSessionConfiguration zakáže konfigurace relací v místním počítači, což všem uživatelům zabrání v použití konfigurací relací k vytvoření relací spravovaných uživatelem (PSSessions) v místním počítači. Jedná se o pokročilou rutinu, která je navržená tak, aby ji používali správci systému ke správě přizpůsobených konfigurací relací pro své uživatele.

Počínaje PowerShellem 3.0 rutina Disable-PSSessionConfiguration nastaví nastavení Povoleno konfigurace relace (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) na Hodnotu False.

V PowerShellu 2.0 rutina Disable-PSSessionConfiguration přidá položku Deny_All do popisovače zabezpečení jedné nebo více registrovaných konfigurací relace.

Bez parametrů Disable-PSSessionConfiguration zakáže Microsoft. Konfigurace PowerShellu, výchozí konfigurace používaná pro relace. Pokud uživatel nezadá jinou konfiguraci, místním i vzdáleným uživatelům se v podstatě zabrání ve vytváření relací, které se připojují k počítači.

Pokud chcete zakázat všechny konfigurace relací v počítači, použijte Disable-PSRemoting.

Příklady

Příklad 1: Zakázání výchozí konfigurace

Tento příklad zakáže Microsoft. Konfigurace relace PowerShellu

Disable-PSSessionConfiguration

Příklad 2: Zakázání všech konfigurací registrovaných relací

Tento příklad zakáže všechny konfigurace registrovaných relací v počítači.

Disable-PSSessionConfiguration -Name *

Příklad 3: Zakázání konfigurací relací podle názvu

Tento příklad zakáže všechny konfigurace relací, které mají názvy začínající na Microsoft. Parametr Force potlačí všechny výzvy uživatelů z rutiny.

Disable-PSSessionConfiguration -Name Microsoft* -Force

Příklad 4: Zakázání konfigurací relací pomocí kanálu

Tento příklad zakáže konfigurace relací MaintenanceShellu a AdminShellu . Operátor kanálu (|) odešle výsledky příkazu Get-PSSessionConfiguration do Disable-PSSessionConfiguration.

Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

Příklad 5: Účinky zákazu konfigurace relace

Tento příklad ukazuje oprávnění před spuštěním a po spuštění Disable-PSSessionConfiguration a účinek zakázání konfigurace relace.

PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message : Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed

Poznámka

Zakázáním konfigurace nezabráníte ve změně konfigurace pomocí rutiny Set-PSSessionConfiguration . Brání pouze použití konfigurace.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-Name

Určuje pole názvů konfigurací relací, které se mají zakázat. Zadejte jeden nebo více názvů konfigurace. Zástupné znaky jsou povolené. Můžete také nasměrovat řetězec, který obsahuje název konfigurace nebo objekt konfigurace relace.Disable-PSSessionConfiguration

Pokud tento parametr vynecháte, Disable-PSSessionConfiguration zakáže Microsoft. Konfigurace relace PowerShellu

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

-NoServiceRestart

Slouží k zabránění restartování služby WSMan. Aby se konfigurace zakázala, není nutné službu restartovat.

Type:SwitchParameter
Position:Named
Default value:None
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
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řipojit ř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 spustit tuto rutinu, musíte spustit PowerShell pomocí možnosti Spustit jako správce .