push コマンド (NuGet CLI)

  • [アーティクル]

適用対象: パッケージの発行 • サポートされているバージョン: すべて (nuget.org に必須の 4.1.0 以降)

重要

nuget.org にパッケージをプッシュするには、必須の NuGet プロトコルが実装されている nuget.exe v4.1.0 以降を使用する必要があります。

パッケージをパッケージ ソースにプッシュし、発行します。

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 キー。 存在しない場合は、構成ファイルで指定した API キーが使用されます。

  • -ConfigFile

    適用する NuGet 構成ファイル。 指定しない場合は、%AppData%\NuGet\NuGet.Config (Windows)、~/.nuget/NuGet/NuGet.Config または ~/.config/NuGet/NuGet.Config (Mac/Linux) が使用されます。

  • -DisableBuffering

    メモリ使用量を減らすため、HTTP (s) サーバーにプッシュする際のバッファリングを無効にします。 注意: このオプションを使用すると、統合 Windows 認証が機能しない可能性があります。

  • -ForceEnglishOutput

    (3.5 以降) インバリアントの英語ベースのカルチャを使用して、nuget.exe の実行を強制します。

  • -?|-help

    コマンドのヘルプ情報を表示します。

  • -NonInteractive

    ユーザーによる入力や確認を求めるプロンプトを表示しません。

  • -NoServiceEndpoint

    ソース URL に api/v2/packages を追加しません。

  • -NoSymbols

    (3.5 以降) シンボル パッケージが存在する場合、シンボル サーバーにはプッシュされません。

  • -src|-Source

    サーバー URL を指定します。 NuGet によって UNC またはローカル フォルダー ソースが識別され、HTTP を使用してファイルがプッシュされるのではなく、単にそこにファイルがコピーされます。 また NuGet 3.4.2 以降では、NuGet.Config ファイルで DefaultPushSource 値が指定されていない限り、これは必須パラメーターです (NuGet の動作の構成を参照)。

  • -SkipDuplicate

    (5.1 以降) パッケージとバージョンが既に存在する場合は、それをスキップし、プッシュ内の次のパッケージ (存在する場合) に進みます。 パッケージが UNC またはローカル フォルダー ソースにプッシュされている場合、このオプションは無視されます。

  • -SymbolSource

    シンボル サーバーの URL を指定します。

  • -SymbolApiKey

    (3.5 以降)-SymbolSource で指定した URL の API キーを指定します。

  • -Timeout

    サーバーにプッシュする場合のタイムアウトを指定します (秒単位)。 既定値は 300 秒 (5 分) です。

  • -Verbosity [normal|quiet|detailed]

    出力表示の詳細度を、normal (既定)、quiet、または detailed に指定します。

また、「環境変数」もご覧ください

例

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