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

Note

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

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

これらの更新プログラムでは、dotnetup 実行可能ファイルは更新されません。 ツール自体を更新するには、 dotnetup self updateを使用します。

更新範囲を選択

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

# 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

追跡対象の要件を削除する

SDK の要件を削除するには、その保存済みのチャネルまたは正確なバージョンを指定します。

dotnetup sdk uninstall 10.0.1xx

アンインストールを行うと、その要件が削除され、選択したルート ディレクトリ全体から参照されていないインストールがクリーンアップされます。 要求されたインストールが別の要件によって保持される場合、またはクリーンアップによって追加のインストールが削除される場合には、警告が表示されます。 操作を確認する前に、これらの警告を確認してください。 非対話型の自動化では、警告ではなく確認画面をスキップするには --non-interactive を使用してください。

実行時の要件については、dotnetup runtime uninstall を参照してください。 詳細については、SDK のアンインストール と ランタイムのアンインストールを参照してください。

参照

  • 最終更新: