Dela via

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 snapin-modulerna som är installerade med Windows PowerShell.

När du har ta 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 de cmdletar och leverantörer 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-modulerna 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 rör 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 med namn som innehåller händelsen.

Parametrar

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnen på windows PowerShell-snapin-moduler som ska tas bort från den aktuella sessionen. Jokertecken (*) tillåts.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar snapin-modulen. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 inga utdata.

Kommentarer

Windows PowerShell innehåller följande alias för Remove-PSSnapin:

  • rsnp

Remove-PSSnapin kontrollerar 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. För instruktioner skriver du Get-Help about_Profiles.