Disable-PSSessionConfiguration
Inaktiverar sessionskonfigurationer på den lokala datorn.
Syntax
Disable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten Disable-PSSessionConfiguration
inaktiverar sessionskonfigurationer på den lokala datorn, vilket hindrar alla användare från att använda sessionskonfigurationerna för att skapa användarhanterade sessioner (PSSessioner) på den lokala datorn. Det här är en avancerad cmdlet som är utformad för att användas av systemadministratörer för att hantera anpassade sessionskonfigurationer för användarna.
Från och med PowerShell 3.0 Disable-PSSessionConfiguration
anger cmdleten inställningen Aktiverad för sessionskonfigurationen (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled
) till Falskt.
I PowerShell 2.0 lägger cmdleten Disable-PSSessionConfiguration
till en Deny_All post i säkerhetsbeskrivningen för en eller flera registrerade sessionskonfigurationer.
Utan parametrar Disable-PSSessionConfiguration
inaktiveras Microsoft.PowerShell-konfigurationen , standardkonfigurationen som används för sessioner. Om inte användaren anger en annan konfiguration hindras både lokala och fjärranslutna användare från att skapa sessioner som ansluter till datorn.
Om du vill inaktivera alla sessionskonfigurationer på datorn använder du Disable-PSRemoting
.
Exempel
Exempel 1: Inaktivera standardkonfigurationen
Det här exemplet inaktiverar microsoft.PowerShell-sessionskonfigurationen .
Disable-PSSessionConfiguration
Exempel 2: Inaktivera alla registrerade sessionskonfigurationer
Det här exemplet inaktiverar alla registrerade sessionskonfigurationer på datorn.
Disable-PSSessionConfiguration -Name *
Exempel 3: Inaktivera sessionskonfigurationer efter namn
Det här exemplet inaktiverar alla sessionskonfigurationer som har namn som börjar med Microsoft
. Parametern Force undertrycker alla användarfrågor från cmdleten .
Disable-PSSessionConfiguration -Name Microsoft* -Force
Exempel 4: Inaktivera sessionskonfigurationer med hjälp av pipelinen
Det här exemplet inaktiverar sessionskonfigurationerna MaintenanceShell och AdminShell . Pipelineoperatorn (|
) skickar resultatet av till Get-PSSessionConfiguration
Disable-PSSessionConfiguration
.
Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration
Exempel 5: Effekter av att inaktivera en sessionskonfiguration
Det här exemplet visar behörigheterna före och efter körning Disable-PSSessionConfiguration
och effekten av att inaktivera en sessionskonfiguration.
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
Anteckning
Om du inaktiverar konfigurationen kan du inte ändra konfigurationen med hjälp av cmdleten Set-PSSessionConfiguration
. Det förhindrar endast användning av konfigurationen.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Anger en matris med namn på sessionskonfigurationer som ska inaktiveras. Ange ett eller flera konfigurationsnamn. Jokertecken tillåts. Du kan också skicka en sträng som innehåller ett konfigurationsnamn eller ett sessionskonfigurationsobjekt till Disable-PSSessionConfiguration
.
Om du utelämnar den här parametern Disable-PSSessionConfiguration
inaktiverar microsoft.PowerShell-sessionskonfigurationen .
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoServiceRestart
Används för att förhindra omstart av WSMan-tjänsten. Du behöver inte starta om tjänsten för att inaktivera konfigurationen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
Du kan skicka ett sessionskonfigurationsobjekt till den här cmdleten.
Du kan skicka en sträng som innehåller namnet på en sessionskonfiguration till denna cmdlet.
Utdata
None
Denna cmdlet returnerar inga utdata.
Kommentarer
Den här cmdleten är endast tillgänglig på Windows-plattformar.
Om du vill köra den här cmdleten måste du starta PowerShell med alternativet Kör som administratör .