update コマンド (NuGet CLI)

  • [アーティクル]

適用対象: パッケージ使用 • サポートされるバージョン: すべて

利用できる最も新しいバージョンに (packages.config を使用する) プロジェクトのすべてのパッケージを更新します。 update を実行する前に '復元' を実行することをお勧めします。 (個々のパッケージを更新するには、バージョン番号を指定せずに nuget install を使用します。この場合、NuGet は最新バージョンをインストールします)

注: update は、Mono (Mac OSX または Linux) で実行されている CLI で動作せず、PackageReference 形式を使用している場合にも動作しません。

update コマンドは、プロジェクト ファイル内のアセンブリ参照も更新します (これらの参照が既に存在する場合)。 更新されたパッケージにアセンブリが追加されている場合、新しい参照は追加されません 。 新しいパッケージの依存関係にも、アセンブリ参照は追加されません。 これらの操作を更新プログラムの一部として含めるには、パッケージ マネージャー UI または パッケージ マネージャー コンソールを使用して Visual Studio でパッケージを更新します。

このコマンドは、-self フラグを使用して nuget.exe 自体を更新する場合にも使用できます。

使用方法

nuget update <configPath> [options]

ここで <configPath> は、packages.config またはプロジェクトの依存関係を一覧表示するソリューション ファイルを示します。

[オプション]

  • -ConfigFile

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

  • -DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]

    使用する依存関係パッケージのバージョンを次のいずれかに指定します。

    • Lowest (既定値): 最下位バージョン
    • HighestPatch: 最小メジャー、最小マイナー、最上位パッチがあるバージョン
    • HighestMinor: 最小メジャー、最大マイナー、最上位パッチがあるバージョン
    • Highest: 最上位バージョン
    • Ignore: 依存関係パッケージは使用されません

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    パッケージのファイルがターゲット プロジェクトに既に存在する場合の既定のアクションを指定します。 Overwrite に設定すると、常にファイルが上書きされます。 Ignore に設定すると、ファイルがスキップされます。

    既定の PromptUser アクションでは、OverwriteAll または IgnoreAll を指定しない限り、競合するファイルを求めるプロンプトが表示されますが、これらのオプションは残りのすべてのファイルに適用されます。

  • -ForceEnglishOutput

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

  • -?|-help

    コマンドのヘルプ情報を出力します。

  • -Id

    更新するパッケージ ID の一覧を指定します。

  • -MSBuildPath

    (4.0 以降) コマンドで使用する MSBuild のパスを指定します。-MSBuildVersion よりも優先されます。

  • -MSBuildVersion

    (3.2 以降) このコマンドで使用する MSBuild のバージョンを指定します。 サポートされる値は、4、12、14、15.1、15.3、15.4、15.5、15.6、15.7、15.8、15.9 です。 既定では、パス内の MSBuild が選択されます。それ以外の場合は、インストールされている MSBuild の最も新しいバージョンが既定値です。

  • -NonInteractive

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

  • -PreRelease

    プレリリース バージョンへの更新を許可します。 このフラグは、既にインストールされているプレリリース パッケージを更新する場合は必要ありません。

  • -RepositoryPath

    パッケージをインストールするローカル フォルダーを指定します。

  • -Safe

    インストールされているパッケージと同じメジャー バージョンおよびマイナー バージョン内で使用可能な最も高いバージョンの更新プログラムのみがインストールされるように指定します。

  • -Self

    nuget.exe を最新バージョンに更新します。 -Source は使用できますが、他のすべての引数は無視されます。 ソースが指定されていない場合は、NuGet.Config 設定に関係なく nuget.org の更新プログラムをチェックします。

  • -Source

    更新に使用するパッケージ ソース (URL) の一覧を指定します。 省略した場合、コマンドは構成ファイルで指定されているソースを使用します (「一般的な NuGet 構成」を参照)。

  • -Verbosity [normal|quiet|detailed]

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

  • -Version

    1 つのパッケージ ID で使用する場合は、更新するパッケージのバージョンを指定します。

「環境変数」を参照してください。

例

nuget update

# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14

nuget update -safe

nuget update -self