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í na 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 Disable-PSSessionConfiguration nastaví rutina nastavení Povoleno konfigurace relace (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) na False.

V PowerShellu 2.0 Disable-PSSessionConfiguration přidá rutina 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 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 relace, 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 Správa Shellu. 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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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ů konfigurací. 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áže konfiguraci relace Microsoft.PowerShellu .

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

-NoServiceRestart

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

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.

Chcete-li spustit tuto rutinu , musíte spustit PowerShell pomocí možnosti Spustit jako správce .