Partager via

Remove-PSSnapin

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

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

Syntaxe

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

Description

La cmdlet Remove-PSSnapin 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

PS C:\> remove-pssnapin -Name Microsoft.Exchange

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

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

PS C:\> 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 de commande Get-PSSnapin pour obtenir des objets qui représentent les composants logiciels enfichables. L’opérateur de pipeline (|) envoie les résultats à l’applet de commande Remove-PSSnapin , 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 Name.

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

PS C:\> 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 invite à confirmer 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 aucune sortie.

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

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

  • 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 et la commande échoue.
  • Remove-PSSnapin affecte uniquement la session active. Si vous avez ajouté une commande Add-PSSnapin à 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.