Disable-PSSessionConfiguration
Inaktiverar sessionskonfigurationer på den lokala datorn.
Syntax
Default (Standard)
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. Detta är en avancerad cmdlet som är utformad för att användas av systemadministratörer för att hantera anpassade sessionskonfigurationer för sina användare.
Från och med PowerShell 3.0 anger cmdleten Disable-PSSessionConfiguration inställningen Aktiverad för sessionskonfigurationen (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) till False.
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 inaktiverar Disable-PSSessionConfigurationMicrosoft.PowerShell- konfiguration, 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- sessionskonfiguration.
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 utelämnar alla användarprompter från cmdleten.
Disable-PSSessionConfiguration -Name Microsoft* -Force
Exempel 4: Inaktivera sessionskonfigurationer med hjälp av pipelinen
Det här exemplet inaktiverar MaintenanceShell- och AdminShell sessionskonfigurationer. Pipelineoperatorn (|) skickar resultatet av en Get-PSSessionConfiguration till 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 av 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
Anmärkning
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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 för att Disable-PSSessionConfiguration.
Om du utelämnar den här parametern inaktiverar Disable-PSSessionConfigurationMicrosoft.PowerShell- sessionskonfiguration.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-NoServiceRestart
Används för att förhindra omstart av WSMan-tjänsten. Det är inte nödvändigt att starta om tjänsten för att inaktivera konfigurationen.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
Du kan skicka ett sessionskonfigurationsobjekt till den här cmdleten.
String
Du kan skicka en sträng som innehåller namnet på en sessionskonfiguration till den här cmdleten.
Utdata
None
Den här cmdleten 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 hjälp av alternativet Kör som administratör.
