Löscht eine registrierte Sitzungskonfiguration vom Computer. (Unregister-PSSessionConfiguration)
NAMEUnregister-PSSessionConfigurationÜBERSICHTLöscht eine registrierte Sitzungskonfiguration vom Computer.SYNTAXUnregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Confirm] [-WhatIf] [<CommonParameters>]BESCHREIBUNGDas 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 [<SwitchParameter>] 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 [<SwitchParameter>] 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 [<SwitchParameter>] Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -WhatIf [<SwitchParameter>] 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 folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENMicrosoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration Sie können ein Sitzungskonfigurationsobjekt über die Pipeline von Get-PSSessionConfiguration an Unregister-PSSessionConfiguration übergeben.AUSGABENKeiner Dieses Cmdlet gibt keine Objekte zurück.HINWEISESie 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.Beispiele
BEISPIEL 1C:\PS>unregister-pssessionconfiguration -name MaintenanceShell Beschreibung ----------- Mit diesem Befehl wird die MaintenanceShell-Sitzungskonfiguration vom Computer gelöscht.BEISPIEL 2C:\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 3C:\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 4C:\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 (http://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. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=144308 (möglicherweise auf Englisch) about_Session_Configurations Disable-PSSessionConfiguration Enable-PSSessionConfiguration Get-PSSessionConfiguration Register-PSSessionConfiguration Set-PSSessionConfiguration WS-Management Provider C:\Windows>powershell get-help Get-PSSessionConfiguration -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
