Sdílet prostřednictvím

Disable-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntaxe

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

Description

Rutina Disable-PSSessionConfiguration zakáže konfigurace relací v místním počítači, což brání všem uživatelům v používání konfigurací relace 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 je správci systému používali ke správě přizpůsobených konfigurací relací pro své uživatele.

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

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

Bez parametrů Disable-PSSessionConfiguration zakáže konfiguraci Microsoft.PowerShellu, výchozí konfigurace použitá pro relace. Pokud uživatel neurčí jinou konfiguraci, nebudou místní i vzdálení uživatelé efektivně znemožnění vytvářet jakékoli relace, 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í Společností 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 Get-PSSessionConfiguration do Disable-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 a po spuštění Disable-PSSessionConfiguration a vliv 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 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

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

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 pole názvů konfigurací relací, které se mají zakázat. 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 Disable-PSSessionConfiguration.

Pokud tento parametr vynecháte, Disable-PSSessionConfiguration zakáže 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

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

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 spustit, musíte spustit PowerShell pomocí možnosti Spustit jako správce.