dotnet-core-uninstall remove

Choose an operating system

Windows macOS

This article applies to: ✔️ .NET Uninstall Tool 1.7.521001 and later versions

Name

dotnet-core-uninstall remove - Remove the specified .NET SDKs or Runtimes.

Synopsis

.NET CLI

dotnet-core-uninstall remove <TARGET> [--x64|--x86] <VERSION>...
    [-v|--verbosity <LEVEL>] [--force] [-y|--yes]

dotnet-core-uninstall remove <TARGET> [--x64|--x86] <FILTER>
    [-v|--verbosity <LEVEL>] [--force] [-y|--yes]

dotnet-core-uninstall remove -h|--help|-?

.NET CLI

dotnet-core-uninstall remove <TARGET> <VERSION>...
    [-v|--verbosity <LEVEL>] [--force] [-y|--yes]

dotnet-core-uninstall remove <TARGET> <FILTER>
    [-v|--verbosity <LEVEL>] [--force] [-y|--yes]

dotnet-core-uninstall remove -h|--help|-?

Description

The dotnet-core-uninstall remove command removes .NET SDKs and runtimes from the host machine.

Arguments

TARGET

The type you want to uninstall. Valid options are listed in the Options - TARGET section.

VERSION

The version to uninstall. You can list several versions separated by a space. Response files are also supported.

Tip

Response files are an alternative to placing all the versions on the command line. They're text files, typically with a *.rsp extension, and each version is listed on a separate line. To specify a response file for the VERSION argument, use the @ character immediately followed by the response file name.

FILTER

Specifies a value used to filter the TARGET. Valid options are listed in the Options - FILTER section.

Options - TARGET

• --aspnet-runtime

  Discovers all the ASP.NET Core runtimes that can be uninstalled with this tool.

• --hosting-bundle

  Lists all the .NET hosting bundles that can be uninstalled with this tool.

• --runtime

  Lists all the .NET runtimes that can be uninstalled with this tool.

• --sdk

  Lists all the .NET SDKs that can be uninstalled with this tool.

• --x64

  Lists all the x64 .NET SDKs and runtimes that can be uninstalled with this tool.

  Note

  If --x64 or --x86 isn't specified, then both x64 and x86 will be removed.

• --x86

  Lists all the x86 .NET SDKs and runtimes that can be uninstalled with this tool.

  Note

  If --x64 or --x86 isn't specified, then both x64 and x86 will be removed.

Options - FILTER

These options are exclusive.

• --all

  Removes all the .NET SDKs and runtimes.

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

  Removes only the .NET SDKs and runtimes with a version smaller than the specified version. The specified version remains installed.

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

  Removes all the .NET SDKs and runtimes, except those versions specified.

• --all-but-latest

  Removes the .NET SDKs and runtimes, except the highest version.

• --all-lower-patches

  Removes the .NET SDKs and runtimes superseded by higher patches. This option protects global.json file.

• --all-previews

  Removes the .NET SDKs and runtimes marked as previews.

• --all-previews-but-latest

  Removes the .NET SDKs and runtimes marked as previews except the highest preview.

• --major-minor <MAJOR_MINOR>

  Removes the .NET SDKs and runtimes that match the specified major.minor version.

Options

• -y, --yes

  Executes the command without requiring a yes or no confirmation.

• --force

  Forces removal of versions that might be used by Visual Studio.

• -v, --verbosity <LEVEL>

  Sets the verbosity level. The default value is normal. Allowed values are:

  • q[uiet]
  • m[inimal]
  • n[ormal]
  • d[etailed]
  • diag[nostic].

• -?|-h|--help

  Shows help and usage information

Examples

Note

By default, .NET SDKs and runtimes that might be required by Visual Studio or other SDKs are kept. In the following examples, and depending on the state of the machine, some of the specified SDKs and runtimes might remain. To remove all the SDKs and runtimes, list them explicitly as arguments or use the --force option.

• Remove all the .NET runtimes except the version 3.0.0-preview6-27804-01 without requiring yes or no confirmation:

  Console

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

• Remove all the .NET Core 1.1 SDKs without requiring yes or no confirmation:

  Console

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

• Remove the .NET 6.0.301 SDK with no console output:

  Console

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

• Remove all the .NET SDKs that can be safely removed by this tool:

  Console

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

• Remove all the .NET SDKs that can be removed by this tool, including those SDKs that might be required by Visual Studio (not recommended):

  Console

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

• Remove all the .NET SDKs that are specified in the versions.rsp response file:

  Console

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

  The content of the versions.rsp file is as follows:

  text

  2.2.300
  6.0.301
  

See also

• .NET uninstall tool overview
• dotnet-core-uninstall list
• dotnet-core-uninstall dry-run