commande push (CLI NuGet)

  • Article

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 ou detailed.

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