Référence CLI de NuGetNuGet CLI reference

L’Interface de ligne de commande (interface CLI NuGet), nuget.exe, fournit l’étendue complète de fonctionnalités de NuGet pour installer, créer, publier et gérer les packages sans apporter de modifications aux fichiers de projet.The NuGet Command Line Interface (CLI), nuget.exe, provides the full extent of NuGet functionality to install, create, publish, and manage packages without making any changes to project files.

Pour utiliser n’importe quelle commande, ouvrez une fenêtre de commande ou interpréteur de commandes bash, puis exécutez nuget suivie de la commande et les options appropriées, tel que nuget help pack (pour afficher l’aide sur la commande pack).To use any command, open a command window or bash shell, then run nuget followed by the command and appropriate options, such as nuget help pack (to view help on the pack command).

Cette documentation reflète la dernière version de la CLI de NuGet.This documentation reflects the latest version of the NuGet CLI. Pour obtenir des détails précis pour une version donnée que vous utilisez, exécutez nuget help pour la commande souhaitée.For exact details for any given version that you're using, run nuget help for the desired command.

L’installation de nuget.exeInstalling nuget.exe

WindowsWindows

Notes

NuGet.exe 5.0 et les versions ultérieures exigent .NET Framework 4.7.2 ou une version ultérieure pour s’exécuter.NuGet.exe 5.0 and later require .NET Framework 4.7.2 or later to execute.

  1. Visitez nuget.org/downloads et sélectionnez NuGet 3.3 ou une version ultérieure (2.8.6 n’est pas compatible avec Mono).Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). La version la plus récente est toujours recommandée, et 4.1.0 ou une version ultérieure est requise pour publier des packages sur nuget.org.The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Chaque téléchargement est le fichier nuget.exe directement.Each download is the nuget.exe file directly. Demandez à votre navigateur d’enregistrer le fichier dans un dossier de votre choix.Instruct your browser to save the file to a folder of your choice. Le fichier n’est pas un programme d’installation ; vous ne verrez rien si vous l’exécutez directement à partir du navigateur.The file is not an installer; you won't see anything if you run it directly from the browser.
  3. Ajouter le dossier où vous avez placé nuget.exe à votre variable d’environnement PATH pour utiliser l’outil d’interface CLI à partir de n’importe quel endroit.Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS/LinuxmacOS/Linux

