commande install (CLI NuGet)

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

Télécharge et installe un paquet dans un projet, par défaut dans le dossier actuel, en utilisant les sources de package spécifiées.

Conseil

Pour télécharger un package directement en dehors du contexte d’un projet, visitez la page du package sur nuget.org et sélectionnez le lien Télécharger .

Si aucune source n’est spécifiée, toutes les sources répertoriées dans le fichier de configuration global, %appdata%\NuGet\NuGet.Config (Windows) ou ~/.nuget/NuGet/NuGet.Config (Mac/Linux), sont utilisées. Consultez Configurations NuGet courantes pour plus de détails.

Si aucun package n’est spécifié, install installe tous les packages répertoriés dans le fichier packages.config du projet, ce qui le rend similaire à restore.

La commande install ne modifie pas un fichier projet ou packages.config ; en ce sens, elle est similaire à la commande restore dans la mesure où elle ne fait qu'ajouter des packages sur le disque mais ne modifie pas les dépendances d'un projet.

Pour ajouter une dépendance, ajoutez un package via l'interface utilisateur du gestionnaire de package IU ou la console de Visual Studio, ou modifiez packages.config, puis exécutez install ou restore.

Usage

nuget install <packageID | configFilePath> [options]

où <packageID> nomme le package à installer (à l’aide de la dernière version) ou <configFilePath> identifie le fichier packages.config qui répertorie les packages à installer. Vous pouvez indiquer une version spécifique avec l’option -Version .

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

  (4.4+) 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é

• -DirectDownload

  Téléchargez directement sans remplir de caches avec des métadonnées ou des fichiers binaires.

• -DisableParallelProcessing

  Désactive l’installation de plusieurs packages en parallèle.

• -x|-ExcludeVersion

  Installe le package dans un dossier nommé uniquement avec le nom du package et non le numéro de version.

• -FallbackSource

  (3.2+) Liste des sources de package à utiliser en tant que secours si le package n’est pas trouvé dans la source principale ou par défaut.

• -ForceEnglishOutput

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

• -Framework

  (4.4+) Version cible de .Net Framework utilisée pour sélectionner des dépendances. La valeur par défaut est « Aucune » si rien d’autre n’est spécifié.

• -?|-help

  Affiche les informations d’aide pour la commande.

• -NoHttpCache

  Empêche NuGet d’utiliser des packages mis en cache http. Consultez Gestion des packages globaux et des dossiers de cache.

• -NonInteractive

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

• -OutputDirectory

  Spécifie le dossier dans lequel les packages sont installés. Si aucun dossier n’est spécifié, le dossier en cours est utilisé.

• -PackageSaveMode

  Spécifie les types de fichiers à enregistrer après l’installation du package : l'un de nuspec, nupkg, ou nuspec;nupkg.

• -PreRelease

  Permet d'installer les packages de préversion. Cet indicateur n’est pas obligatoire lors de la restauration de packages avec packages.config.

• -RequireConsent

  Vérifie que la restauration des packages est activée avant de télécharger et d’installer les packages. Pour des informations, consultez Restauration de package.

• -SolutionDirectory

  Spécifie le dossier racine de la solution pour laquelle restaurer des packages.

• -Source

  Spécifie la liste des sources de package (en tant qu’URL) à utiliser. 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

  Spécifie la version du package à installer.

Consultez également Variables d’environnement.

Exemples

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj