Dela via

Unregister-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Tar bort registrerade sessionskonfigurationer från datorn.

Syntax

Default (Standard) 

Unregister-PSSessionConfiguration
    [-Name] <String>
    [-Force]
    [-NoServiceRestart]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Unregister-PSSessionConfiguration tar bort registrerade sessionskonfigurationer från datorn. Den här cmdleten är utformad för att systemadministratörer ska kunna hantera anpassade sessionskonfigurationer för användare.

För att göra ändringen effektiv startar Unregister-PSSessionConfiguration om WinRM-tjänsten. Om du vill förhindra omstarten anger du parametern NoServiceRestart.

Om du av misstag tar bort standardkonfigurationerna för Microsoft.PowerShell eller Microsoft.PowerShell32 session använder du cmdleten Enable-PSRemoting för att återställa dem. Mer information finns i about_Session_Configurations.

Exempel

Exempel 1: Ta bort en sessionskonfiguration

Det här exemplet tar bort MaintenanceShell-sessionskonfigurationen från datorn.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Exempel 2: Ta bort en sessionskonfiguration och starta om WinRM-tjänsten

I det här exemplet tar vi bort konfigurationen MaintenanceShell och startar om WinRM-tjänsten. Parametern Force undertrycker alla användarmeddelanden för att starta om WinRM-tjänsten utan att fråga.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Exempel 3: Ta bort alla sessionskonfigurationer

I de här exemplen visas två sätt att ta bort alla sessionskonfigurationer på datorn. Båda kommandona har samma effekt och kan användas omväxlande.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Exempel 4: Avregistrera utan omstart

Det här exemplet visar effekten av att använda parametern NoServiceRestart för att förhindra en omstart av tjänsten som skulle störa alla sessioner på datorn.

PS> Unregister-PSSessionConfiguration -Name "MaintenanceShell" -NoServiceRestart
PS> Get-PSSessionConfiguration -Name "MaintenanceShell"

Get-PSSessionConfiguration -Name MaintenanceShell : No Session Configuration matches criteria "MaintenanceShell".
+ CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

PS> New-PSSession -ConfigurationName "MaintenanceShell"

Id Name      ComputerName    State    Configuration         Availability
-- ----      ------------    -----    -------------         ------------
1 Session1  localhost       Opened   MaintenanceShell      Available

PS> Restart-Service winrm
PS> New-PSSession -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message :
 The WS-Management service cannot process the request.
 The resource URI (http://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog.
 The catalog contains the metadata that describes resources, or logical endpoints.
 For more information, see the about_Remote_Troubleshooting Help topic.
 + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
 + FullyQualifiedErrorId : PSSessionOpenFailed

Unregister-PSSessionConfiguration tar bort MaintenanceShell-sessionskonfigurationen. Men eftersom kommandot använder parametern NoServiceRestart startas inte WinRM-tjänsten om och ändringen är ännu inte helt effektiv.

Därefter försöker Get-PSSessionConfiguration hämta den MaintenanceShell sessionen. Eftersom sessionen har tagits bort från resurstabellen WS-Management kan Get-PSSessionConfiguration inte returnera den.

Cmdleten New-PSSession skapar en session med hjälp av konfigurationen MaintenanceShell. Kommandot lyckas. Sedan startar vi om WinRM-tjänsten.

Slutligen försöker New-PSSession-cmdleten skapa en session som använder MaintenanceShell-konfigurationen. Den här gången misslyckas sessionen eftersom den MaintenanceShell konfigurationen togs bort när WinRM-tjänsten startades om.

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

Anger att cmdleten inte uppmanar dig att bekräfta och startar om WinRM-tjänsten utan att fråga. Om du startar om tjänsten blir konfigurationsändringen effektiv.

Om du vill förhindra en omstart och ignorera omstartsprompten använder du parametern NoServiceRestart.

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 namnen på sessionskonfigurationerna som ska tas bort. Ange ett sessionskonfigurationsnamn eller ett konfigurationsnamnmönster. Jokertecken tillåts. Den här parametern krävs.

Du kan också skicka en sessionskonfiguration till Unregister-PSSessionConfiguration.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NoServiceRestart

Anger att denna cmdlet inte startar om WinRM-tjänsten och undertrycker uppmaningen att starta om tjänsten.

När du kör ett Unregister-PSSessionConfiguration-kommando uppmanas du som standard att starta om WinRM-tjänsten för att göra ändringen effektiv. Tills WinRM-tjänsten har startats om kan användarna fortfarande använda den oregistrerade sessionskonfigurationen, även om Get-PSSessionConfiguration inte hittar den.

Om du vill starta om WinRM-tjänsten utan att fråga anger du parametern Force. Om du vill starta om WinRM-tjänsten manuellt använder du cmdleten Restart-Service.

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.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Om du vill köra den här cmdleten måste du starta PowerShell med hjälp av alternativet Kör som administratör.