dotnetup self update コマンド

Name

dotnetup self update - リリース チャネルからスタンドアロン dotnetup 実行可能ファイルを更新します。

概要

dotnetup self update [--channel <daily|preview|stable>] [--force]
                    [--no-progress [<true|false>]]
dotnetup self update --update-notifications <true|false>

Description

このコマンドは、実行中のスタンドアロン dotnetup 実行可能ファイルをインプレースで更新します。 選択したリリース チャネルと、現在のオペレーティング システムとアーキテクチャで利用可能な最新のビルドがダウンロードされます。 マネージド .NET SDK またはランタイムは更新されません。 これらのインストールでは、 dotnetup updateを使用します。

同じバージョン チャネルでは、 --forceを指定しない限り、使用可能なバージョンが等しいか古い場合でも、インストールされている実行可能ファイルは置き換えられません。 このコマンドは、更新プログラムが適用されなかったことを報告し、終了コード 0を返します。 プレビュー バージョンや安定したバージョンなどのバージョン チャネル間の変更は、ターゲット バージョンが古い場合でも実行可能ファイルを置き換えることができます。

インストール ディレクトリは書き込み可能である必要があります。 自己更新では、 dotnet ホストまたはシンボリック リンクまたは別の再解析ポイントである実行可能ファイルを介した実行はサポートされません。 実際のインストール ディレクトリでスタンドアロン実行可能ファイルを使用します。

自己更新では調整ロックが保持されますが、他の dotnetup コマンドは、更新が進行中であることを示すメッセージで失敗する可能性があります。 自己更新が完了したら、これらのコマンドを再試行してください。

self updateを認識しない古いバージョンの場合、または実行可能ファイルが起動しなくなったときに回復する場合は、ダウンロード スクリプトを使用します。

オプション

公式の日次ビルドにも preview バージョン ラベルが含まれているため、既定でプレビュー チャネルに設定されます。 毎日のビルドを維持するには、 --channel dailyを指定します。 パーサーは stableを受け入れますが、このパブリック プレビュー中に安定した dotnetup リリースは使用できません。

通知を更新する

対話型インストールおよび更新コマンドが正常に実行されると、dotnetup は新しい dotnetup ビルドが使用可能になったときに標準出力に通知を書き込むことができます。 これらのコマンドには、ベア dotnetup、 install、 sdk install、 runtime install、 update、 sdk update、および runtime updateが含まれます。

通知は既定で有効になっています。 チェックでは、実行中のビルドの既定のリリース チャネルが使用され、チェックが成功してから 24 時間ごとに最大で 1 回バックグラウンドで更新されます。 実行可能ファイルはダウンロードまたはインストールされません。 更新が成功すると、最大で 1 つの通知が生成されます。 更新の前に短いコマンドが完了する可能性があるため、後のコマンドの後に通知を表示できます。

--interactive trueを使用しても、出力がリダイレクトされるときに通知は表示されません。 失敗したチェックでは、インストールまたは更新コマンドは失敗しません。

通知を無効にするには、次のコマンドを実行します。

dotnetup self update --update-notifications false

通知を再度有効にするには、次のコマンドを実行します。

dotnetup self update --update-notifications true

例

既定のリリース チャネルから dotnetup を更新します。

dotnetup self update

ダウンロードの進行状況なしで最新の毎日のビルドに更新します。

dotnetup self update --channel daily --no-progress

インストールされている毎日のビルドよりも古い場合でも、最新のプレビュー ビルドに戻ります。

dotnetup self update --channel preview --force

参照

• dotnetup を更新または削除する
• dotnetup がダウンロードを検証する方法
• dotnetup のトラブルシューティング