Delen via


Remove-PSSnapin

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

Syntaxis

Default (Standaard)

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

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 maakt gebruik van de Get-PSSnapin cmdlet om objecten op te halen die de modules vertegenwoordigen. De pijplijnoperator (|) verzendt de resultaten naar de cmdlet Remove-PSSnapin, waardoor deze 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 naam eigenschap 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

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

-Name

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

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

-PassThru

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

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

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

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