Feedback

Remove-PSSnapin

  • Referens
Modul:
Microsoft.PowerShell.Core

Tar bort Windows PowerShell snapin-moduler från den aktuella sessionen.

Syntax

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

Description

Cmdleten Remove-PSSnapin tar bort en Windows PowerShell snapin-modul från den aktuella sessionen. Du kan använda den för att ta bort snapin-moduler som du har lagt till i Windows PowerShell Du kan inte använda den här cmdleten för att ta bort de snapin-moduler som är installerade med Windows PowerShell.

När du tar bort en snapin-modul från den aktuella sessionen läses snapin-modulen fortfarande in, men cmdletarna och leverantörerna i snapin-modulen är inte längre tillgängliga i sessionen.

Exempel

Exempel 1: Ta bort en snapin-modul

Remove-PSSnapin -Name Microsoft.Exchange

Det här kommandot tar bort snapin-modulen Microsoft.Exchange från den aktuella sessionen. När kommandot är klart är cmdletarna och leverantörerna som snapin-modulen stöds inte tillgängliga i sessionen.

Exempel 2: Ta bort snapin-moduler med hjälp av namn med pipelinen

Get-PSSnapIn smp* | Remove-PSSnapIn

Det här kommandot tar bort Windows PowerShell snapin-moduler som har namn som börjar med smp från den aktuella sessionen.

Kommandot använder cmdleten Get-PSSnapin för att hämta objekt som representerar snapin-modulerna. Pipelineoperatorn (|) skickar resultatet till cmdleten Remove-PSSnapin , vilket tar bort dem från sessionen. De leverantörer och cmdletar som den här snapin-modulen stöder är inte längre tillgängliga i sessionen.

När du skickar objekt till Remove-PSSnapinassocieras namnen på objekten med parametern Namn , som accepterar objekt från pipelinen som har en namnegenskap .

Exempel 3: Ta bort snapin-moduler med hjälp av namn

Remove-PSSnapin -Name *event*

Det här kommandot tar bort alla Windows PowerShell snapin-moduler som innehåller namn som innehåller händelsen.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Name

Anger namnen på Windows PowerShell snapin-moduler att ta bort från den aktuella sessionen. Jokertecken (*) tillåts.

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

Returnerar ett objekt som representerar snapin-modulen. Som standard genererar denna cmdlet inga utdata.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSSnapInInfo

Du kan skicka ett snapin-objekt till den här cmdleten.

Utdata

None, System.Management.Automation.PSSnapInInfo

Den här cmdleten genererar ett System.Management.Automation.PSSnapInInfo-objekt som representerar snapin-modulen, om du anger parametern PassThru . Som standard Remove-PSSnapin genererar inte några utdata.

Kommentarer

  • Remove-PSSnapinkontrollerar inte versionen av Windows PowerShell innan du tar bort en snapin-modul från sessionen. Om det inte går att ta bort en snapin-modul visas en varning och kommandot misslyckas.
  • Remove-PSSnapin påverkar endast den aktuella sessionen. Om du har lagt till ett Add-PSSnapin kommando i din Windows PowerShell profil bör du ta bort kommandot för att ta bort snapin-modulen från framtida sessioner. Om du vill ha instruktioner skriver du Get-Help about_Profiles.