dotnetup を更新または削除する

この記事では、 dotnetup ツール自体を管理する方法について説明します。 dotnetupが管理する.NET SDK とランタイムを更新または削除するには、「インストールの更新」を参照してください。

dotnetup のバージョンを確認する

dotnetupのバージョンを表示：

dotnetup --version

コミット、アーキテクチャ、ランタイム識別子、および検証済みインストールも表示するには、次を実行します。

dotnetup --info

dotnetup の更新

スタンドアロン dotnetup 実行可能ファイルをインプレースで更新するには、次を実行します。

dotnetup self update

このコマンドは dotnetup 0.3.0 プレビュー ビルドで使用できます。 インストールされているバージョン ラベルからリリース チャネルを選択します。 公式の日次ビルドでも preview ラベルが使用されるため、日次ビルドのままにするにはチャネルを明示的に指定します。

dotnetup self update --channel daily

新しい毎日のビルドから最新のパブリック プレビューに戻るには、次を実行します。

dotnetup self update --channel preview --force

--force は、実行可能ファイルをダウングレードまたは再インストールできます。 コマンドのオプションと制限については、 dotnetup self updateを参照してください。

dotnetupを更新しても、.NETのインストール、環境の構成、または追跡されているインストール仕様は変更されません。

以前のバージョンを更新するか、実行ファイルを復元する

お使いのバージョンが self update を認識しない場合、または実行可能ファイルが起動しなくなった場合は、ダウンロード スクリプトをもう一度実行してください。 スクリプトは、選択したインストール ディレクトリ内の既存の実行可能ファイルを置き換えます。

macOS または Linux で、次のコマンドを実行します。

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Windowsで、次のコマンドを実行します。

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

スクリプトは、既定で最新の preview ビルドをインストールします。 daily ビルドまたはカスタム インストール ディレクトリを使用する場合は、最初のインストールに使用したのと同じオプションを指定します。 たとえば、macOS または Linux では次のようになります。

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

Windows の場合:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

更新通知を設定する

対話型インストールおよび更新コマンドが正常に実行されると、dotnetup は新しいビルドが使用可能であることを通知することがあります。 このメッセージでは、更新プログラムをインストールしません。

通知を無効にするには、実行します:

dotnetup self update --update-notifications false

通知を再度有効にするには、--update-notifications true を使用してください。 チェックの頻度と出力の動作については、「 更新通知」を参照してください。

dotnetup を削除する

dotnetupとその管理するすべてのものを削除するには、次の手順を順番に実行します。

1. インストール ルートを見つける

dotnetup が追跡するインストール ルートを一覧表示します。

dotnetup list

dotnetup データ ディレクトリにない各インストール ルートを記録します。 これらのフォルダーは、後の手順で削除します。

2. 環境構成を削除する

dotnetup が PATH と DOTNET_ROOT に加えた変更を削除します。

dotnetup env clear

shell モードで、プロファイル dotnetup が変更されたシェルからこのコマンドを実行するか、--shell オプションでそのシェルを選択します。 Windowsのeverywhere モードでは、このコマンドはシステムのPATHを変更し、昇格を必要とします。

このコマンドでは、SDK やランタイムは削除されません。 詳細については、「 環境構成の削除」を参照してください。

3. インストール ルートとデータ ディレクトリを削除する

手順1で記録した各インストール ルートを削除してください。

次に、dotnetup データ ディレクトリを削除します。 このディレクトリには、既定のインストール ルート、マニフェスト、構成ファイル、ダウンロード キャッシュが含まれています。

DOTNET_DOTNETUP_DATA_DIR 環境変数を設定する場合は、代わりにそのディレクトリを削除してから、その変数を削除します。

4. dotnetup 実行可能ファイルを削除する

dotnetup実行可能ファイルを含むディレクトリを削除してください。 既定では、ダウンロード スクリプトはdotnetupに~/.dotnetupをインストールします。 このディレクトリを手動で PATH に追加した場合は、シェル プロファイルまたはユーザー環境変数からそのエントリを削除します。

更新された環境を使用するには、新しいターミナルを開いてください。

参照

• dotnetup のしくみ
• dotnetup 環境の構成
• dotnetup を使い始める