Unregister-PSSessionConfiguration

  • Referens
Modul:
Microsoft.PowerShell.Core

Tar bort registrerade sessionskonfigurationer från datorn.

Syntax

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

Description

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.

Om du vill att ändringen ska 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 Microsoft.PowerShell eller Microsoft.PowerShell32 sessionskonfigurationerna 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

I det MaintenanceShell här exemplet tas sessionskonfigurationen bort 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

Sessionskonfigurationen Unregister-PSSessionConfigurationMaintenanceShell tas bort. 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 du hämta MaintenanceShell sessionen. Eftersom sessionen har tagits bort från WS-Management-resurstabellen kan Get-PSSessionConfiguration den inte returneras.

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 cmdleten New-PSSession skapa en session som använder konfigurationen MaintenanceShell . Den här gången misslyckas sessionen eftersom konfigurationen MaintenanceShell 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 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 .

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 effektiv. Tills WinRM-tjänsten har startats om kan användarna fortfarande använda den avregistrerade sessionskonfigurationen, även om Get-PSSessionConfiguration den inte hittas.

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 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 .