Update-Package (Console du Gestionnaire de package dans Visual Studio)
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 :
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