Disable-PSSessionConfiguration
Zakáže konfigurace relací v místním počítači.
Syntax
Default (Výchozí)
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ž 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čilý cmdlet navržený pro správce systému 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 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 |) 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 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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 .
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-NoServiceRestart
Slouží k zabránění restartování služby WSMan. Není nutné restartovat službu, aby se konfigurace zakázala.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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
Tento cmdlet je dostupný pouze na platformách Windows.
Pokud chcete tuto rutinu spustit, musíte spustit PowerShell pomocí možnosti Spustit jako správce.