Delen via

Unregister-PSSessionConfiguration

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee verwijdert u geregistreerde sessieconfiguraties van de computer.

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Unregister-PSSessionConfiguration cmdlet verwijdert geregistreerde sessieconfiguraties van de computer. Deze cmdlet is ontworpen voor systeembeheerders om aangepaste sessieconfiguraties voor gebruikers te beheren.

Als u de wijziging wilt doorvoeren, Unregister-PSSessionConfiguration start u de WinRM-service opnieuw op. Geef de parameter NoServiceRestart op om het opnieuw opstarten te voorkomen.

Als u per ongeluk de standaard- Microsoft.PowerShell of Microsoft.PowerShell32 sessieconfiguraties verwijdert, gebruikt u de Enable-PSRemoting cmdlet om deze te herstellen. Zie about_Session_Configurations voor meer informatie.

Voorbeelden

Voorbeeld 1: Een sessieconfiguratie verwijderen

In dit voorbeeld wordt de MaintenanceShell sessieconfiguratie van de computer verwijderd.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Voorbeeld 2: Een sessieconfiguratie verwijderen en de WinRM-service opnieuw starten

In dit voorbeeld verwijderen we de MaintenanceShell configuratie en starten we de WinRM-service opnieuw op. De parameter Force onderdrukt alle gebruikersberichten om de WinRM-service opnieuw op te starten zonder te vragen.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Voorbeeld 3: Alle sessieconfiguraties verwijderen

In deze voorbeelden ziet u twee manieren om alle sessieconfiguraties op de computer te verwijderen. Beide opdrachten hebben hetzelfde effect en kunnen door elkaar worden gebruikt.

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

Voorbeeld 4: Registratie ongedaan maken zonder opnieuw opstarten

In dit voorbeeld ziet u het effect van het gebruik van de parameter NoServiceRestart om te voorkomen dat de service opnieuw wordt opgestart waardoor sessies op de computer worden onderbroken.

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

De Unregister-PSSessionConfiguration verwijdert de MaintenanceShell sessieconfiguratie. Omdat de opdracht echter de parameter NoServiceRestart gebruikt, wordt de WinRM-service niet opnieuw gestart en is de wijziging nog niet volledig van kracht.

Vervolgens probeert de Get-PSSessionConfiguration de MaintenanceShell sessie op te halen. Omdat de sessie is verwijderd uit de WS-Management resourcetabel, Get-PSSessionConfiguration kan deze niet worden geretourneerd.

De New-PSSession cmdlet maakt een sessie met behulp van de MaintenanceShell configuratie. De opdracht slaagt. Vervolgens starten we de WinRM-service opnieuw op.

Ten slotte probeert de New-PSSession cmdlet een sessie te maken die gebruikmaakt van de MaintenanceShell configuratie. Deze keer mislukt de sessie omdat de MaintenanceShell configuratie is verwijderd toen de WinRM-service opnieuw werd gestart.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Force

Geeft aan dat de cmdlet u niet om bevestiging vraagt en de WinRM-service opnieuw start zonder te vragen. Als u de service opnieuw start, wordt de configuratiewijziging van kracht.

Gebruik de parameter NoServiceRestart om opnieuw opstarten te voorkomen en de prompt voor opnieuw opstarten te onderdrukken.

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

-Name

Hiermee geeft u de namen van de sessieconfiguraties te verwijderen. Voer één sessieconfiguratienaam of een configuratienaampatroon in. Jokertekens zijn toegestaan. Deze parameter is vereist.

U kunt ook sessieconfiguraties doorsluizen naar Unregister-PSSessionConfiguration.

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

-NoServiceRestart

Geeft aan dat deze cmdlet de WinRM-service niet opnieuw start en onderdrukt de prompt om de service opnieuw te starten.

Wanneer u een Unregister-PSSessionConfiguration opdracht uitvoert, wordt u standaard gevraagd de WinRM-service opnieuw te starten om de wijziging van kracht te laten worden. Totdat de WinRM-service opnieuw wordt gestart, kunnen gebruikers nog steeds de niet-geregistreerde sessieconfiguratie gebruiken, zelfs als Get-PSSessionConfiguration deze niet wordt gevonden.

Als u de WinRM-service opnieuw wilt starten zonder te vragen, geeft u de parameter Force op . Gebruik Restart-Service de cmdlet om de WinRM-service handmatig opnieuw te starten.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

U kunt een sessieconfiguratieobject doorspezen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

Als u deze cmdlet wilt uitvoeren, moet u PowerShell starten met behulp van de optie Als administrator uitvoeren .