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 systemadministratörer för att 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 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

I det här exemplet tas konfigurationen för MaintenanceShell-sessionen 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 MaintenanceShell-konfigurationen och startar om WinRM-tjänsten. Force-parametern utelämnar 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

De här exemplen visar två sätt att ta bort alla sessionskonfigurationer på datorn. Båda kommandona har samma effekt och kan användas utbytbart.

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

Tar Unregister-PSSessionConfiguration bort MaintenanceShell-sessionskonfigurationen . Men eftersom kommandot använder parametern NoServiceRestart startas winRM-tjänsten inte 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 mönster för konfigurationsnamn. 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 den här cmdleten 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 oregistrerade sessionskonfigurationen, även om Get-PSSessionConfiguration den inte hittar den.

Om du vill starta om WinRM-tjänsten utan att fråga anger du parametern Force . 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

Den här cmdleten 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 .