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>]

dotnet workload install -?|-h|--help

説明

dotnet workload install コマンドによって 1 つまたは複数の "オプションのワークロード" がインストールされます。 オプションのワークロードを .NET SDK の上にインストールすると、.NET MAUIBlazor WebAssembly AOT などのさまざまなアプリケーションの種類をサポートできます。

インストールできるワークロードを確認するには、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 ファイルまたは dotnet workload コマンドの --sdk-version オプションを使用して 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 パッケージに関する情報が示されます。

  • maui ワークロードをインストールします。

    dotnet workload install maui
    
  • maui-android および maui-ios ワークロードをインストールします。

    dotnet workload install maui-android maui-ios