.NET アンインストール ツール

  • [アーティクル]

.NET アンインストール ツール (dotnet-core-uninstall) を使用すると、.NET SDK とランタイムをシステムから削除できます。 一連のオプションを使用して、アンインストールするバージョンを指定できます。

このツールでは、Windows と macOS がサポートされています。 Linux は現在サポートされていません。

Windows では、ツールは次のいずれかのインストーラーを使用してインストールされた SDK とランタイムのみをアンインストールできます。

  • .NET SDK およびランタイム インストーラー。
  • Visual Studio 2019 バージョン 16.3 より前のバージョンの Visual Studio インストーラー。

macOS では、このツールでアンインストールできるのは /usr/local/share/dotnet フォルダーにある SDK とランタイムのみです。

これらの制限のため、このツールでは、コンピューター上の一部の .NET SDK とランタイムをアンインストールできない可能性があります。 dotnet --info コマンドを使用して、インストールされているすべての .NET SDK とランタイム (このツールで削除できない SDK やランタイムを含む) を見つけることができます。 dotnet-core-uninstall list コマンドを実行すると、このツールでアンインストールできる SDK が表示されます。

Note

現在、.NET アンインストール ツールでは .NET 8 以降はサポートされていません。 このツールのリリース スケジュールの詳細については、「GitHub - dotnet-uninstall-tool ロードマップ」を参照してください。

ツールをインストールする

.NET アンインストール ツールは、ツールのリリース ページからダウンロードできます。また、ソース コードは dotnet/cli-lab GitHub リポジトリにあります。

Note

このツールでは、.NET SDK とランタイムをアンインストールするために昇格が必要です。 そのため、Windows では C:\Program Files、macOS では /usr/local/bin などの書き込み保護されたディレクトリにインストールする必要があります。 詳細については、「dotnet コマンドの特権アクセス」と詳細なインストール手順に関するページを参照してください。

ツールを実行します。

次の手順は、アンインストール ツールを実行するための推奨方法を示しています。

手順 1 - インストールされている .NET SDK とランタイムを表示する

dotnet-core-uninstall list コマンドを実行すると、このツールで削除できる、インストールされている .NET SDK とランタイムが一覧表示されます。 一部の SDK とランタイムは、Visual Studio で必要な場合があり、それらのアンインストールが推奨されない理由を示す注釈と共に表示されます。

Note

dotnet-core-uninstall list コマンドの出力は、ほとんどの場合、dotnet --info で出力されるインストールされているバージョンの一覧と一致しません。 具体的には、このツールでは、zip ファイルによってインストールされたバージョンや、Visual Studio によって管理されているバージョン (Visual Studio 2019 バージョン 16.3 以降を使用してインストールされたバージョン) は表示されません。 バージョンが Visual Studio によって管理されているかどうかを確認する方法の 1 つは、これを Add or Remove Programs で表示することです。そこでは、Visual Studio によって管理されているバージョンの表示名にそれを示すマークが付きます。

詳細については、この記事で後述する「list コマンド」を参照してください。

手順 2 - ドライ ランを実行する

dotnet-core-uninstall dry-run および dotnet-core-uninstall whatif コマンドでは、アンインストールを実行せずに指定されたオプションに基づいて削除される .NET SDK とランタイムを表示します。 これらのコマンドはシノニムです。

詳細については、この記事で後述する「dry-run コマンドと whatif コマンド」を参照してください。

手順 3 - .NET SDK とランタイムをアンインストールする

dotnet-core-uninstall remove では、一連のオプションによって指定された .NET SDK とランタイムをアンインストールします。

このツールには破壊的動作があるため、remove コマンドを実行する前に、ドライ ランを実行することを強くお勧めします。 ドライ ランにより、remove コマンドを使用したときに削除される .NET SDK とランタイムが示されます。 削除しても安全な SDK とランタイムを確認するには、「バージョンを削除する必要はあるか」を参照してください。

注意事項

次の注意事項に留意してください。

  • このツールでは、コンピューター上の global.json ファイルに必要な .NET SDK のバージョンをアンインストールできます。 .NET SDK は、.NET のダウンロード ページから再インストールできます。
  • このツールでは、コンピューター上のフレームワークに依存するアプリケーションに必要な .NET ランタイムのバージョンをアンインストールできます。 .NET ランタイムは、.NET のダウンロード ページから再インストールできます。
  • このツールでは、Visual Studio が依存する .NET SDK とランタイムのバージョンをアンインストールできます。 Visual Studio のインストールを中断した場合は、Visual Studio インストーラーで [修復] を実行すると稼働状態に戻ります。

既定で、すべてのコマンドでは、Visual Studio またはその他の SDK に必要な可能性がある .NET SDK とランタイムを保持します。 これらの SDK とランタイムは、引数として明示的に指定するか、--force オプションを使用することによってアンインストールできます。

