Löscht eine registrierte Sitzungskonfiguration vom Computer.
Syntax
Unregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "Unregister-PSSessionConfiguration" löscht registrierte Sitzungskonfiguration vom Computer. Dieses erweiterte Cmdlet wurde für Systemadministratoren entwickelt, die damit benutzerdefinierte Sitzungskonfigurationen für ihre Benutzer verwalten können.
Wenn Sie die Microsoft.PowerShell- oder die Microsoft.PowerShell32-Standardsitzungskonfiguration unbeabsichtigt löschen, verwenden Sie das Cmdlet "Enable-PSRemoting" zur Wiederherstellung.
Parameter
-Force
Unterdrückt alle Benutzeraufforderungen und startet den WinRM-Dienst ohne Aufforderung neu. Durch erneutes Starten des Diensts wird die Konfigurationsänderung wirksam.
Verwenden Sie den NoServiceRestart-Parameter, um einen Neustart zu verhindern und die Aufforderung zum Neustart zu unterdrücken.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string>
Gibt die Namen der zu löschenden Sitzungskonfigurationen an. Geben Sie einen oder mehrere Konfigurationsnamen ein. Platzhalter sind zulässig. Dieser Parameter ist erforderlich.
Sie können auch ein Sitzungskonfigurationsobjekt über die Pipeline an Unregister-PSSessionConfiguration übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-NoServiceRestart
Startet den WinRM-Dienst nicht neu und unterdrückt die Aufforderung zum erneuten Starten des Diensts.
Wenn Sie einen Unregister-PSSessionConfiguration-Befehl eingeben, 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, obwohl sie von Get-PSSessionConfiguration nicht gefunden wird.
Verwenden Sie den Force-Parameter, um den WinRM-Dienst ohne Aufforderung neu zu starten. Verwenden Sie das Cmdlet "Restart-Service", um den WinRM-Dienst manuell neu zu starten.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration Sie können ein Sitzungskonfigurationsobjekt über die Pipeline von Get-PSSessionConfiguration an Unregister-PSSessionConfiguration übergeben. |
|
Ausgaben |
None Dieses Cmdlet gibt keine Objekte zurück. |
Hinweise
Sie müssen Windows PowerShell mit der Option "Als Administrator ausführen" starten, um dieses Cmdlet unter Windows Vista, Windows Server 2008 und höheren Versionen von Windows auszuführen.
Beispiel 1
C:\PS>unregister-pssessionconfiguration -name MaintenanceShell Beschreibung ----------- Mit diesem Befehl wird die MaintenanceShell-Sitzungskonfiguration vom Computer gelöscht.
Beispiel 2
C:\PS>unregister-pssessionconfiguration -maintenanceShell -force Beschreibung ----------- Mit diesem Befehl wird die MaintenanceShell-Sitzungskonfiguration vom Computer gelöscht. Der Befehl verwendet den Force-Parameter, um alle Benutzermeldungen zu unterdrücken und den WinRM-Dienst ohne Aufforderung neu zu starten.
Beispiel 3
C:\PS>unregister-pssessionconfiguration -name * C:\PS> get-pssessionconfiguration -name * | unregister-pssessionconfiguration Beschreibung ----------- Mit diesen Befehlen werden alle Sitzungskonfigurationen auf dem Computer gelöscht. Die Befehle führen zum selben Ergebnis und sind austauschbar.
Beispiel 4
C:\PS>unregister-pssessionconfiguration -name maintenanceShell -noServiceRestart
C:\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
C:\PS> new-pssession -configurationName MaintenanceShell
Id Name ComputerName State Configuration Availability
-- ---- ------------ ----- ------------- ------------
1 Session1 localhost Opened MaintenanceShell Available
C:\PS> restart-service winrm
C:\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 resour
ces, or logical endpoints. For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed
Beschreibung
-----------
In diesem Beispiel wird die Verwendung des NoServiceRestart-Parameters von Unregister-PSSessionConfiguration veranschaulicht. Dieser Parameter ist so konzipiert, dass er einen Dienstneustart verhindert, der alle Sitzungen auf dem Computer unterbrechen würde.
Der erste Befehl verwendet das Cmdlet "Unregister-PSSessionConfiguration", um die MaintenanceShell-Sitzungskonfiguration zu löschen. Da der Befehl den NoServiceRestart-Parameter verwendet, wird der WinRM-Dienst jedoch nicht neu gestartet, und die Änderung ist noch nicht vollständig wirksam.
Im zweiten Befehl wird die MaintenanceShell-Sitzung mit dem Cmdlet "Get-PSSessionConfiguration" abgerufen. Da die Sitzung aus der Ressourcentabelle der WS-Verwaltung entfernt wurde, kann sie von Get-PSSession nicht zurückgegeben werden.
Mit dem dritten Befehl wird das Cmdlet "New-PSSession" verwendet, um eine Sitzung auf dem lokalen Computer zu erstellen, der die MaintenanceShell-Konfiguration verwendet. Der Befehl ist erfolgreich.
Der vierte Befehl startet den WinRM-Dienst mithilfe des Cmdlets "Restart-Service" neu.
Mit dem fünften Befehl wird erneut das Cmdlet "New-PSSession" verwendet, um eine Sitzung zu erstellen, die die MaintenanceShell-Konfiguration verwendet. Dieses Mal tritt ein Sitzungsfehler auf, da die MaintenanceShell-Konfiguration gelöscht wurde.
Siehe auch