Remove-PSSnapin

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

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

Syntax

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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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-PSSnapinn’case activée 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.