dotnet コマンド

この記事の対象: ✔️ .NET Core 3.1 SDK 以降のバージョン

名前

dotnet - .NET CLI の汎用ドライバー。

概要

使用可能なコマンドと環境に関する情報を取得するには、

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

コマンドを実行するには (SDK のインストールが必要です)。

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

アプリケーションを実行するには:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

説明

dotnet コマンドには、次の 2 つの関数があります。

• .NET プロジェクトを操作するためのコマンドを提供します。

  たとえば、dotnet build を使うと、プロジェクトをビルドできます。 各コマンドには独自のオプションと引数が定義されています。 すべてのコマンドは、コマンドの使用方法に関する簡単なドキュメントを印刷するための --help オプションをサポートしています。

• .NET アプリケーションが実行されます。

  アプリケーションを実行するアプリケーション .dll ファイルへのパスを指定します。 アプリケーションを実行するには、エントリ ポイントを検索して実行することを意味します。コンソール アプリの場合は、#D0 メソッドです。 たとえば、dotnet myapp.dllmyapp アプリケーションを実行します。 デプロイ オプションについては、 .NET アプリケーションのデプロイ に関するページを参照してください。

オプション

次のさまざまなオプションを使用できます。

• 環境に関する情報を表示します。
• コマンドの実行。
• アプリケーションの実行。

環境情報と使用可能なコマンドを表示するためのオプション

実行するコマンドやアプリケーションを指定せずに、#D0 を単独で使用する場合は、次のオプションを使用できます。 たとえば、dotnet --info や dotnet --versionなどです。 環境に関する情報を出力します。

• --info

  .NET のインストールとコンピューター環境に関する詳細情報 (現在のオペレーティング システムなど) を出力し、.NET バージョンの SHA をコミットします。

• --version

dotnet コマンドで使用される .NET SDK のバージョンを出力します。これは、global.json ファイルの影響を受ける可能性があります。 SDK がインストールされている場合にのみ使用できます。

• --list-runtimes [--arch <ARCH>]

  呼び出された dotnetのアーキテクチャ用にインストールされている .NET ランタイムの一覧を出力します。 x86 バージョンの dotnet では x86 ランタイムのみが一覧表示され、x64 バージョンの dotnet には x64 ランタイムのみが一覧表示されます。

  .NET 10 以降のバージョンでは、 --arch 引数がサポートされています。 指定した場合、 dotnet アーキテクチャと同じでない場合は、指定したアーキテクチャの .NET インストールを検索し、そこにインストールされているランタイムを出力します。 使用できる値は、arm64、x64、x86 です。 dotnet/runtime リポジトリには、 有効なアーキテクチャ値の完全な一覧があります。

• --list-sdks [--arch <ARCH>]

  呼び出された dotnetのアーキテクチャ用にインストールされている .NET SDK の一覧を出力します。 x86 バージョンの dotnet には x86 SDK のみが一覧表示され、x64 バージョンの dotnet には x64 SDK のみが一覧表示されます。

  .NET 10 以降のバージョンでは、 --arch 引数がサポートされています。 dotnet アーキテクチャと同じでなく指定されている場合は、指定したアーキテクチャの .NET インストールを検索し、そこにインストールされている SDK を出力します。 使用できる値は、arm64、x64、x86 です。 dotnet/runtime リポジトリには、 有効なアーキテクチャ値の完全な一覧があります。

• -?|-h|--help

  使用可能なコマンドの一覧を出力します。

コマンドを実行するためのオプション

次のオプションは、コマンドを使用して dotnet します。 たとえば、dotnet build --help や dotnet build --verbosity diagnosticなどです。

• -d|--diagnostics

  診断出力を有効にします。

• -v|--verbosity <LEVEL>

  コマンドの詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 すべてのコマンドではサポートされていません。 このオプションを使用できるかどうかを判断するには、特定のコマンド ページを参照してください。

• -?|-h|--help

  特定のコマンドのドキュメントを出力します。 たとえば、#D0 は、#D1 コマンドのヘルプを表示します。

• command options

  各コマンドは、そのコマンドに固有のオプションを定義します。 使用可能なオプションの一覧については、特定のコマンド ページを参照してください。

アプリケーションを実行するためのオプション

アプリケーションを実行 dotnet 場合は、次のオプションを使用できます。 たとえば、dotnet --roll-forward Major myapp.dll のようにします。

