Remove-PSSnapin

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee verwijdert u Windows PowerShell-modules uit de huidige sessie.

Syntax

Remove-PSSnapin
      [-Name] <String[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Remove-PSSnapin cmdlet verwijdert een Windows PowerShell-module uit de huidige sessie. U kunt deze gebruiken om modules te verwijderen die u hebt toegevoegd aan Windows PowerShell. U kunt deze cmdlet niet gebruiken om de modules te verwijderen die zijn geïnstalleerd met Windows PowerShell.

Nadat u een module uit de huidige sessie hebt verwijderd, wordt de module nog steeds geladen, maar de cmdlets en providers in de module zijn niet meer beschikbaar in de sessie.

Voorbeelden

Voorbeeld 1: Een module verwijderen

Remove-PSSnapin -Name Microsoft.Exchange

Met deze opdracht wordt de Module Microsoft.Exchange verwijderd uit de huidige sessie. Wanneer de opdracht is voltooid, zijn de cmdlets en providers die de ondersteunde module niet beschikbaar zijn in de sessie.

Voorbeeld 2: Modules verwijderen met behulp van namen met de pijplijn

Get-PSSnapIn smp* | Remove-PSSnapIn

Met deze opdracht verwijdert u de Windows PowerShell-modules met namen die beginnen met smp uit de huidige sessie.

De opdracht gebruikt de Get-PSSnapin cmdlet om objecten op te halen die de modules vertegenwoordigen. De pijplijnoperator (|) verzendt de resultaten naar de Remove-PSSnapin cmdlet, waardoor ze uit de sessie worden verwijderd. De providers en cmdlets die door deze module worden ondersteund, zijn niet meer beschikbaar in de sessie.

Wanneer u objecten Remove-PSSnapindoorsluist naar, worden de namen van de objecten gekoppeld aan de parameter Name , die objecten van de pijplijn accepteert die een eigenschap Name hebben.

Voorbeeld 3: Modules verwijderen met behulp van namen

Remove-PSSnapin -Name *event*

Met deze opdracht verwijdert u alle Windows PowerShell-modules met namen die een gebeurtenis bevatten.

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

-Name

Hiermee geeft u de namen van Windows PowerShell-modules op die moeten worden verwijderd uit de huidige sessie. Jokertekens (*) zijn toegestaan.

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

-PassThru

Retourneert een object dat de module vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

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

PSSnapInInfo

U kunt een moduleobject doorsluisen naar deze cmdlet.

Uitvoerwaarden

None, System.Management.Automation.PSSnapInInfo

Met deze cmdlet wordt een System.Management.Automation.PSSnapInInfo-object gegenereerd dat de module vertegenwoordigt, als u de parameter PassThru opgeeft. Remove-PSSnapin Standaard wordt geen uitvoer gegenereerd.

Notities

Windows PowerShell bevat de volgende aliassen voor Remove-PSSnapin:

  • rsnp

Remove-PSSnapin controleert de versie van Windows PowerShell niet voordat u een module uit de sessie verwijdert. Als een module niet kan worden verwijderd, wordt er een waarschuwing weergegeven en mislukt de opdracht.

Remove-PSSnapin is alleen van invloed op de huidige sessie. Als u een Add-PSSnapin opdracht hebt toegevoegd aan uw Windows PowerShell-profiel, moet u de opdracht verwijderen om de module uit toekomstige sessies te verwijderen. Voor instructies typt u Get-Help about_Profiles.