Freigeben über

Unregister-PSSessionConfiguration

  • Referenz
Modul:
Microsoft.PowerShell.Core

Löscht registrierte Sitzungskonfigurationen vom Computer.

Syntax

Unregister-PSSessionConfiguration
          [-Name] <String>
          [-Force]
          [-NoServiceRestart]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Beschreibung

Das Unregister-PSSessionConfiguration Cmdlet löscht registrierte Sitzungskonfigurationen vom Computer. Dieses Cmdlet ist für Systemadministratoren konzipiert, um benutzerdefinierte Sitzungskonfigurationen für Benutzer zu verwalten.

Um die Änderung wirksam zu machen, Unregister-PSSessionConfiguration startet der WinRM-Dienst neu. Um den Neustart zu verhindern, geben Sie den Parameter NoServiceRestart an .

Wenn Sie versehentlich die Standardsitzungskonfigurationen Microsoft.PowerShell oder Microsoft.PowerShell32 löschen, verwenden Sie das Enable-PSRemoting Cmdlet, um sie wiederherzustellen. Weitere Informationen finden Sie unter about_Session_Configurations.

Beispiele

Beispiel 1: Löschen einer Sitzungskonfiguration

In diesem Beispiel wird die MaintenanceShell-Sitzungskonfiguration vom Computer gelöscht.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Beispiel 2: Löschen einer Sitzungskonfiguration und Neustarten des WinRM-Diensts

In diesem Beispiel löschen wir die MaintenanceShell-Konfiguration und starten den WinRM-Dienst neu. Der Force-Parameter unterdrückt alle Benutzermeldungen, um den WinRM-Dienst ohne Aufforderung neu zu starten.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Beispiel 3: Löschen aller Sitzungskonfigurationen

In diesem Beispiel werden zwei Möglichkeiten zum Löschen aller Sitzungskonfigurationen auf dem Computer gezeigt. Beide Befehle haben den gleichen Effekt und können austauschbar verwendet werden.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Beispiel 4: Aufheben der Registrierung ohne Neustart

Dieses Beispiel zeigt die Auswirkungen der Verwendung des NoServiceRestart-Parameters , um einen Dienstneustart zu verhindern, der alle Sitzungen auf dem Computer stören würde.

PS> Unregister-PSSessionConfiguration -Name "MaintenanceShell" -NoServiceRestart
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

PS> New-PSSession -ConfigurationName "MaintenanceShell"

Id Name      ComputerName    State    Configuration         Availability
-- ----      ------------    -----    -------------         ------------
1 Session1  localhost       Opened   MaintenanceShell      Available

PS> Restart-Service winrm
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 resources, or logical endpoints.
 For more information, see the about_Remote_Troubleshooting Help topic.
 + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
 + FullyQualifiedErrorId : PSSessionOpenFailed

Die Unregister-PSSessionConfiguration löscht die MaintenanceShell-Sitzungskonfiguration . Da der Befehl jedoch den Parameter NoServiceRestart verwendet, wird der WinRM-Dienst nicht neu gestartet, und die Änderung ist noch nicht vollständig wirksam.

Als Nächstes versucht der Get-PSSessionConfiguration , die MaintenanceShell-Sitzung abzurufen. Da die Sitzung aus der WS-Management Ressourcentabelle entfernt wurde, Get-PSSessionConfiguration kann sie nicht zurückgegeben werden.

Das New-PSSession Cmdlet erstellt eine Sitzung mithilfe der MaintenanceShell-Konfiguration . Der Befehl wird erfolgreich ausgeführt. Als Nächstes starten wir den WinRM-Dienst neu.

Schließlich versucht das New-PSSession Cmdlet, eine Sitzung zu erstellen, die die MaintenanceShell-Konfiguration verwendet. Dieses Mal schlägt die Sitzung fehl, weil die MaintenanceShell-Konfiguration beim Neustart des WinRM-Diensts gelöscht wurde.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Gibt an, dass das Cmdlet Sie nicht zur Bestätigung auffordert und den WinRM-Dienst ohne Aufforderung neu startet. Durch Neustarten des Diensts wird die Konfigurationsänderung übernommen.

Um einen Neustart zu verhindern und die Aufforderung zum Neustart zu unterdrücken, verwenden Sie den NoServiceRestart-Parameter.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt die Namen der zu löschenden Sitzungskonfigurationen an. Geben Sie einen Sitzungskonfigurationsnamen oder ein Konfigurationsnamensmuster ein. Platzhalterzeichen sind zulässig. Dieser Parameter ist erforderlich.

Sie können auch eine Sitzungskonfiguration an übergeben Unregister-PSSessionConfiguration.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Gibt an, dass dieses Cmdlet den WinRM-Dienst nicht neu startet und die Aufforderung zum Neustart des Diensts unterdrückt.

Wenn Sie einen Unregister-PSSessionConfiguration Befehl ausführen, werden Sie standardmäßig aufgefordert, den WinRM-Dienst neu zu starten, um die Änderung wirksam zu machen. Bis der WinRM-Dienst neu gestartet wird, können Benutzer weiterhin die nicht registrierte Sitzungskonfiguration verwenden, obwohl Get-PSSessionConfiguration sie nicht gefunden wird.

Um den WinRM-Dienst ohne Aufforderung neu zu starten, geben Sie den Force-Parameter an. Verwenden Sie Restart-Service das Cmdlet, um den WinRM-Dienst manuell neu zu starten.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Sie können ein Sitzungskonfigurationsobjekt an Get-PSSessionConfiguration dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Objekte zurück.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Zum Ausführen dieses Cmdlets müssen Sie PowerShell mithilfe der Option Als Administrator ausführen starten.