commande update (CLI NuGet)

S’applique à : consommation de package • Versions prises en charge : toutes

Mettez à jour tous les packages dans un projet (en utilisant packages.config) avec leurs dernières versions disponibles. Il est recommandé d’exécuter « restauration » avant d’exécuter le update. (Pour mettre à jour un package individuel, utilisez nuget install sans spécifier de numéro de version, auquel cas NuGet installe la dernière version.)

Remarque : update ne fonctionne pas avec la CLI s’exécutant sous Mono (Mac OSX ou Linux) ou lors de l’utilisation du format PackageReference.

La commande update met également à jour les références d’assembly dans le fichier projet, à condition que ces références existent déjà. Si un package mis à jour a un assembly ajouté, une nouvelle référence n’est pas ajoutée. Les nouvelles dépendances de package n’ont pas non plus leurs références d’assembly ajoutées. Pour inclure ces opérations dans le cadre d’une mise à jour, mettez à jour le package dans Visual Studio à l’aide de l’interface utilisateur Gestionnaire de package ou de la console Gestionnaire de package.

Cette commande peut également être utilisée pour mettre à jour nuget.exe lui-même à l’aide de l’indicateur -self.

Usage

nuget update <configPath> [options]

où <configPath> identifie soit un packages.config, soit un fichier de solution qui répertorie les dépendances du projet.

Options

• -ConfigFile

  Fichier de configuration NuGet à appliquer. S’il n’est pas spécifié, %AppData%\NuGet\NuGet.Config (Windows) ou ~/.nuget/NuGet/NuGet.Config, ou ~/.config/NuGet/NuGet.Config (Mac/Linux) est utilisé.

• -DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]

  Spécifie la 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 le correctif principal, le majeur le plus bas, le mineur le plus élevé
  • Highest : la version la plus élevée
  • Ignorer : aucun package de dépendance ne sera utilisé

• -FileConflictAction [PromptUser, Overwrite, Ignore]

  Spécifie l’action par défaut lorsqu’un fichier d’un package existe déjà dans le projet cible. Définissez la valeur sur Overwrite pour toujours remplacer les fichiers. Définissez cette option pour Ignore ignorer les fichiers.

  L’action PromptUser, par défaut, invite chaque fichier en conflit, sauf si OverwriteAllIgnoreAll est fourni, qui s’applique à tous les fichiers restants.

• -ForceEnglishOutput

  (3.5+) Force nuget.exe à s’exécuter avec une culture indifférente basée sur l’anglais.

• -?|-help

  Affiche les informations d’aide pour la commande.

• -Id

  Spécifie une liste d’ID de package à mettre à jour.

• -MSBuildPath

  (4.0+) Spécifie le chemin d’accès de MSBuild à utiliser avec la commande, en ayant la précédence sur -MSBuildVersion.

• -MSBuildVersion

  (3.2+) Spécifie la version de MSBuild à utiliser avec cette commande. Les valeurs prises en charge sont 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Par défaut, MSBuild dans votre chemin d’accès est sélectionné ; sinon, il est défini par défaut sur la version installée la plus élevée de MSBuild.

• -NonInteractive

  Supprime les invites pour l’entrée utilisateur ou les confirmations.

• -PreRelease

  Permet la mise à jour des versions préliminaires. Cet indicateur n’est pas obligatoire lors de la mise à jour des packages de préversion déjà installés.

• -RepositoryPath

  Spécifie le dossier local dans lequel les packages sont installés.

• -Safe

  Spécifie que seules les mises à jour avec la version la plus élevée disponible dans la même version principale et secondaire que le package installé seront installées.

• -Self

  Mets à jour nuget.exe vers la dernière version. -Source peut être utilisé, mais tous les autres arguments sont ignorés. Si aucune source n’est fournie, vérifiez nuget.org pour les mises à jour indépendamment des paramètres NuGet.Config.

• -Source

  Spécifie la liste des sources de package (en tant qu’URL) à utiliser pour les mises à jour. Si elle est omise, la commande utilise les sources fournies dans les fichiers de configuration, consultez configurations NuGet courantes.

• -Verbosity [normal|quiet|detailed]

  Spécifie la quantité de détails affichée dans la sortie : normal (la valeur par défaut), quiet ou detailed.

• -Version

  Lorsqu’il est utilisé avec un ID de package, spécifie la version du package à mettre à jour.

Consultez également Variables d’environnement.

Exemples

nuget update

# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14

nuget update -safe

nuget update -self