• --additionalprobingpath <PATH>

  プローブするプローブ ポリシーとアセンブリを含むパス。 このオプションを繰り返して、複数のパスを指定します。

• --additional-deps <PATH>

  追加の .deps.json ファイルへのパス。 deps.json ファイルには、依存関係、コンパイル依存関係、アセンブリの競合に対処するために使用されるバージョン情報の一覧が含まれています。 詳細については、GitHub の ランタイム構成ファイル を参照してください。

• --roll-forward <SETTING>

  ロールフォワードをアプリに適用する方法を制御します。 SETTINGには、次のいずれかの値を指定できます。 指定しない場合の既定は、Minor です。

  • LatestPatch - 最新のパッチ バージョンにロールフォワードします。 これにより、マイナー バージョンのロール フォワードが無効になります。
  • Minor - 要求されたマイナー バージョンがない場合は、最下位のマイナー バージョンにロール フォワードします。 要求されたマイナー バージョンが存在する場合は、LatestPatch ポリシーが使用されます。
  • Major - 要求されたメジャー バージョンが見つからない場合は、下位のメジャー バージョンにロール フォワードし、マイナー バージョンを最小にロールフォワードします。 要求されたメジャー バージョンが存在する場合は、マイナー ポリシーが使用されます。
  • LatestMinor - 要求されたマイナー バージョンが存在する場合でも、最上位のマイナー バージョンにロール フォワードします。 コンポーネント ホスティング シナリオを対象としています。
  • LatestMajor - 要求されたメジャーが存在する場合でも、最上位のメジャーバージョンと最高マイナー バージョンにロールフォワードします。 コンポーネント ホスティング シナリオを対象としています。
  • Disable - ロールフォワードしないでください。 指定したバージョンにのみバインドします。 このポリシーは、最新のパッチにロールフォワードする機能を無効にするため、一般的な使用には推奨されません。 この値は、テストにのみ推奨されます。

  Disableを除き、すべての設定で使用可能な最高のパッチ バージョンが使用されます。

  ロールフォワード動作は、プロジェクト ファイル プロパティ、ランタイム構成ファイル プロパティ、環境変数でも構成できます。 詳細については、「 メジャー バージョンランタイムのロールフォワード」を参照してください。

• --fx-version <VERSION>

  アプリケーションの実行に使用する .NET ランタイムのバージョン。

  このオプションは、アプリケーションの .runtimeconfig.json ファイル内の最初のフレームワーク参照のバージョンをオーバーライドします。 これは、フレームワーク参照が 1 つしかない場合にのみ、期待どおりに動作することを意味します。 アプリケーションに複数のフレームワーク参照がある場合、このオプションを使用するとエラーが発生する可能性があります。

exec コマンドを使用してアプリケーションを実行するためのオプション

次のオプションは、dotnet コマンドexec使用してアプリケーションを実行する場合にのみ使用できます。 たとえば、dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll のようにします。

• --depsfile <PATH>

  deps.json ファイルへのパス。 deps.json ファイルは、アプリケーションの実行に必要な依存関係に関する情報を含む構成ファイルです。 このファイルは.NET SDK によって生成されます。

• --runtimeconfig <PATH>

  runtimeconfig.json ファイルへのパス。 runtimeconfig.json ファイルには実行時設定が含まれており、通常は <applicationname>.runtimeconfig.jsonという名前です。 詳細については、「.NET ランタイム構成設定 を参照してください。

dotnet コマンド

全般

コマンド	機能
dotnet build	.NET アプリケーションをビルドします。
dotnet build-server	ビルドによって開始されたサーバーと対話します。
dotnet clean	ビルド出力をクリーンします。
dotnet exec	.NET アプリケーションを実行します。
dotnet ヘルプ	コマンドの詳細なドキュメントをオンラインで表示します。
dotnet migrate	有効な Preview 2 プロジェクトを .NET Core SDK 1.0 プロジェクトに移行します。
dotnet msbuild を する	MSBuild コマンド ラインへのアクセスを提供します。
dotnet new	特定のテンプレートの C# または F# プロジェクトを初期化します。
dotnet pack	コードの NuGet パッケージを作成します。
dotnet publish	.NET フレームワークに依存するアプリケーションまたは自己完結型アプリケーションを発行します。
dotnet restore	特定のアプリケーションの依存関係を復元します。
dotnet run	ソースからアプリケーションを実行します。
dotnet sdk check	インストールされている SDK バージョンとランタイム バージョンの up-to-date 状態を表示します。
dotnet sln	ソリューション ファイル内のプロジェクトを追加、削除、および一覧表示するためのオプション。
dotnet store	アセンブリをランタイム パッケージ ストアに格納します。
dotnet test	テスト ランナーを使用してテストを実行します。

