追跡対象の.NETインストールを dotnetup で更新する

Note

dotnetup はパブリック プレビュー段階です。 その機能と動作は、一般公開前に変更される可能性があります。

dotnetup は、解決されたバージョンとは別に要求されたチャネルを格納します。 更新によって、各ローリング チャネルが再度更新されます。

更新範囲を選択

次のいずれかのコマンドを使用します。

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

ランタイムの更新には、.NET Core と ASP.NET Core ランタイムが含まれます。 Windowsでは、Windowsデスクトップのランタイム要件も含まれます。

インストール ルートを制限する

既定では、更新プログラムは、選択したマニフェスト内のすべてのルートの依存関係を処理できます。 --install-pathを使用して操作を制限してください：

dotnetup update --install-path D:\tools\dotnet

リポジトリ ファイルを更新する

SDK の要件では、参照元として global.json を使用できます。 新しく解決された SDK バージョンを各ソース ファイルに書き戻すには、次のコマンドを実行します。

dotnetup sdk update --update-global-json

このオプションを指定しない場合、dotnetup は更新プログラムをインストールしますが、リポジトリ ファイルは編集しません。

ガベージコレクションが変更されたglobal.jsonソースを更新する前に、更新では格納された要件が処理されます。 リポジトリの global.jsonを変更した後、格納されている依存関係を更新する前に、そのリポジトリから dotnetup sdk install を実行します。 そうしないと、最初の更新で以前の要件がまだ処理される可能性があります。

更新の動作を理解する

  • SDK とランタイムの正確なバージョンはスキップされます。明示的に要求されているため、更新対象になりません。
  • 各インストール要件は個別に処理されます。
  • 個別の失敗が発生した後も、すべてのインストール要件の処理が続行されます。
  • このコマンドは、残りのインストール要件をすべて処理した後にエラーを報告します。
  • 正常に更新されるとガベージ コレクションが実行されます。クリーンアップ プロセスでは、構成されたインストール要件のいずれも実際には必要ないインストール済みコンポーネントが削除されます。
  • 別の要件で引き続き必要な場合は、インストールされているバージョンが残ります。

結果を確認する

追跡されている状態とディスク上のインストールを確認:

dotnetup list

機械可読出力用:

dotnetup list --format json

参照

  • 最終更新: