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>
レポートの出力形式を設定します。 使用できる値は、
json
console
です。 既定値は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
.NET