Uninstall-Module
Désinstalle un module.
Syntax
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
L’applet Uninstall-Module de commande désinstalle un module spécifié de l’ordinateur local. Vous ne pouvez pas désinstaller un module si d’autres modules en dépendent ou si le module n’a pas été installé avec l’applet de Install-Module commande.
Vous pouvez supprimer manuellement des fichiers de module, mais cela peut interrompre tous les modules qui dépendent du module supprimé.
Les paramètres qui prennent des numéros de version de module attendent des chaînes mises en forme en tant que numéros de version.
- Les numéros de version standard ont un format où x, y et z sont des
x.y.znombres - Les versions préliminaires ont un format de
x.y.z-<prerelease_label>où est<prerelease_label>la chaîne arbitraire affectée à cette version.
Exemples
Exemple 1 : Désinstaller un module
Cet exemple désinstalle un module.
Uninstall-Module -Name SpeculationControlUninstall-Module utilise le paramètre Name pour spécifier le module à désinstaller de l’ordinateur local.
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-ModuleGet-InstalledModule utilise le paramètre Name pour spécifier le module. L’objet est envoyé dans le pipeline vers Uninstall-Module et est désinstallé.
Paramètres
-AllowPrerelease
Vous permet de désinstaller un module marqué en tant que préversion.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Spécifie que vous souhaitez inclure toutes les versions disponibles d’un module. Vous ne pouvez pas utiliser le paramètre AllVersions avec les paramètres MinimumVersion, MaximumVersion ou RequiredVersion .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Vous invite à confirmer avant d’exécuter .Uninstall-Module
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Force Uninstall-Module l’exécution sans demander la confirmation de l’utilisateur.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Accepte un objet PSRepositoryItemInfo . Par exemple, sortez Get-InstalledModule vers une variable et utilisez cette variable comme argument InputObject .
| Type: | PSObject[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Spécifie un tableau de noms de modules à désinstaller.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
Spécifie le numéro de version exact du module à désinstaller.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Affiche ce qui se produirait en cas Uninstall-Module d’exécution. 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
String[]
PSObject[]
