push command (Rozhraní příkazového řádku NuGet)

  • Článek

Platí pro: publikování balíčků • Podporované verze: all; 4.1.0+ vyžadované pro nuget.org

Důležité

Pokud chcete odesílat balíčky do nuget.org musíte použít nuget.exe verze 4.1.0+, která implementuje požadované protokoly NuGet.

Odešle balíček do zdroje balíčku a publikuje ho.

Výchozí konfigurace NuGetu se získá načtením %AppData%\NuGet\NuGet.Config (Windows) nebo ~/.nuget/NuGet/NuGet.Config (Mac/Linux) a následným načtením libovolného Nuget.Config souboru nebo .nuget\Nuget.Config souborů od kořenového adresáře a končícím aktuálním adresářem (viz běžné konfigurace NuGetu).

Využití

nuget push <packagePath> [options]

kde <packagePath> identifikuje balíček, který se má odeslat na server.

Možnosti

  • -ApiKey

    Klíč rozhraní API pro cílové úložiště. Pokud není k dispozici, použije se ten zadaný v konfiguračním souboru.

  • -ConfigFile

    Konfigurační soubor NuGet, který se má použít. Pokud není zadaný, %AppData%\NuGet\NuGet.Config (Windows) nebo ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux), použije se.

  • -DisableBuffering

    Zakáže ukládání do vyrovnávací paměti při odesílání na server HTTP za účelem snížení využití paměti. Upozornění: Při použití této možnosti nemusí integrované ověřování systému Windows fungovat.

  • -ForceEnglishOutput

    (3,5+) Vynutí spuštění nuget.exe pomocí invariantní anglické jazykové verze.

  • -?|-help

    Zobrazí informace nápovědy pro příkaz.

  • -NonInteractive

    Potlačí výzvy k zadání uživatelského vstupu nebo potvrzení.

  • -NoServiceEndpoint

    Nepřidá se api/v2/packages ke zdrojové adrese URL.

  • -NoSymbols

    (3,5+) Pokud balíček symbolů existuje, nebude nasdílený na server symbolů.

  • -src|-Source

    Určuje adresu URL serveru. NuGet identifikuje zdroj UNC nebo místní složku a jednoduše zkopíruje soubor tam místo toho, aby ho nasdílelo pomocí protokolu HTTP. Kromě toho, počínaje NuGet 3.4.2, je to povinný parametr, pokud NuGet.Config soubor neurčuje hodnotu DefaultPushSource (viz Konfigurace chování NuGet).

  • -SkipDuplicate

    (5.1+) Pokud balíček a verze již existují, přeskočte ho a pokračujte dalším balíčkem v nabízeném oznámení( pokud existuje). Tato možnost se ignoruje, pokud se balíček odesílá do zdroje UNC nebo místní složky.

  • -SymbolSource

    Určuje adresu URL serveru symbolů.

  • -SymbolApiKey

    (3,5+) Určuje klíč rozhraní API pro adresu URL zadanou v -SymbolSource.

  • -Timeout

    Určuje časový limit v sekundách pro nasdílením na server. Výchozí hodnota je 300 sekund (5 minut).

  • -Verbosity [normal|quiet|detailed]

    Určuje množství podrobností zobrazených ve výstupu: normal (výchozí), quietnebo detailed.

Viz také proměnné prostředí.

Příklady

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
  • Informace o nasdílení změn do Azure Artifacts najdete v dokumentaci k nabízeným oznámením Azure Artifacts.