このツールでは、.NET SDK とランタイムをアンインストールするために昇格が必要です。 Windows では管理者コマンド プロンプトで、macOS では sudo を使用してツールを実行してください。 dry-run および whatif コマンドには、昇格は必要ありません。

詳細については、この記事で後述する「remove コマンド」を参照してください。

手順 4 - NuGet フォールバック フォルダーを削除する (省略可能)

場合によっては、NuGetFallbackFolder が不要になり、削除することもできます。 詳細については、NuGetFallbackFolder の削除に関する記事を参照してください。

ツールをアンインストールする

  1. [プログラムの追加と削除] を開きます。
  2. Microsoft .NET SDK Uninstall Tool を検索します。
  3. [アンインストール] を選択します。

list コマンド

構文

dotnet-core-uninstall list [options]

オプション

  • --aspnet-runtime

    このツールでアンインストールできるすべての ASP.NET ランタイムを一覧表示します。

  • --hosting-bundle

    このツールでアンインストールできるすべての .NET ホスティング バンドルを一覧表示します。

  • --runtime

    このツールでアンインストールできるすべての .NET ランタイムを一覧表示します。

  • --sdk

    このツールでアンインストールできるすべての .NET SDK を一覧表示します。

  • -v, --verbosity <LEVEL>

    詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 既定値は normal です。

  • --x64

    このツールでアンインストールできるすべての x64 .NET SDK とランタイムを一覧表示します。

  • --x86

    このツールでアンインストールできるすべての x86 .NET SDK とランタイムを一覧表示します。

例

  • このツールで削除できるすべての .NET SDK とランタイムを一覧表示します。

    dotnet-core-uninstall list

  • すべての x64 .NET SDK とランタイムを一覧表示します。

    dotnet-core-uninstall list --x64

  • すべての x86 .NET SDK を一覧表示します。

    dotnet-core-uninstall list --sdk --x86

dry-run および whatif コマンド

構文

dotnet-core-uninstall dry-run [options] [<VERSION>...]

dotnet-core-uninstall whatif [options] [<VERSION>...]

引数

VERSION

アンインストールする指定されたバージョン。 スペースで区切って、複数のバージョンを順々に指定できます。 応答ファイルもサポートされています。

ヒント

すべてのバージョンをコマンド ラインに指定する代わりに応答ファイルを使用できます。 それらはテキスト ファイルで、通常、*.rsp 拡張子が付いています。各バージョンは別々の行に指定されます。 VERSION 引数の応答ファイルを指定するには、@ 文字を使用し、そのすぐ後に応答ファイル名を指定します。

オプション

  • --all

    すべての .NET SDK とランタイムを削除します。

  • --all-below <VERSION>[ <VERSION>...]

    指定されたバージョンよりも小さいバージョンの .NET SDK とランタイムのみを削除します。 指定したバージョンはインストールされたままになります。

  • --all-but <VERSIONS>[ <VERSION>...]

    指定されたバージョンを除く、すべての .NET SDK とランタイムを削除します。

  • --all-but-latest

    最上位のバージョンを除く、すべての .NET SDK とランタイムを削除します。

  • --all-lower-patches

    上位の修正プログラムによって置き換えられた .NET SDK とランタイムを削除します。 このオプションでは、global. json ファイルを保護します。

  • --all-previews

    プレビューとしてマークされている .NET SDK とランタイムを削除します。

  • --all-previews-but-latest

    最上位のプレビューを除き、プレビューとしてマークされているすべての .NET SDK とランタイムを削除します。

  • --aspnet-runtime

    ASP.NET ランタイムのみを削除します。

  • --hosting-bundle

    .NET ランタイムとホスティングのバンドルのみを削除します。

  • --major-minor <MAJOR_MINOR>

    指定された major.minor バージョンに一致する .NET SDK とランタイムを削除します。

  • --runtime

    .NET ランタイムのみを削除します。

  • --sdk

    .NET SDK のみを削除します。

  • -v, --verbosity <LEVEL>

    詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 既定値は normal です。

  • --x64

    x64 SDK またはランタイムを削除するには、--sdk、--runtime、および --aspnet-runtime と共に使用する必要があります。

  • --x86

    x86 SDK またはランタイムを削除するには、--sdk、--runtime、および --aspnet-runtime と共に使用する必要があります。

  • --force

    Visual Studio によって使用される可能性があるバージョンを強制的に削除します。

Note

  • --sdk、--runtime、--aspnet-runtime、および --hosting-bundle の 1 つだけが必要です。
  • --all、--all-below、--all-but、--all-but-latest、--all-lower-patches、--all-previews、--all-previews-but-latest、--major-minor、および [<VERSION>...] は排他的です。
  • --x64 または --x86 が指定されていない場合は、x64 と x86 の両方が削除されます。

例

Note

