Disable-PSSessionConfiguration

Zakáže konfigurace relací na 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í na místním počítači, což brání všem uživatelům v používání konfigurací relací k vytvoření relací spravovaných uživatelem (PSSessions) na 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 Disable-PSSessionConfiguration rutina nastaví povolené nastavení konfigurace relace (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) na False.

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

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

Chcete-li 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 konfiguraci relace Microsoft.PowerShellu .

Disable-PSSessionConfiguration

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

Tento příklad zakáže všechny registrované konfigurace 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í Microsoft. Parametr Force potlačí všechny výzvy uživatele z rutiny.

Disable-PSSessionConfiguration -Name Microsoft* -Force

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

Tento příklad zakáže konfigurace relace MaintenanceShellu a AdminShellu . Operátor kanálu (|) odešle výsledky operátoru Get-PSSessionConfigurationDisable-PSSessionConfiguration.

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

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

Tento příklad ukazuje oprávnění před spuštěním a po spuštění Disable-PSSessionConfiguration a efektem 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 nedojde ke změně konfigurace pomocí rutiny Set-PSSessionConfiguration . Zabrá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 nutnosti požádat 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. Jsou povoleny zástupné znaky. Můžete také převést řetězec, který obsahuje název konfigurace nebo objekt konfigurace relace do Disable-PSSessionConfiguration.

Pokud tento parametr vynecháte, Disable-PSSessionConfiguration zakážete konfiguraci relace Microsoft.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

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

Výstupy

None

Tato rutina nevrací žádné objekty.

Poznámky

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

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