Partager via

Remove-PSSnapin

Module:
Microsoft.PowerShell.Core Module

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

Syntaxe

Default (Par défaut) 

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.