Partager via

Uninstall-Package

  • Référence
Module:
PackageManagement

Désinstalle un ou plusieurs packages logiciels.

Syntax

Uninstall-Package
         [-InputObject] <SoftwareIdentity[]>
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Package
         [-Name] <String[]>
         [-RequiredVersion <String>]
         [-MinimumVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-ProviderName <String[]>]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]

Description

L’applet Uninstall-Package de commande désinstalle un ou plusieurs packages logiciels de l’ordinateur local. Pour rechercher les packages installés, utilisez l’applet de Get-Package commande .

Important

Les commandes contenues dans le module PackageManagement sont différentes des commandes fournies par le module NuGet dans la console du Gestionnaire de package de Visual Studio. Chaque module a des commandes qui ne sont pas disponibles dans l’autre. Les commandes portant le même nom diffèrent par leurs arguments spécifiques. Pour plus d’informations, consultez la documentation de référence PowerShell pour la console du Gestionnaire de package de Visual Studio.

Exemples

Exemple 1 : Désinstaller un package

L’applet Uninstall-Package de commande désinstalle les packages. Le paramètre Name spécifie le package à désinstaller. Si plusieurs versions d’un package sont installées, la version la plus récente est désinstallée.

PS> Uninstall-Package -Name NuGet.Core

Exemple 2 : Utiliser le pipeline pour désinstaller un package

Get-Package localise un package spécifique et envoie l’objet SoftwareIdentity dans le pipeline à l’applet de Uninstall-Package commande .

PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package

L’applet Get-Package de commande utilise les paramètres Name et RequiredVersion pour spécifier un package. Un objet SoftwareIdentity est envoyé dans le pipeline. L’applet Uninstall-Package de commande reçoit l’objet en tant qu’objet InputObject et supprime le package.

L’applet Uninstall-Package de commande peut également spécifier une valeur pour le paramètre InputObject :

Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )

Paramètres

-AllowClobber

Remplace les messages d’avertissement concernant les conflits avec les commandes existantes. Remplace les commandes existantes qui portent le même nom que les commandes en cours d’installation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrereleaseVersions

Autorise la désinstallation des packages marqués comme préversion.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Indique que cette applet de commande désinstalle toutes les versions du package.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Spécifie une chaîne du chemin d’accès à l’objet d’entrée.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeVersion

Basculez pour exclure le numéro de version dans le chemin du dossier.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceBootstrap

Force PackageManagement à installer automatiquement le fournisseur de package pour le package spécifié.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Accepte l’entrée de pipeline qui spécifie l’objet SoftwareIdentity du package à partir de l’applet Get-Package de commande . InputObject accepte l’objet SoftwareIdentity en tant que Get-Package valeur ou variable qui contient l’objet .

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstallUpdate

Indique que Uninstall-Package désinstalle les mises à jour.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Spécifie la version maximale autorisée du package que vous souhaitez désinstaller. Si vous ne spécifiez pas ce paramètre, Uninstall-Package désinstalle la version la plus récente du package.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Spécifie la version minimale autorisée du package que vous souhaitez désinstaller. Si vous n’ajoutez pas ce paramètre, Uninstall-Package désinstalle la version la plus récente du package qui satisfait à toute version spécifiée par le paramètre MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie un ou plusieurs noms de package. Plusieurs noms de package doivent être séparés par des virgules.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoPathUpdate

NoPathUpdate s’applique uniquement à l’applet de Install-Script commande. NoPathUpdate est un paramètre dynamique ajouté par le fournisseur et n’est pas pris en charge par Uninstall-Package.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

Spécifie le fournisseur PackageManagement .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProviderName

Spécifie un ou plusieurs noms de fournisseurs de packages à rechercher. Vous obtenez les noms des fournisseurs de package en exécutant l’applet de commande Get-PackageProvider.

Type:String[]
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Spécifie la version exacte autorisée du package que vous souhaitez désinstaller. Si vous n’ajoutez pas ce paramètre, Uninstall-Package désinstalle la version la plus récente du package qui satisfait à toute version spécifiée par le paramètre MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Spécifie l’étendue pour laquelle désinstaller le package. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Utilisateur en cours
  • AllUsers
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencies

Ignore la désinstallation des dépendances logicielles.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipPublisherCheck

Vous permet d’obtenir une version de package plus récente que la version installée. Par exemple, un package installé signé numériquement par un éditeur approuvé, mais une nouvelle version n’est pas signée numériquement.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Spécifie s’il faut rechercher des packages avec un module, un script ou les deux. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Module
  • Script
  • Tous
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Affiche ce qui se passerait si Uninstall-Package l’applet de commande est exécutée. 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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Vous pouvez diriger des objets SoftwareIdentity vers cette applet de commande.

Sorties

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Cette applet de commande renvoie un objet SoftwareIdentity pour chaque package désinstallé.

Notes

L’inclusion d’un fournisseur de package dans une commande peut rendre des paramètres dynamiques disponibles pour une applet de commande. Les paramètres dynamiques sont spécifiques à un fournisseur de package. L’applet Get-Help de commande répertorie les jeux de paramètres d’une applet de commande et inclut l’ensemble de paramètres du fournisseur. Par exemple, Uninstall-Package a le paramètre PowerShellGet défini qui inclut -NoPathUpdate, AllowClobberet SkipPublisherCheck.