dotnet workload install
この記事の対象: ✔️ .NET 6 SDK 以降のバージョン
Name
dotnet workload install
- オプションのワークロードがインストールされます。
構文
dotnet workload install <WORKLOAD_ID>...
[--configfile <FILE>] [--disable-parallel]
[--ignore-failed-sources] [--include-previews] [--interactive]
[--no-cache] [--skip-manifest-update] [--source <SOURCE>]
[--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet workload install -?|-h|--help
説明
dotnet workload install
コマンドによって 1 つまたは複数の "オプションのワークロード" がインストールされます。 オプションのワークロードを .NET SDK の上にインストールすると、.NET MAUI や Blazor WebAssembly AOT などのさまざまなアプリケーションの種類をサポートできます。
コマンドが更新モード workload-set
場合、ワークロードのバージョンがインストールされます。
- global.jsonまたは
--version
オプションで指定された最新のワークロード セットまたはワークロード セットのバージョンです。 - 個々のワークロードで使用できる最新バージョンではない可能性があります。 たとえば、以前に
--version
フラグを使用した場合、install
コマンドは新しいワークロード セットをインストールしません。
詳細については、「 .NET SDK ワークロード セット」を参照してください。 workload-set
更新モードは 8.0.400 SDK 以降で使用できます。
インストールできるワークロードを確認するには、dotnet workload search を使用します。
管理者特権で実行する場合
保護されたディレクトリにインストールされる macOS および Linux SDK のインストールでは、コマンドを管理者特権で実行する必要があります (sudo
コマンドを使用します)。 Windows では、SDK が Program Files ディレクトリにインストールされている場合でも、コマンドを管理者特権で実行する必要はありません。 Windows の場合、このコマンドではその場所に MSI インストーラーが使用されます。
結果は SDK のバージョンによって異なる
dotnet workload
コマンドは、特定の SDK バージョンのコンテキストで動作します。 .NET 6.0.100 SDK と .NET 6.0.200 SDK の両方がインストールされているとします。 dotnet workload
コマンドを実行すると、選択した SDK のバージョンに応じて異なる結果が得られます。 この動作は、パッチ バージョンの違いではなく、メジャーおよびマイナーバージョンと機能バンドの違いに適用されます。 たとえば、.NET SDK 6.0.101 と 6.0.102 では同じ結果が得られますが、6.0.100 と 6.0.200 では異なる結果になります。 global.json ファイルを使用して SDK のバージョンを指定できます。
広告マニフェスト
ワークロードのインストールに必要なアセットの名前とバージョンは、"マニフェスト" に保持されます。 既定では、dotnet workload install
コマンドによって、ワークロードのインストール前に、利用可能な最新のマニフェストがダウンロードされます。 マニフェストのローカル コピーによって、ワークロードのアセットを検索してダウンロードするために必要な情報が提供されます。
dotnet workload list
コマンドは、インストールされているワークロードのバージョンと現在使用可能なバージョンを比較します。 インストールされているバージョンよりも新しいバージョンが使用可能であることが判明した場合は、コマンドの出力にその事実をアドバタイズします。 dotnet workload list
の新しいバージョンの通知は、.NET 6 以降で利用できます。
これらの通知を有効にするために、マニフェストの利用可能な最新バージョンがダウンロードされ、"広告マニフェスト" として格納されます。 これらのダウンロードは、次のいずれかのコマンドが実行されると、バックグラウンドで非同期的に行われます。
マニフェストのダウンロードが完了する前にコマンドが終了した場合、ダウンロードは停止します。 次にこれらのコマンドのいずれかが実行されたときに、ダウンロードが再試行されます。 環境変数を設定して、これらのバックグラウンド ダウンロードを無効にしたり、その頻度を制御したりすることができます。 既定では、1 日に複数回発生することはありません。
--skip-manifest-update
オプションを使用すると、dotnet workload install
コマンドでマニフェストがダウンロードされないようにすることができます。
この dotnet workload update
コマンドは広告マニフェストもダウンロードします。 このダウンロードは、更新プログラムが利用可能かどうかを確認するために必要なため、実行を防止するオプションはありません。 ただし、--advertising-manifests-only
オプションを使用してワークロードの更新をスキップしたり、マニフェストのダウンロードのみを実行したりすることができます。 このオプションは、.NET 6 以降で使用できます。
引数
WORKLOAD_ID
...ワークロードの ID またはインストールする複数の ID。 使用可能なワークロードを確認するには、dotnet workload search を使用します。
オプション
--configfile <FILE>
使用する NuGet 構成ファイル (nuget.config)。 指定した場合、このファイルの設定のみが使用されます。 指定しない場合、現在のディレクトリからの構成ファイルの階層が使用されます。 詳細については、「一般的な NuGet 構成」をご覧ください。
--disable-parallel
複数のプロジェクトを並行して復元できないようにします。
-?|-h|--help
コマンドの使用方法を示した説明を出力します。
--ignore-failed-sources
パッケージ ソース エラーを警告として処理します。
--include-previews
プレリリースのワークロード マニフェストを許可します。
--interactive
コマンドを停止して、ユーザーの入力または操作のために待機させることができます。 たとえば、認証を完了する場合があります。
--no-cache
パッケージと HTTP 要求がキャッシュされないようにします。
--skip-manifest-update
ワークロード マニフェストの更新をスキップします。 ワークロードマニフェストによって、各ワークロードにインストールする必要があるアセットとバージョンが定義されます。
-s|--source <SOURCE>
使用する NuGet パッケージ ソースの URI を指定します。 この設定により、"nuget.config" ファイルに指定されているすべてのソースがオーバーライドされます。 このオプションを複数回指定することによって、複数のソースを指定できます。
--temp-dir <PATH>
NuGet パッケージ (セキュリティで保護されている必要があります) のダウンロードと抽出に使用される一時ディレクトリを指定します。
-v|--verbosity <LEVEL>
コマンドの詳細レベルを設定します。 指定できる値は、
q[uiet]
、m[inimal]
、n[ormal]
、d[etailed]
、およびdiag[nostic]
です。 既定値は、minimal
です。detailed
またはdiagnostic
詳細度を指定した場合、このコマンドではダウンロードした Nuget パッケージに関する情報が示されます。
--version
インストールまたは更新するワークロード セットのバージョン。 global.jsonでワークロード セットのバージョンを指定した場合、
--version
オプションを使用してワークロード セットのバージョンを指定することはできません。 その場合に--version
オプションを使用できるようにするには、global.json ファイルを含むパスの外側でコマンドを実行します。 8.0.400 SDK 以降で使用できます。 詳細については、「 .NET SDK ワークロード セット」を参照してください。
例
maui
ワークロードをインストールします。dotnet workload install maui
maui-android
およびmaui-ios
ワークロードをインストールします。dotnet workload install maui-android maui-ios
.NET