Partager via

Remove-PSSnapin

  • Référence
Module:
Microsoft.PowerShell.Core

Supprime des composants logiciels enfichables Windows PowerShell de la session active.

Syntaxe

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

Description

L’applet Remove-PSSnapin de commande supprime un composant logiciel enfichable Windows PowerShell de la session active. Vous pouvez l’utiliser pour supprimer les composants logiciels enfichables que vous avez ajoutés à Windows PowerShell. Vous ne pouvez pas utiliser cette applet de commande pour supprimer les composants logiciels enfichables installés avec Windows PowerShell.

Après avoir supprimé un composant logiciel enfichable de la session active, le composant logiciel enfichable est toujours chargé, mais les applets de commande et les fournisseurs du composant logiciel enfichable ne sont plus disponibles dans la session.

Exemples

Exemple 1 : Supprimer un composant logiciel enfichable

Remove-PSSnapin -Name Microsoft.Exchange

Cette commande supprime le composant logiciel enfichable Microsoft.Exchange de la session active. Une fois l'exécution de la commande terminée, les applets de commande et les fournisseurs pris en charge par le composant logiciel enfichable ne sont plus disponibles dans la session.

Exemple 2 : Supprimer des composants logiciels enfichables à l’aide de noms avec le pipeline

Get-PSSnapIn smp* | Remove-PSSnapIn

Cette commande supprime les composants logiciels enfichables Windows PowerShell qui ont des noms qui commencent par smp de la session active.

La commande utilise l’applet Get-PSSnapin de commande pour obtenir des objets qui représentent les composants logiciels enfichables. L’opérateur de pipeline (|) envoie les résultats à l’applet Remove-PSSnapin de commande, qui les supprime de la session. Les fournisseurs et les applets de commande pris en charge par ce composant logiciel enfichable ne sont plus disponibles dans la session.

Lorsque vous dirigez des objets vers Remove-PSSnapin, les noms des objets sont associés au paramètre Name , qui accepte les objets du pipeline qui ont une propriété Name .

Exemple 3 : Supprimer des composants logiciels enfichables à l’aide de noms

Remove-PSSnapin -Name *event*

Cette commande supprime tous les composants logiciels enfichables Windows PowerShell qui ont des noms qui incluent l’événement.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie les noms des composants logiciels enfichables Windows PowerShell à supprimer de la session active. Les caractères génériques (*) sont autorisés.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Retourne un objet qui représente le composant logiciel enfichable. Par défaut, cette applet de commande ne génère aucun résultat.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSSnapInInfo

Vous pouvez diriger un objet enfichable vers cette applet de commande.

Sorties

None, System.Management.Automation.PSSnapInInfo

Cette applet de commande génère un objet System.Management.Automation.PSSnapInInfo qui représente le composant logiciel enfichable, si vous spécifiez le paramètre PassThru . Par défaut, Remove-PSSnapin ne génère aucune sortie.

Notes

Windows PowerShell inclut les alias suivants pour Remove-PSSnapin:

  • rsnp

Remove-PSSnapin ne vérifie pas la version de Windows PowerShell avant de supprimer un composant logiciel enfichable de la session. Si un composant logiciel enfichable ne peut pas être supprimé, un avertissement s'affiche avant l'échec de la commande.

Remove-PSSnapin affecte uniquement la session active. Si vous avez ajouté une Add-PSSnapin commande à votre profil Windows PowerShell, vous devez supprimer la commande pour supprimer le composant logiciel enfichable des sessions ultérieures. Pour obtenir des instructions, tapez Get-Help about_Profiles.