Freigeben über

Unregister-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Löscht registrierte Sitzungskonfigurationen vom Computer.

Syntax

Default (Standard) 

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

Beschreibung

Das Cmdlet Unregister-PSSessionConfiguration löscht registrierte Sitzungskonfigurationen vom Computer. Dieses Cmdlet wurde für Systemadministratoren entwickelt, um angepasste Sitzungskonfigurationen für Benutzer zu verwalten.

Damit die Änderung wirksam wird, Unregister-PSSessionConfiguration wird der WinRM-Dienst neu gestartet. Um den Neustart zu verhindern, geben Sie den parameter NoServiceRestart an.

Wenn Sie versehentlich die standardmäßigen Microsoft.PowerShell - oder Microsoft.PowerShell32-Sitzungskonfigurationen löschen, verwenden Sie das Enable-PSRemoting Cmdlet, um sie wiederherzustellen. Weitere Informationen finden Sie unter about_Session_Configurations.

Beispiele

Beispiel 1: Löschen einer Sitzungskonfiguration

In diesem Beispiel wird die MaintenanceShell-Sitzungskonfiguration vom Computer gelöscht.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Beispiel 2: Löschen einer Sitzungskonfiguration und Neustart des WinRM-Diensts

In diesem Beispiel löschen wir die MaintenanceShell-Konfiguration und starten den WinRM-Dienst neu. Der Force-Parameter unterdrückt alle Benutzermeldungen, um den WinRM-Dienst ohne Eingabeaufforderung neu zu starten.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Beispiel 3: Löschen aller Sitzungskonfigurationen

In diesen Beispielen werden zwei Möglichkeiten zum Löschen aller Sitzungskonfigurationen auf dem Computer gezeigt. Beide Befehle haben denselben Effekt und können austauschbar verwendet werden.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Beispiel 4: Aufheben der Registrierung ohne Neustart

Dieses Beispiel zeigt die Auswirkung der Verwendung des NoServiceRestart-Parameters, um einen Dienstneustart zu verhindern, der alle Sitzungen auf dem Computer stören würde.

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

Dadurch Unregister-PSSessionConfiguration wird die MaintenanceShell-Sitzungskonfiguration gelöscht. Da der Befehl jedoch den NoServiceRestart-Parameter verwendet, wird der WinRM-Dienst nicht neu gestartet, und die Änderung ist noch nicht vollständig wirksam.

Als Nächstes wird versucht Get-PSSessionConfiguration , die MaintenanceShell-Sitzung abzurufen. Da die Sitzung aus der WS-Management Ressourcentabelle entfernt wurde, kann Get-PSSessionConfiguration sie nicht zurückgeben.

Das New-PSSession Cmdlet erstellt eine Sitzung mit der MaintenanceShell-Konfiguration . Der Befehl ist erfolgreich. Als Nächstes starten wir den WinRM-Dienst neu.

Schließlich versucht das New-PSSession Cmdlet, eine Sitzung zu erstellen, die die MaintenanceShell-Konfiguration verwendet. Dieses Mal schlägt die Sitzung fehl, da die MaintenanceShell-Konfiguration beim Neustart des WinRM-Diensts gelöscht wurde.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Gibt an, dass das Cmdlet Sie nicht zur Bestätigung auffordert und den WinRM-Dienst ohne Eingabeaufforderung neu startet. Durch den Neustart des Diensts wird die Konfigurationsänderung wirksam.

Um einen Neustart zu verhindern und die Neustartaufforderung zu unterdrücken, verwenden Sie den Parameter NoServiceRestart.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt die Namen der zu löschenden Sitzungskonfigurationen an. Geben Sie einen Sitzungskonfigurationsnamen oder ein Konfigurationsnamenmuster ein. Platzhalterzeichen sind zulässig. Dieser Parameter ist erforderlich.

Sie können auch eine Sitzungskonfiguration an Unregister-PSSessionConfigurationübergeben.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-NoServiceRestart

Gibt an, dass dieses Cmdlet den WinRM-Dienst nicht neu startet und die Eingabeaufforderung zum Neustart des Diensts unterdrückt.

Wenn Sie einen Unregister-PSSessionConfiguration Befehl ausführen, werden Sie standardmäßig aufgefordert, den WinRM-Dienst neu zu starten, damit die Änderung wirksam wird. Bis zum Neustart des WinRM-Diensts können Benutzer weiterhin die nicht registrierte Sitzungskonfiguration verwenden, auch wenn Get-PSSessionConfiguration sie nicht gefunden wird.

Um den WinRM- Dienst ohne Aufforderung neu zu starten, geben Sie den Parameter Force an. Um den WinRM- Dienst manuell neu zu starten, verwenden Sie das cmdlet Restart-Service.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Sie können ein Sitzungskonfigurationsobjekt über die Pipeline an Get-PSSessionConfiguration dieses Cmdlet übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Objekte zurück.

Hinweise

Zum Ausführen dieses Cmdlets müssen Sie PowerShell mithilfe der Option Als Administrator ausführen starten.