Megosztás a következőn keresztül:

Remove-PSSnapin

  • Referencia
Modul:
Microsoft.PowerShell.Core

Eltávolítja a Windows PowerShell beépülő modulokat az aktuális munkamenetből.

Syntax

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

Description

A Remove-PSSnapin parancsmag eltávolít egy Windows PowerShell beépülő modult az aktuális munkamenetből. Ezzel eltávolíthatja a Windows PowerShellhez hozzáadott beépülő modulokat. Ezzel a parancsmaggal nem távolíthatja el a Windows PowerShell-lel telepített beépülő modulokat.

Miután eltávolított egy beépülő modult az aktuális munkamenetből, a beépülő modul továbbra is betöltődik, de a beépülő modul parancsmagjai és szolgáltatói már nem érhetők el a munkamenetben.

Példák

1. példa: Beépülő modul eltávolítása

Remove-PSSnapin -Name Microsoft.Exchange

Ez a parancs eltávolítja a Microsoft.Exchange beépülő modult az aktuális munkamenetből. Ha a parancs befejeződött, a beépülő modul által támogatott parancsmagok és szolgáltatók nem érhetők el a munkamenetben.

2. példa: Beépülő modulok eltávolítása a folyamat neveinek használatával

Get-PSSnapIn smp* | Remove-PSSnapIn

Ez a parancs eltávolítja azokat a Windows PowerShell beépülő modulokat, amelyek neve smp-vel kezdődik az aktuális munkamenetből.

A parancs a Get-PSSnapin parancsmaggal lekéri a beépülő modulokat ábrázoló objektumokat. A folyamatkezelő (|) elküldi az eredményeket a Remove-PSSnapin parancsmagnak, amely eltávolítja őket a munkamenetből. A beépülő modul által támogatott szolgáltatók és parancsmagok már nem érhetők el a munkamenetben.

Ha objektumokat csövez beRemove-PSSnapin, az objektumok neve a Név paraméterhez lesz társítva, amely a Név tulajdonsággal rendelkező folyamat objektumait fogadja el.

3. példa: Beépülő modulok eltávolítása nevek használatával

Remove-PSSnapin -Name *event*

Ez a parancs eltávolítja az összes Olyan Windows PowerShell-beépülő modult, amely eseményt tartalmazó névvel rendelkezik.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Name

Megadja az aktuális munkamenetből eltávolítandó Windows PowerShell beépülő modulok nevét. A helyettesítő karakterek (*) használata engedélyezett.

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

-PassThru

A beépülő modult jelképező objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

PSSnapInInfo

Ehhez a parancsmaghoz illesztő objektumot is becsúszthat.

Kimenetek

None, System.Management.Automation.PSSnapInInfo

Ez a parancsmag létrehoz egy System.Management.Automation.PSSnapInInfo objektumot, amely a beépülő modult jelöli, ha megadja a PassThru paramétert. Alapértelmezés szerint Remove-PSSnapin nem hoz létre kimenetet.

Jegyzetek

A Windows PowerShell a következő aliasokat Remove-PSSnapintartalmazza:

  • rsnp

Remove-PSSnapin nem ellenőrzi a Windows PowerShell verzióját, mielőtt eltávolítaná a beépülő modult a munkamenetből. Ha egy beépülő modul nem távolítható el, figyelmeztetés jelenik meg, és a parancs meghiúsul.

Remove-PSSnapin csak az aktuális munkamenetre van hatással. Ha hozzáadott egy Add-PSSnapin parancsot a Windows PowerShell-profiljához, törölnie kell a parancsot, hogy eltávolítsa a beépülő modult a későbbi munkamenetekből. Útmutatásért írja be a következőt Get-Help about_Profiles: .