プロジェクト参照

コマンド	機能
dotnet reference add コマンドを使用して参照を追加します。	プロジェクト参照を追加します。
dotnet 参照リスト	プロジェクト参照を一覧表示します。
dotnet reference remove	プロジェクト参照を削除します。

NuGet パッケージ

コマンド	機能
dotnet package add	NuGet パッケージを追加します。
dotnet package list	NuGet パッケージを一覧表示します。
dotnet package remove コマンドは、.NET プロジェクトからパッケージを削除するために使用されます。	NuGet パッケージを削除します。
dotnet パッケージの検索	NuGet パッケージを検索します。

NuGet コマンド

コマンド	機能
dotnet nuget delete	サーバーからパッケージを削除または一覧から削除します。
dotnet nuget push	パッケージをサーバーにプッシュし、発行します。
dotnet nuget locals	http 要求キャッシュ、一時キャッシュ、コンピューター全体のグローバル パッケージ フォルダーなどのローカル NuGet リソースをクリアまたは一覧表示します。
dotnet nuget add source	NuGet ソースを追加します。
dotnet nuget disable source	NuGet ソースを無効にします。
dotnet nuget enable source	NuGet ソースを有効にします。
dotnet nuget list source	構成されているすべての NuGet ソースを一覧表示します。
dotnet nuget remove source	NuGet ソースを削除します。
dotnet nuget の更新ソース	NuGet ソースを更新します。

ワークロード コマンド

コマンド	機能
dotnet ワークロードのインストール	オプションのワークロードをインストールします。
dotnet workload list	インストールされているすべてのワークロードを一覧表示します。
dotnet ワークロードの修復	インストールされているすべてのワークロードを修復します。
dotnet ワークロード検索	選択したワークロードまたは使用可能なすべてのワークロードを一覧表示します。
dotnet ワークロードのアンインストール	ワークロードをアンインストールします。
dotnet ワークロードの更新	インストールされているすべてのワークロードを再インストールします。

グローバル、ツール パス、ローカル ツールのコマンド

ツールは、NuGet パッケージからインストールされ、コマンド プロンプトから呼び出されるコンソール アプリケーションです。 自分でツールを作成することも、サード パーティによって作成されたツールをインストールすることもできます。 ツールは、グローバル ツール、ツール パス ツール、ローカル ツールとも呼ばれます。 詳細については、「 .NET ツールの概要」を参照してください。

コマンド	機能
dotnet ツールのインストール	コンピューターにツールをインストールします。
dotnet ツールの一覧	コンピューターに現在インストールされているすべてのグローバル ツール、ツール パス ツール、またはローカル ツールを一覧表示します。
dotnet ツールの検索	NuGet.org、名前またはメタデータに指定した検索語句を含むツールを検索します。
dotnet ツールのアンインストール	コンピューターからツールをアンインストールします。
dotnet ツールの更新	コンピューターにインストールされているツールを更新します。

その他のツール

.NET SDK の一部として、次の追加ツールを使用できます。

道具	機能
dev-certs	開発証明書を作成および管理します。
エフ	Entity Framework Core コマンド ライン ツール。
user-secrets	開発ユーザー シークレットを管理します。
時計	ソース コードの変更を検出すると、アプリケーションを再起動またはホット リロードするファイル ウォッチャー。

各ツールの詳細については、「#B0」と入力します。

例示

新しい .NET コンソール アプリケーションを作成します。

dotnet new console

特定のディレクトリにプロジェクトとその依存関係をビルドします。

dotnet build

アプリケーションを実行します。

dotnet exec myapp.dll

dotnet myapp.dll

こちらもご覧ください

• .NET SDK、.NET CLI、.NET ランタイムで使用される環境変数
• ランタイム構成ファイル
• .NET ランタイム構成設定