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

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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 .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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

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