Disable-PSSessionConfiguration

  • Referens
Modul:
Microsoft.PowerShell.Core

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. 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 Disable-PSSessionConfiguration anger cmdleten 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 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 konfigurationen av Microsoft.PowerShell-sessioner .

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 sessionskonfigurationerna MaintenanceShell och AdminShell . 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 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

Kommentar

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 du konfigurationen av Microsoft.PowerShell-sessionen .

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. Det är inte nödvändigt att 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.

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 alternativet Kör som administratör .