commande push (CLI NuGet)
S’applique à : publication de package • Versions prises en charge : toutes ; 4.1.0+ requises pour nuget.org
Important
Pour envoyer des packages à nuget.org, vous devez utiliser nuget.exe v4.1.0 ou plus, qui implémente les protocoles NuGet requis.
Envoie un package à une source de package et le publie.
La configuration par défaut de NuGet est obtenue en charge %AppData%\NuGet\NuGet.Config
(Windows) ou ~/.nuget/NuGet/NuGet.Config
(Mac/Linux), puis en chargeant tout fichier Nuget.Config
ou .nuget\Nuget.Config
à partir de la racine du lecteur et se terminant dans le répertoire actif (voir configurations NuGet courantes)
Usage
nuget push <packagePath> [options]
où <packagePath>
identifie le package à envoyer au serveur.
Options
-ApiKey
Clé API pour le référentiel cible. S’il n’est pas présent, celui spécifié dans le fichier config est utilisé.
-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é.-DisableBuffering
Désactive la mise en mémoire tampon pendant l’envoi vers un serveur HTTP(S) afin de réduire l’utilisation de la mémoire. Attention : lorsque cette option est utilisée, l’authentification intégrée de Windows intégré peut ne pas fonctionner.
-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.
-NonInteractive
Supprime les invites pour l’entrée utilisateur ou les confirmations.
-NoServiceEndpoint
N’ajoute pas
api/v2/packages
à l’URL source.-NoSymbols
(3.5+) Si un package de symboles existe, il ne sera pas envoyé à un serveur de symboles.
-src|-Source
Spécifie l’URL du serveur. NuGet identifie une source de dossier UNC ou local et copie simplement le fichier là-bas au lieu de l’envoyer (via push) à l’aide de HTTP. À compter de NuGet 3.4.2, il s’agit d’un paramètre obligatoire, sauf si le fichier
NuGet.Config
spécifie une valeur DefaultPushSource (voir Configuration du comportement de NuGet).-SkipDuplicate
(5.1+) Si un package et une version existent déjà, ignorez-le et poursuivez avec le package suivant dans l’envoi, le cas échéant. Cette option est ignorée si le package est envoyé à une source de dossier UNC ou locale.
-SymbolSource
Spécifie l’URL du serveur de symboles.
-SymbolApiKey
(3.5+) Spécifie la clé API pour l’URL spécifiée dans
-SymbolSource
.-Timeout
Spécifie le délai d’expiration, en secondes, pour envoyer vers un serveur. La valeur par défaut est 300 secondes (5 minutes).
-Verbosity [normal|quiet|detailed]
Spécifie la quantité de détails affichée dans la sortie :
normal
(la valeur par défaut),quiet
oudetailed
.
Consultez également Variables d’environnement.
Exemples
nuget push foo.nupkg
nuget push foo.symbols.nupkg
nuget push foo.nupkg -Timeout 360
nuget push *.nupkg
nuget.exe push -source \\mycompany\repo\ mypackage.1.0.0.nupkg
nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -Source https://api.nuget.org/v3/index.json
nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a
nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -src https://customsource/
:: In the example below -SkipDuplicate will skip pushing the package if package "Foo" version "5.0.2" already exists on NuGet.org
nuget push Foo.5.0.2.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -src https://api.nuget.org/v3/index.json -SkipDuplicate
- Pour envoyer (via push) vers Azure Artifacts, consultez la documentation sur les envois push d’Azure Artifacts.