Update-Package (Console du Gestionnaire de package dans Visual Studio)

  • Article

Disponible uniquement dans la console du Gestionnaire de package NuGet dans Visual Studio sous Windows.

Mise à jour d’un package et ses dépendances, ou de tous les packages d’un projet, vers une version plus récente.

Syntaxe

Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
    [-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
    [-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]

Dans NuGet 2.8+, Update-Package peut servir pour faire passer un package existant dans votre projet à la version antérieure. Par exemple, si Microsoft.AspNet.MVC 5.1.0-rc1 est installé, la commande suivante permet de passer à une version antérieure, à savoir la version 5.0.0 :

Update-Package Microsoft.AspNet.MVC -Version 5.0.0.

Paramètres

Paramètre Description
ID Identificateur de package à mettre à jour. En cas d’omission, il met à jour tous les packages. Le commutateur -Id proprement dit est facultatif.
IgnoreDependencies Ignore la mise à jour des dépendances du package.
Nom du projet Nom du projet contenant les packages à mettre à jour, par défaut pour tous les projets.
Version Version à utiliser pour la mise à niveau, par défaut vers la dernière version. Dans NuGet 3.0+, la valeur de la version doit être l’une des valeurs les plus basses, valeurs les plus élevées, valeur minimale la plus élevée ou la version de correctif la plus élevée (équivalentes à -Safe).
Safe Limite les mises à niveau vers des versions uniquement avec la même version majeure et mineure que le package actuellement installé.
Source URL ou chemin d’accès au dossier de la source du package à rechercher. Les chemins d’accès aux dossiers locaux peuvent être absolus ou relatifs au dossier actif. En cas d’omission, Update-Package recherche la source du package actuellement sélectionné.
IncludePrerelease Inclut des packages de préversion pour les mises à jour.
Réinstallation Réinstalle les packages en utilisant leurs versions actuellement installées. Consultez Réinstallation et mise à jour des packages.
FileConflictAction Action à entreprendre lorsqu’il est demandé de remplacer ou d’ignorer les fichiers existants référencés par le projet. Les valeurs possibles sont Overwrite (remplacer), Ignore (ignorer), None (néant), OverwriteAll (remplacer tout) et IgnoreAll (ignorer tout) (3.0+).
DependencyVersion Version des packages de dépendances à utiliser, qui peut être l’une des suivantes :
  • Lowest (valeur par défaut) : la version la plus basse
  • HighestPatch : la version avec la majeure la plus basse, la mineure la plus basse et le correctif le plus élevé
  • HighestMinor : la version avec la majeure la plus basse, la mineure la plus élevée et le correctif le plus élevé
  • Highest (valeur par défaut d’Update-Package sans paramètres) : la version la plus élevée
Vous pouvez définir la valeur par défaut à l’aide du réglage dependencyVersion dans le fichier Nuget.Config.
ToHighestPatch Équivaut à -Safe.
ToHighestMinor Limite les mises à niveau vers des versions uniquement avec la même version majeure que le package actuellement installé.
WhatIf Affiche ce qui se passerait lors de l’exécution de la commande sans effectuer réellement la mise à jour.

Aucun de ces paramètres n’accepte d’entrée de pipeline ou de caractères génériques.

Paramètres communs

Update-Package prend en charge les paramètres courants suivants : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable.

Exemples

# Updates all packages in every project of the solution
Update-Package

# Updates every package in the MvcApplication1 project
Update-Package -ProjectName MvcApplication1

# Updates the Elmah package in every project to the latest version
Update-Package Elmah

# Updates the Elmah package to version 1.1.0 in every project showing optional -Id usage
Update-Package -Id Elmah -Version 1.1.0

# Updates the Elmah package within the MvcApplication1 project to the highest "safe" version.
# For example, if Elmah version 1.0.0 of a package is installed, and versions 1.0.1, 1.0.2,
# and 1.1 are available in the feed, the -Safe parameter updates the package to 1.0.2 instead
# of 1.1 as it would otherwise.
Update-Package Elmah -ProjectName MvcApplication1 -Safe

# Reinstall the same version of the original package, but with the latest version of dependencies
# (subject to version constraints). If this command rolls a dependency back to an earlier version,
# use Update-Package <dependency_name> to reinstall that one dependency without affecting the
# dependent package.
Update-Package Elmah –reinstall 

# Reinstall the Elmah package in just MyProject
Update-Package Elmah -ProjectName MyProject -reinstall

# Reinstall the same version of the original package without touching dependencies.
Update-Package Elmah –reinstall -ignoreDependencies