Les comportements peuvent varier légèrement en fonction de la distribution du système d’exploitation.Behaviors may vary slightly by OS distribution.

  1. Installez Mono 4.4.2 ou une version ultérieure.Install Mono 4.4.2 or later.

  2. Tapez la commande suivante à l'invite de l’interpréteur de commandes :Execute the following command at a shell prompt:

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
    sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    
  3. Créez un alias en ajoutant le script suivant dans le fichier approprié de votre système d’exploitation (généralement ~/.bash_aliases ou ~/.bash_profile) :Create an alias by adding the following script to the appropriate file for your OS (typically ~/.bash_aliases or ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Rechargez l’interpréteur de commandes.Reload the shell. Testez l’installation en entrant nuget sans paramètres.Test the installation by entering nuget with no parameters. L’aide de l’interface de ligne de commande NuGet CLI doit s’afficher.NuGet CLI help should display.

Conseil

Pour rendre le CLI NuGet disponible dans la Console du Gestionnaire de Package dans Visual Studio, consultez à l’aide de l’interface CLI de nuget.exe dans la console.To make the NuGet CLI available within the Package Manager Console in Visual Studio, see Using the nuget.exe CLI in the console.

DisponibilitéAvailability

Consultez disponibilité des fonctionnalités pour plus d’informations.See feature availability for exact details.

  • Toutes les commandes sont disponibles sur Windows.All commands are available on Windows.
  • Toutes les commandes fonctionnent avec nuget.exe en cours d’exécution sur Mono sauf indication contraire pour pack, restore, et update.All commands work with nuget.exe running on Mono except where indicated for pack, restore, and update.
  • Le pack, restore, delete, locals, et push commandes sont également disponibles sur Mac et Linux via l’interface CLI dotnet.The pack, restore, delete, locals, and push commands are also available on Mac and Linux through the dotnet CLI.

Commandes et mise en applicationCommands and applicability

Les commandes disponibles ou adéquation à la création du package, la consommation de package et/ou la publication d’un package vers un ordinateur hôte :Available commands and applicability to package creation, package consumption, and/or publishing a package to a host:

Commandes courantesCommon Commands Rôles applicables.Applicable Roles Version de NuGetNuGet Version DescriptionDescription
packpack CréationCreation 2.7+2.7+ Crée un package NuGet à partir d’un .nuspec ou fichier projet.Creates a NuGet package from a .nuspec or project file. Lors de l’exécution sur Mono, la création d’un package à partir d’un fichier de projet n’est pas pris en charge.When running on Mono, creating a package from a project file is not supported.
pushpush PublicationPublishing TousAll Publie un package à une source de package.Publishes a package to a package source.
configconfig TousAll TousAll Obtient ou définit les valeurs de configuration NuGet.Gets or sets NuGet configuration values.
help or ?help or ? TousAll TousAll Affiche l’aide des informations ou à l’aide d’une commande.Displays help information or help for a command.
localslocals ConsommationConsumption 3.3+3.3+ Répertorie les emplacements de la global-packages, http-cache, et temp efface le contenu de ces dossiers et les dossiers.Lists locations of the global-packages, http-cache, and temp folders and clears the contents of those folders.
restorerestore ConsommationConsumption 2.7+2.7+ Restaure tous les packages référencés par le format de gestion de package en cours d’utilisation.Restores all packages referenced by the package management format in use. Lors de l’exécution sur Mono, la restauration des packages en utilisant le format PackageReference n’est pas pris en charge.When running on Mono, restoring packages using the PackageReference format is not supported.
setapikeysetapikey Publication, la consommationPublishing, Consumption TousAll Enregistre une clé API pour une source de package donné lors de cette source de package nécessite une clé pour l’accès.Saves an API key for a given package source when that package source requires a key for access.
specspec CréationCreation TousAll Génère un .nuspec fichier, à l’aide de jetons si la génération du fichier à partir d’un projet Visual Studio.Generates a .nuspec file, using tokens if generating the file from a Visual Studio project.
Commandes secondairesSecondary Commands Rôles applicables.Applicable Roles Version de NuGetNuGet Version DescriptionDescription
addadd PublicationPublishing 3.3+3.3+ Ajoute un package à une source de packages non HTTP à l’aide de disposition hiérarchique.Adds a package to a non-HTTP package source using hierarchical layout. Pour les sources HTTP, utilisez push.For HTTP sources, use push.
deletedelete PublicationPublishing TousAll Supprime ou retire un package à partir d’une source de package.Removes or unlists a package from a package source.
initinit CréationCreation 3.3+3.3+ Ajoute des packages à partir d’un dossier à une source de package à l’aide de disposition hiérarchique.Adds packages from a folder to a package source using hierarchical layout.
installinstall ConsommationConsumption TousAll Installe un package en cours de projet mais ne pas modifier des projets ou référencer des fichiers.Installs a package into the current project but does not modify projects or reference files.
listlist Consommation, peut-être de publicationConsumption, perhaps Publishing TousAll Affiche les packages à partir d’une source donnée.Displays packages from a given source.
mirrormirror PublicationPublishing Déconseillé dans 3.2 +Deprecated in 3.2+ Reflète un package et ses dépendances à partir d’une source vers un référentiel cible.Mirrors a package and its dependencies from a source to a target repository.
sourcessources La consommation, publicationConsumption, Publishing TousAll Gère les sources de package dans les fichiers de configuration.Manages package sources in configuration files.
updateupdate ConsommationConsumption TousAll Met à jour les packages d’un projet avec les dernières versions disponibles.Updates a project's packages to the latest available versions. Non pris en charge lors de l’exécution sur Mono.Not supported when running on Mono.

Assurez-vous de différentes commandes utiliser de divers variables d’environnement.Different commands make use of various Environment variables.

Commandes CLI NuGet par rôles applicables :NuGet CLI commands by applicable roles:

RôleRole CommandesCommands
ConsommationConsumption config, help, install, list, locals, restore, setapikey, sources, updateconfig, help, install, list, locals, restore, setapikey, sources, update
CréationCreation config, help, init, pack, specconfig, help, init, pack, spec
PublicationPublishing add, config, delete, help, list, push, setapikey, sourcesadd, config, delete, help, list, push, setapikey, sources

Les développeurs soucieux uniquement de consommer des packages, par exemple, seulement besoin de comprendre que le sous-ensemble de commandes NuGet.Developers concerned only with consuming packages, for example, need only understand that subset of NuGet commands.

Notes

Noms des options de commande respectent la casse.Command option names are case-insensitive. Les options qui sont déconseillées ne sont pas incluses dans cette référence, tel que NoPrompt (remplacé par NonInteractive) et Verbose (remplacé par Verbosity).Options that are deprecated are not included in this reference, such as NoPrompt (replaced by NonInteractive) and Verbose (replaced by Verbosity).