Partager via


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.

Il s’agit d’une applet de commande proxy pour l’applet Uninstall-PSResource de commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Uninstall-PSResource.

Exemples

Exemple 1 : Désinstaller un module

Cet exemple désinstalle un module.

Uninstall-Module -Name SpeculationControl

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-Module

utilise le paramètre Name pour spécifier le module. L’objet est envoyé vers le bas du pipeline pour Uninstall-Module et est désinstallé.

Paramètres

-AllowPrerelease

Vous permet de désinstaller un module marqué comme préversion.

L’applet de commande proxy mappe ce paramètre au paramètre prerelease de Uninstall-PSResource

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

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 AllVersions avec les paramètresMinimumVersion , MaximumVersionou RequiredVersion.

L’applet de commande proxy transforme ce paramètre -Version * en avant d’appeler Uninstall-PSResource.

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

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 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

-Force

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Uninstall-PSResource.

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

-InputObject

Accepte un objet PSRepositoryItemInfo. Par exemple, sortie Get-InstalledModule à une variable et utiliser cette variable comme argument InputObject.

Propriétés du paramètre

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

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Uninstall-PSResource.

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

NameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MinimumVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Uninstall-PSResource.

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

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 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

NameParameterSet
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-RequiredVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Uninstall-PSResource.

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

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 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

String

PSObject

String

Sorties

Object