Unregister-PSSessionConfiguration - PowerShell Befehl Hilfe und Beispiele

Löscht eine registrierte Sitzungskonfiguration vom Computer. (Unregister-PSSessionConfiguration)


NAME
Unregister-PSSessionConfiguration
ÜBERSICHT
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 [<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".
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.

Beispiele

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 (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

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016











Windows-10


... Windows 10 FAQ
... Windows 10 How To


Windows 10 How To


... Windows 11 How To
... Windows 10 FAQ



PowerShell: Löscht eine registrierte Sitzungskonfiguration vom Computer.

HTTP: ... PS_Windows/de/Unregister-PSSessionConfiguration.htm
0.124
20107

Auf Windows 11 die individuelle Digital UHR am Desktop!

Disable automatic drive defragmentation in Windows 11, 10, ...!

Create registry entry, automatic login Windows 11, 10, ...!

Unter Windows 11 aus dem Start-Menü als Admin starten!

Change timestamps of folders and files quickly and effectively!

Multiple Page Scan to PDF for all Windows OS!



(0)