Remove-PSSnapin
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
L’applet de commande 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
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
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
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
Windows PowerShell inclut les alias suivants pour Remove-PSSnapin:
rsnp
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.
