Uninstall-Module
Désinstalle un module.
Syntaxe
NameParameterSet (Par défaut)
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Uninstall-Module désinstalle un module spécifié à partir de l’ordinateur local. Vous ne pouvez pas désinstaller un module si d’autres modules dépendent de celui-ci ou si le module n’a pas été installé avec l’applet Install-Module de commande.
Vous pouvez supprimer manuellement des fichiers de module, mais cela peut interrompre les modules qui dépendent du module supprimé.
Les paramètres qui prennent les numéros de version du module s’attendent à ce que les chaînes mises en forme en tant que numéros de version.
- Les numéros de version standard ont un format où
x.y.zx, y et z sont des nombres - Les versions préliminaires ont un format où
x.y.z-<prerelease_label>la<prerelease_label>chaîne arbitraire affectée à cette version est arbitraire.
Exemples
Exemple 1 : Désinstaller un module
Cet exemple désinstalle un module.
Uninstall-Module -Name SpeculationControl
Exemple 2 : Utiliser le pipeline pour désinstaller un module
Dans cet exemple, le pipeline est utilisé pour désinstaller un module.
Get-InstalledModule -Name SpeculationControl | Uninstall-Module
Uninstall-Module et est désinstallé.
Paramètres
-AllowPrerelease
Vous permet de désinstaller un module marqué comme préversion.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllVersions
Spécifie que vous souhaitez inclure toutes les versions disponibles d’un module. Vous ne pouvez pas utiliser le paramètre
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter le Uninstall-Module.
Propriétés des paramètres
| 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 |
-Force
Force Uninstall-Module à s’exécuter sans demander la confirmation de l’utilisateur.
Propriétés des paramètres
| 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 |
-InputObject
Accepte un objet PSRepositoryItemInfo. Par exemple, sortie Get-InstalledModule à une variable et utiliser cette variable comme argument InputObject.
Propriétés des paramètres
| Type: | PSObject[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MaximumVersion
Spécifie la version maximale ou la plus récente du module à désinstaller. Les paramètres MaximumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MinimumVersion
Spécifie la version minimale du module à désinstaller. Les paramètres MinimumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie un tableau de noms de modules à désinstaller.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RequiredVersion
Spécifie le numéro de version exact du module à désinstaller.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WhatIf
Montre ce qui se passerait si Uninstall-Module s’exécute. L’applet de commande n’est pas exécutée.
Propriétés des paramètres
| 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.
