Unregister-PSSessionConfiguration
Tar bort registrerade sessionskonfigurationer från datorn.
Syntax
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.
Om du vill att ändringen ska börja gälla Unregister-PSSessionConfiguration
startar du 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-sessioner 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 MaintenanceShell-konfigurationen 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 synonymt.
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 (https://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.
Get-PSSessionConfiguration
Därefter försöker hämta MaintenanceShell-sessionen. Eftersom sessionen har tagits bort från WS-Management resurstabell kan Get-PSSessionConfiguration
den inte returneras.
Cmdleten New-PSSession
skapar en session med hjälp av MaintenanceShell-konfigurationen . Kommandot lyckas. Därefter startar vi om WinRM-tjänsten .
Slutligen försöker cmdleten New-PSSession
skapa en session som använder MaintenanceShell-konfigurationen . Den här gången misslyckas sessionen eftersom MaintenanceShell-konfigurationen togs bort när WinRM-tjänsten startades om.
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
Anger att cmdleten inte ber dig om bekräftelse och startar om WinRM-tjänsten utan att fråga. Om du startar om tjänsten börjar konfigurationsändringen gälla.
Om du vill förhindra en omstart och ignorera omstartsprompten använder du parametern NoServiceRestart .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-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 gällande. Tills WinRM-tjänsten har startats om kan användarna fortfarande använda den avregistrerade sessionskonfigurationen, även om Get-PSSessionConfiguration
den inte hittar den.
Om du vill starta om WinRM-tjänsten utan att fråga anger du force-parametern. Om du vill starta om WinRM-tjänsten manuellt använder du cmdleten Restart-Service
.
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 från Get-PSSessionConfiguration
till den här cmdleten.
Utdata
None
Denna cmdlet returnerar inga objekt.
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 .
Relaterade länkar
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan-provider
- about_Session_Configurations
- about_Session_Configuration_Files