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