追跡対象の.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 のアンインストール と ランタイムのアンインストールを参照してください。

参照

  • 最終更新: