Unregister-PSSessionConfiguration

Artikel
10/30/2009

Löscht eine registrierte Sitzungskonfiguration vom Computer.

Syntax

Unregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Confirm] [-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

-Confirm

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

Keiner

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

Konzepte

about_Session_Configurations
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
WSMan Provider

Freigeben über