Dela via

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 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 standard 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 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 (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 MaintenanceShell bort 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 konfigurationen MaintenanceShell . Kommandot lyckas. Därefter 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 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 till den här cmdleten.

Utdata

None

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