推送命令 (NuGet CLI)

適用于: 套件發佈 • 支援的版本: 全部;nuget.org 需要 4.1.0+

重要

若要將套件推送至 nuget.org 您必須使用 nuget.exe v4.1.0+,這會實作必要的 NuGet 通訊協定

將套件推送至套件來源,並加以發佈。

NuGet 的預設組態是藉由載入 %AppData%\NuGet\NuGet.Config (windows) 或 ~/.nuget/NuGet/NuGet.Config (Mac/Linux) 來取得,然後從磁片磁碟機根目錄開始載入任何 Nuget.Config.nuget\Nuget.Config 檔案,並結束于目前的目錄 (請參閱 常見的 NuGet 組態)

使用方式

nuget push <packagePath> [options]

其中 <packagePath> 會識別要推送至伺服器的封裝。

選項

  • -ApiKey

    目標存放庫的 API 金鑰。 如果沒有,則會使用組態檔中指定的組態檔。

  • -ConfigFile

    要套用的 NuGet 組態檔。 如果未指定, %AppData%\NuGet\NuGet.Config 則會使用 (Windows) 或 ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux) 。

  • -DisableBuffering

    在推送至 HTTP () 伺服器以減少記憶體使用量時,停用緩衝處理。 注意:使用此選項時,整合式Windows 驗證可能無法運作。

  • -ForceEnglishOutput

    (3.5+) 強制nuget.exe使用非變異且以英文為基礎的文化特性來執行。

  • -?|-help

    顯示命令的說明資訊。

  • -NonInteractive

    隱藏使用者輸入或確認的提示。

  • -NoServiceEndpoint

    不會附加 api/v2/packages 至來源 URL。

  • -NoSymbols

    (3.5+) 如果符號套件存在,則不會推送至符號伺服器。

  • -src|-Source

    指定伺服器 URL。 NuGet 會識別 UNC 或本機資料夾來源,並直接將檔案複製到該處,而不是使用 HTTP 推送檔案。 此外,從 NuGet 3.4.2 開始,除非 NuGet.Config 檔案指定 DefaultPushSource 值,否則這是必要參數 (請參閱 設定 NuGet 行為) 。

  • -SkipDuplicate

    (5.1+) 如果套件和版本已經存在,請略過它,並在推送中繼續進行下一個套件。如果有的話。

  • -SymbolSource

    指定符號伺服器 URL。

  • -SymbolApiKey

    (3.5+) 指定 中所 -SymbolSource 指定 URL 的 API 金鑰。

  • -Timeout

    指定推送至伺服器的逾時,以秒為單位。 預設值是 300 秒 (5 分鐘)。

  • -Verbosity [normal|quiet|detailed]

    指定輸出中顯示的詳細資料量: normal (預設) 、 quietdetailed

另請參閱 環境變數

範例

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