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

Remove-PSSnapin

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Alapértelmezett) 

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

PS C:\> 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

PS C:\> 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 szerzi be a beépülő modulokat képviselő 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.

Amikor objektumokat csövez a Remove-PSSnapin, az objektumok neve a Név paraméterhez lesz társítva, amely a folyamat azon objektumait fogadja el, amelyek Name tulajdonsággal rendelkeznek.

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

PS C:\> 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

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-PassThru

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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

  • 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 Add-PSSnapin parancsot adott hozzá a Windows PowerShell-profiljához, törölje a parancsot a beépülő modul jövőbeli munkamenetekből való eltávolításához. Utasításokért írja be a Get-Help about_Profiles.