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

Syntaxe

Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Confirmer] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Remove-PSSnapin supprime un composant logiciel enfichable Windows PowerShell de la session active. Vous pouvez l'utiliser pour supprimer des composants logiciels enfichables que vous avez ajoutés à Windows PowerShell, mais pas pour supprimer ceux qui sont installés avec Windows PowerShell.

Une fois qu'un composant logiciel enfichable est supprimé de la session active, il est toujours chargé, mais les applets de commande et fournisseurs du composant logiciel enfichable ne sont plus disponibles dans la session.

Paramètres

-Name <string[]>

Spécifie les noms des composants logiciels enfichables Windows PowerShell à supprimer de la session active. Le nom de paramètre (« Name ») est facultatif et les caractères génériques (*) sont autorisés dans la valeur.

Obligatoire ?

true

Position ?

1

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

true

-PassThru

Retourne un objet représentant le composant logiciel enfichable. Par défaut, cette applet de commande ne génère aucune sortie.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Confirmer

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.Management.Automation.PSSnapInInfo

Vous pouvez diriger un objet composant logiciel enfichable vers Remove-PSSnapin.

Sorties

Aucun ou System.Management.Automation.PSSnapInInfo

Par défaut, Remove-PsSnapin ne génère aucune sortie. Toutefois, si vous utilisez le paramètre PassThru, il génère un objet System.Management.Automation.PSSnapInInfo représentant le composant logiciel enfichable.

Remarques

Vous pouvez également faire référence à Remove-PSSnapin en utilisant son alias intégré, « rsnp ». Pour plus d'informations, consultez about_Aliases.

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 apparaît et la commande échoue.

Remove-PSSnapin affecte seulement la session active. Si vous avez ajouté une commande Add-PSSnapin à votre profil Windows PowerShell, vous devez la supprimer pour pouvoir supprimer le composant logiciel enfichable des futures sessions. Pour obtenir les instructions appropriées, consultez about_Profiles.

Exemple 1

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

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






Exemple 2

C:\PS>get-PSSnapIn smp* | remove-PSSnapIn

Description
-----------
Cette commande supprime de la session active les composants logiciels enfichables Windows PowerShell dont les noms commencent par « smp ».

Elle utilise l'applet de commande Get-PSSnapin pour obtenir les objets représentant les composants logiciels enfichables. L'opérateur de pipeline (|) envoie les résultats à l'applet de commande Remove-PSSnapin, laquelle les supprime de la session. Les fournisseurs et applets de commande que ce composant logiciel enfichable prend en charge 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, lequel accepte les objets provenant du pipeline qui ont une propriété Name.






Exemple 3

C:\PS>remove-pssnapin -name *event*

Description
-----------
Cette commande supprime tous les composants logiciels enfichables Windows PowerShell dont les noms incluent « event ». Cette commande spécifie le nom de paramètre « Name », mais le nom de paramètre peut être omis car il est facultatif.






Voir aussi




Table des matières