Delen via

Unregister-PSSessionConfiguration

Module:
Microsoft.PowerShell.Core Module

Hiermee verwijdert u geregistreerde sessieconfiguraties van de computer.

Syntaxis

Default (Standaard) 

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.

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

Als u per ongeluk de standaardconfiguraties voor Microsoft.PowerShell of Microsoft.PowerShell32-sessies verwijdert, gebruikt u de Enable-PSRemoting-cmdlet om deze te herstellen. Zie about_Session_Configurationsvoor 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 Forceren 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

De Unregister-PSSessionConfiguration verwijdert de configuratie van de MaintenanceShell sessie. 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-PSSessionConfiguration de MaintenanceShell sessie op te halen. Omdat de sessie is verwijderd uit de WS-Management resourcetabel, kan Get-PSSessionConfiguration deze niet retourneren.

Met de cmdlet New-PSSession wordt een sessie gemaakt 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

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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 vindt Get-PSSessionConfiguration deze niet.

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 cmdlet Restart-Service.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.