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 voor het beheren van aangepaste sessieconfiguraties voor gebruikers.

Start de WinRM-service opnieuw om de wijziging effectief Unregister-PSSessionConfiguration te maken. Als u het opnieuw opstarten wilt voorkomen, geeft u de parameter NoServiceRestart op.

Als u de standaardconfiguraties Microsoft.PowerShell of Microsoft.PowerShell32 sessieconfiguraties per ongeluk 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: De registratie ongedaan maken zonder opnieuw opstarten

In dit voorbeeld ziet u het effect van het gebruik van de parameter NoServiceRestart om te voorkomen dat een 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

Hiermee Unregister-PSSessionConfiguration verwijdert u de MaintenanceShell sessieconfiguratie. Omdat de opdracht echter gebruikmaakt van de parameter NoServiceRestart , wordt de WinRM-service niet opnieuw opgestart en is de wijziging nog niet volledig effectief.

Vervolgens probeert de Get-PSSessionConfigurationMaintenanceShell sessie op te halen. Omdat de sessie is verwijderd uit de resourcetabel WS-Management, 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.

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 opgestart.

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 dat u hierom wordt gevraagd. Als u de service opnieuw start, wordt de configuratiewijziging effectief.

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 die moeten worden verwijderd. Voer één sessieconfiguratienaam of een configuratienaampatroon in. Jokertekens zijn toegestaan. Deze parameter is vereist.

U kunt ook een sessieconfiguratie doorsluisen 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 de prompt onderdrukt om de service opnieuw op te starten.

Wanneer u een Unregister-PSSessionConfiguration opdracht uitvoert, wordt u standaard gevraagd om de WinRM-service opnieuw te starten om de wijziging effectief te maken. Totdat de WinRM-service opnieuw is opgestart, kunnen gebruikers nog steeds de niet-geregistreerde sessieconfiguratie gebruiken, ook al Get-PSSessionConfiguration is deze niet gevonden.

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

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 doorsluisen 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.