Unregister-PSSessionConfiguration

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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

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.

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

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

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

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

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.

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.

Du kan skicka ett sessionskonfigurationsobjekt till den här cmdleten.

Den här cmdleten returnerar inga utdata.

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.