Delen via

Remove-PSSnapin

  • Referentie
Module:
Microsoft.PowerShell.Core

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

Syntaxis

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

Description

De cmdlet Remove-PSSnapin 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

PS C:\> remove-pssnapin -Name Microsoft.Exchange

Met deze opdracht verwijdert u de module Microsoft.Exchange 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

PS C:\> 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 cmdlet Get-PSSnapin 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 doorsluist naar Remove-PSSnapin-, worden de namen van de objecten gekoppeld aan de parameter Name, die objecten uit de pijplijn accepteert die een eigenschap Name hebben.

Voorbeeld 3: Modules verwijderen met behulp van namen

PS C:\> Remove-PSSnapin -Name *event*

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

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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. Standaard genereert Remove-PSSnapin- geen uitvoer.

Notities

  • 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. Typ Get-Help about_Profilesvoor instructies.