Unregister-PSSessionConfiguration
Löscht registrierte Sitzungskonfigurationen vom Computer.
Syntax
Unregister-PSSessionConfiguration
[-Name] <String>
[-Force]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Unregister-PSSessionConfiguration
Cmdlet löscht registrierte Sitzungskonfigurationen vom Computer. Dieses Cmdlet wurde für Systemadministratoren entwickelt, um angepasste Sitzungskonfigurationen für Benutzer zu verwalten.
Um die Änderung wirksam zu machen, Unregister-PSSessionConfiguration
startet den WinRM-Dienst neu. Geben Sie den Parameter NoServiceRestart an, um den Neustart zu verhindern.
Wenn Sie versehentlich die Standard Microsoft.PowerShell
- oder Microsoft.PowerShell32
Sitzungskonfigurationen 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 die gleiche Wirkung und können austauschbar verwendet werden.
Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration
Beispiel 4: Aufheben der Registrierung ohne Neustart
In diesem Beispiel wird gezeigt, wie sich die Verwendung des NoServiceRestart-Parameters auswirkt, um einen Dienstneustart zu verhindern, der alle Sitzungen auf dem Computer unterbrechen 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 (http://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
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 mithilfe der MaintenanceShell
Konfiguration eine Sitzung. 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 Neustarten 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 Konfiguration der nicht registrierten Sitzung verwenden, obwohl Get-PSSessionConfiguration
sie nicht gefunden wird.
Geben Sie den Force-Parameter an, um den WinRM-Dienst ohne Aufforderung neu zu starten. 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 von Get-PSSessionConfiguration
an dieses Cmdlet übergeben.
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.
Ähnliche Themen
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WS-Management-Anbieter
- about_Session_Configurations
- about_Session_Configuration_Files