Remove-PSSnapin
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-PSSnapin
doorsluist 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
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
.
Verwante koppelingen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor