次の方法で共有


dotnet list パッケージ

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

名前

dotnet list package - プロジェクトまたはソリューションのパッケージ参照を一覧表示します。

概要

dotnet list [<PROJECT>|<SOLUTION>] package [--config <SOURCE>]
    [--deprecated]
    [-f|--framework <FRAMEWORK>] [--highest-minor] [--highest-patch]
    [--include-prerelease] [--include-transitive] [--interactive]
    [--outdated] [--source <SOURCE>] [-v|--verbosity <LEVEL>]
    [--vulnerable]
    [--format <console|json>]
    [--output-version <VERSION>]

dotnet list package -h|--help

形容

dotnet list package コマンドは、特定のプロジェクトまたはソリューションのすべての NuGet パッケージ参照を一覧表示する便利なオプションを提供します。 このコマンドを処理するために必要なアセットを用意するには、まずプロジェクトをビルドする必要があります。 次の例は、SentimentAnalysis プロジェクトの dotnet list package コマンドの出力を示しています。

Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

要求された 列は、プロジェクト ファイルで指定されたパッケージ バージョンを参照し、範囲を指定できます。 解決済み 列には、プロジェクトが現在使用しているバージョンが一覧表示され、常に 1 つの値になります。 名前の横に (A) を表示するパッケージは、プロジェクト設定 (Sdk 型、<TargetFramework> プロパティ、または <TargetFrameworks> プロパティ) から推論される暗黙的なパッケージ参照を表します。

--outdated オプションを使用して、プロジェクトで使用しているパッケージの新しいバージョンが使用可能かどうかを確認します。 既定では、解決済みのバージョンもプレリリース バージョンでない限り、--outdated は最新の安定したパッケージを一覧表示します。 新しいバージョンを一覧表示するときにプレリリース バージョンを含めるには、--include-prerelease オプションも指定します。 パッケージを最新バージョンに更新するには、dotnet add package 使用します。

次の例は、前の例と同じプロジェクトの dotnet list package --outdated --include-prerelease コマンドの出力を示しています。

The following sources were used:
   https://api.nuget.org/v3/index.json
   C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\

Project `SentimentAnalysis` has the following updates to its packages
   [netcoreapp2.1]:
   Top-level Package      Requested   Resolved   Latest
   > Microsoft.ML         1.4.0       1.4.0      1.5.0-preview

プロジェクトに推移的な依存関係があるかどうかを確認する必要がある場合は、--include-transitive オプションを使用します。 推移的な依存関係は、別のパッケージに依存するパッケージをプロジェクトに追加するときに発生します。 次の例は、HelloPlugin プロジェクトに対して dotnet list package --include-transitive コマンドを実行した場合の出力を示しています。このプロジェクトには、最上位レベルのパッケージと依存しているパッケージが表示されます。

Project 'HelloPlugin' has the following package references
   [netcoreapp3.0]:
   Transitive Package      Resolved
   > PluginBase            1.0.0

引数

PROJECT | SOLUTION

操作するプロジェクトまたはソリューション ファイル。 指定しない場合、コマンドは現在のディレクトリを検索して 1 つを検索します。 複数のソリューションまたはプロジェクトが見つかった場合は、エラーがスローされます。

オプション

  • --config <SOURCE>

    新しいパッケージを検索するときに使用する NuGet ソース。 --outdated オプションが必要です。

  • --deprecated

    非推奨になったパッケージを表示します。

  • -f|--framework <FRAMEWORK>

    指定した ターゲット フレームワークに適用できるパッケージのみを表示します。 複数のフレームワークを指定するには、このオプションを複数回繰り返します。 例: --framework net6.0 --framework netstandard2.0. オプション (-f) の短い形式は、.NET 9 SDK 以降で使用できます。

  • -?|-h|--help

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

  • --highest-minor

    新しいパッケージを検索するときは、メジャー バージョン番号が一致するパッケージのみを考慮します。 --outdated または --deprecated オプションが必要です。

  • --highest-patch

    新しいパッケージを検索するときは、メジャー バージョン番号とマイナー バージョン番号が一致するパッケージのみを考慮します。 --outdated または --deprecated オプションが必要です。

  • --include-prerelease

    新しいパッケージを検索するときは、プレリリース バージョンのパッケージを考慮します。 --outdated または --deprecated オプションが必要です。

  • --include-transitive

    最上位レベルのパッケージに加えて、推移的なパッケージを一覧表示します。 このオプションを指定すると、最上位レベルのパッケージが依存するパッケージの一覧が表示されます。

  • --interactive

    コマンドを停止し、ユーザー入力またはアクションを待機できるようにします。 たとえば、認証を完了します。 .NET Core 3.0 SDK 以降で使用できます。

  • --outdated

    新しいバージョンが利用可能なパッケージを一覧表示します。

  • -s|--source <SOURCE>

    新しいパッケージを検索するときに使用する NuGet ソース。 --outdated または --deprecated オプションが必要です。

  • -v|--verbosity <LEVEL>

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

  • --vulnerable

    既知の脆弱性を持つパッケージを一覧表示します。 --deprecated または --outdated オプションと組み合わせることはできません。 構成ファイルの <AuditSources> プロパティを使用して、VulnerabilityInfo リソースから取得される脆弱性データのソースを指定します。 <AuditSources> を指定しない場合は、指定した <PackageSources> を使用して脆弱性データが読み込まれます。 詳細については、「監査ソースのNuGet パッケージをスキャンしてセキュリティの脆弱性をする方法」を参照してください。

  • --format <console|json>

    レポートの出力形式を設定します。 使用できる値は、jsonconsoleです。 既定値は consoleです。 .NET SDK 7.0.200 以降で使用できます。

  • --output-version <VERSION>

    レポート出力のバージョンを設定します。 使用できる値は 1です。 既定値は 1です。 --format json オプションが必要です。 新しい JSON バージョンが使用可能な場合、コマンドは既定で新しい形式を生成します。 このオプションを使用すると、コマンドで以前の形式を生成する必要があることを指定できます。 .NET SDK 7.0.200 以降で使用できます。

  • 特定のプロジェクトのパッケージ参照を一覧表示します。

    dotnet list SentimentAnalysis.csproj package
    
  • プレリリース バージョンを含め、新しいバージョンを使用できるパッケージ参照を一覧表示します。

    dotnet list package --outdated --include-prerelease
    
  • 特定のターゲット フレームワークのパッケージ参照を一覧表示します。

    dotnet list package --framework netcoreapp3.0
    
  • マシンが読み取り可能な json 出力形式でパッケージ参照を一覧表示します。

    dotnet list package --format json
    
  • マシンが読み取り可能な json 出力形式で特定のターゲット フレームワークのパッケージ参照を一覧表示します。

    dotnet list package --framework netcoreapp3.0 --format json
    
  • 推移的な依存関係や脆弱性の詳細など、パッケージ参照の読み取り可能な JSON 出力をファイルに保存します。

    dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
    
  • 出力バージョン 1 を使用して、マシンが読み取り可能な json 出力形式でパッケージ参照を一覧表示します。

    dotnet list package --format json --output-version 1