次の方法で共有

dotnet パッケージの更新

この記事は、.NET 10 SDK 以降のバージョン ✔️ 適用されます

名前

dotnet package update - プロジェクト内の参照先パッケージを更新します。

概要

dotnet package update [<packages>...]
    [--interactive] [--project <path>]
    [--verbosity <level>] [--vulnerable]

dotnet package update -h|--help

Description

dotnet package update コマンドは、プロジェクトで使用されるパッケージを更新します。 NuGetAudit が有効になっている場合は、既知の脆弱性を持つ更新プログラム パッケージを修正されたバージョンに自動的に更新することもできます。

エラーとしての警告

dotnet package update は暗黙的な復元を実行して、結果のパッケージ グラフにエラーがないかどうかを確認します。 --vulnerableを使用すると、NuGetAudit の警告を見つけるための暗黙的な復元も行われます。 ただし、プロジェクトで WarningsAsErrors または TreatWarningsAsErrorsを使用している場合、NuGet の復元警告によって復元が失敗し、更新が完了しなくなる可能性があります。

この機能要求が実装されるまでは、MSBuild の条件と環境変数を回避策として利用することをお勧めします。 たとえば、プロジェクトで <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> を設定し、ほとんどの Linux シェルと Mac シェルで CustomCondition=true dotnet package update実行できます。 Windows コマンド プロンプトと PowerShell では、環境変数を設定し、dotnet パッケージの更新を実行してから、環境変数を 3 つの個別のコマンドとして設定解除する必要があります。

論争

  • packages

    更新するパッケージの省略可能な一覧。 パッケージが指定されていない場合、コマンドはプロジェクトによって参照されるすべてのパッケージの更新を試みます。 パッケージには、必要に応じてパッケージ名の後に @ とバージョン番号を指定できます。 たとえば、dotnet package update Contoso.Utilities または dotnet package update Contoso.Utilities@3.2.1 です。 バージョンが指定されていない場合は、構成されたパッケージ ソースで使用可能な最高バージョンが見つかります。

オプション

  • --interactive

    コマンドを停止して、ユーザーの入力または操作のために待機させることができます。 たとえば、認証を完了する場合があります。

  • --project <path>

    パッケージを更新するプロジェクト。 ディレクトリが指定されている場合、ディレクトリ内のプロジェクト ファイルとソリューション ファイルが検索されます。 既定では、現在の作業ディレクトリが使用されます。

  • -v|--verbosity <LEVEL>

    コマンドの詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 詳細については、LoggerVerbosityを参照してください。

  • --vulnerable

    復元によってパッケージに既知の脆弱性が報告された場合、このコマンドはこれらのパッケージをアップグレードします。 このオプションを使用すると、既知の脆弱性を持たない、現在参照されているバージョンよりも高い最小バージョンにパッケージがアップグレードされます。

  • -?|-h|--help

    コマンドの使用方法を示した説明を出力します。

例示

  • プロジェクト内のすべてのパッケージを使用可能な最高バージョンに更新する

    dotnet package update

    Updating outdated packages in S:\src\test\update\ConsoleApp1.
  ConsoleApp1:
    Updated Microsoft.Extensions.Configuration 9.0.0 to 9.0.9.
    Updated Microsoft.Extensions.DependencyInjection 9.0.0 to 9.0.9.

Updated 2 packages in 7 scanned packages.

  • Contoso.Utilities を使用可能な最高バージョンに更新し、Fabrikam.WebApi をバージョン 1.2.3 に更新します

    dotnet package update Contoso.Utilities Fabrikam.WebApi@1.2.3

    Updating outdated packages in S:\src\test\update\ConsoleApp1.
  ConsoleApp1:
    Updated Contoso.Utilities 2.3.1 to 2.4.6.
    Updated Fabrikam.WebApi 1.0.2 to 1.2.3.

Updated 2 packages in 2 scanned packages.

  • 既知の脆弱性を含むパッケージを更新する

    dotnet package update --vulnerable

    Updating packages with security advisories in S:\src\test\update\ConsoleApp1
  ConsoleApp1:
    Updating System.Text.Json 8.0.0 to 8.0.5.

Updated 1 packages in 31 scanned packages.
  • Last updated on