既定では、Visual Studio またはその他の SDK に必要な可能性がある .NET SDK とランタイムは dotnet-core-uninstall dry-run 出力には含まれません。 次の例では、コンピューターの状態によっては、指定された SDK とランタイムの一部が出力に含まれない可能性があります。 すべての SDK とランタイムを含めるには、それらを引数として明示的に指定するか、--force オプションを使用してください。

  • 上位の修正プログラムによって置き換えられたすべての .NET ランタイムを削除するドライ ラン。

    dotnet-core-uninstall dry-run --all-lower-patches --runtime

  • バージョン 2.2.301 より下のすべての .NET SDK を削除するドライ ラン。

    dotnet-core-uninstall whatif --all-below 2.2.301 --sdk

remove コマンド

構文

dotnet-core-uninstall remove [options] [<VERSION>...]

引数

VERSION

アンインストールする指定されたバージョン。 スペースで区切って、複数のバージョンを順々に指定できることがあります。 応答ファイルもサポートされています。

ヒント

すべてのバージョンをコマンド ラインに指定する代わりに応答ファイルを使用できます。 それらはテキスト ファイルで、通常、*.rsp 拡張子が付いています。各バージョンは別々の行に指定されます。 VERSION 引数の応答ファイルを指定するには、@ 文字を使用し、そのすぐ後に応答ファイル名を指定します。

オプション

  • --all

    すべての .NET SDK とランタイムを削除します。

  • --all-below <VERSION>[ <VERSION>...]

    指定されたバージョンよりも小さいバージョンの .NET SDK とランタイムのみを削除します。 指定したバージョンはインストールされたままになります。

  • --all-but <VERSIONS>[ <VERSION>...]

    指定されたバージョンを除く、すべての .NET SDK とランタイムを削除します。

  • --all-but-latest

    最上位のバージョンを除く、すべての .NET SDK とランタイムを削除します。

  • --all-lower-patches

    上位の修正プログラムによって置き換えられた .NET SDK とランタイムを削除します。 このオプションでは、global. json ファイルを保護します。

  • --all-previews

    プレビューとしてマークされている .NET SDK とランタイムを削除します。

  • --all-previews-but-latest

    最上位のプレビューを除き、プレビューとしてマークされているすべての .NET SDK とランタイムを削除します。

  • --aspnet-runtime

    ASP.NET ランタイムのみを削除します。

  • --hosting-bundle

    .NET ホスティングのバンドルのみを削除します。

  • --major-minor <MAJOR_MINOR>

    指定された major.minor バージョンに一致する .NET SDK とランタイムを削除します。

  • --runtime

    .NET ランタイムのみを削除します。

  • --sdk

    .NET SDK のみを削除します。

  • -v, --verbosity <LEVEL>

    詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 既定値は normal です。

  • --x64

    x64 SDK またはランタイムを削除するには、--sdk、--runtime、および --aspnet-runtime と共に使用する必要があります。

  • --x86

    x86 SDK またはランタイムを削除するには、--sdk、--runtime、および --aspnet-runtime と共に使用する必要があります。

  • -y, --yes

    Yes または No の確認を要求せずにコマンドを実行します。

  • --force

    Visual Studio によって使用される可能性があるバージョンを強制的に削除します。

Note

  • --sdk、--runtime、--aspnet-runtime、および --hosting-bundle の 1 つだけが必要です。
  • --all、--all-below、--all-but、--all-but-latest、--all-lower-patches、--all-previews、--all-previews-but-latest、--major-minor、および [<VERSION>...] は排他的です。
  • --x64 または --x86 が指定されていない場合は、x64 と x86 の両方が削除されます。

例

Note

既定で、Visual Studio またはその他の SDK に必要な可能性がある .NET SDK とランタイムは保持されます。 次の例では、コンピューターの状態によっては、指定された SDK とランタイムの一部が保持される可能性があります。 すべての SDK とランタイムを削除するには、それらを引数として明示的に指定するか、--force オプションを使用してください。

  • "はい" または "いいえ" の確認を要求せずに、バージョン 3.0.0-preview6-27804-01 を除くすべての .NET ランタイムを削除します。

    dotnet-core-uninstall remove --all-but 3.0.0-preview6-27804-01 --runtime --yes

  • "はい" または "いいえ" の確認を要求せずに、すべての .NET Core 1.1 SDK を削除します。

    dotnet-core-uninstall remove --sdk --major-minor 1.1 -y

  • コンソールに出力せずに、.NET Core 1.1.11 SDK を削除します。

    dotnet-core-uninstall remove 1.1.11 --sdk --yes --verbosity q

  • このツールで安全に削除できるすべての .NET SDK を削除します。

    dotnet-core-uninstall remove --all --sdk

  • Visual Studio で必要な可能性がある SDK を含め、このツールで削除できるすべての .NET SDK を削除します (推奨されません)。

    dotnet-core-uninstall remove --all --sdk --force

  • versions.rsp に指定されたすべての .NET SDK を削除します。

    dotnet-core-uninstall remove --sdk @versions.rsp

    versions.rsp ファイルの内容は次のとおりです。

    2.2.300
2.1.700