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.

# 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

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.

OS: Windows 10, 8.1, 8, 7, Vista / Windows Server 2016, 2012, 2008
»»»» ColorConsole





... Home  
... Impressum
... ColorConsole

... CMD
... Netsh-XP
... Netsh-7
... Netsh-Vista
... Powershell










Windows 10 download: Starter, Home (Basic Premium), Professional und Win 10 Ultimate!

... facebook.de
HTTP: ... PS_Windows/de/Unregister-PSSessionConfiguration.htm
0.077

Bin bei Facebook.de Mitglied und ich frage mich, ob meine Privatsphäre bei Facebook.de gewährleistet ist?

 /

Vista Fehlermeldung bei gesperrten Ordner "Connection error"!

 /

Das 7-zip Kontextmenü geht nicht in Q-Dir unter Win Vista x64

 /

Where is the auto startup folder in Windows 8.1, or 8?

 /