Editéieren

dotnet-core-uninstall remove

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



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

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

dotnet-core-uninstall remove <TARGET> <FILTER> [-v|--verbosity <LEVEL>]
    [--force] [-y|--yes] [--preserve-vs-for-mac-sdks]

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

  • --arm64

    Can be used with --sdk, --runtime, --aspnet-runtime, and --windows-desktop-runtime to remove arm64.

  • --aspnet-runtime

    Removes ASP.NET Core runtimes only.

  • --hosting-bundle

    Removes .NET runtime and hosting bundles only.

  • --runtime

    Removes .NET runtimes only.

  • --sdk

    Removes .NET SDKs only.

  • --windows-desktop-runtime

    Removes Windows Desktop runtimes only.

  • --x64

    Can be used with --sdk, --runtime, --aspnet-runtime, and --windows-desktop-runtime to remove x64.

  • --x86

    Can be used with --sdk, --runtime, --aspnet-runtime, and --windows-desktop-runtime to remove x86.

  • --runtime

    Removes .NET runtimes only.

  • --sdk

    Removes .NET SDKs only.

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.

::: zone-end

  • --force

    Forces removal of versions that might be used by Visual Studio for Mac or SDKs.

  • --preserve-vs-for-mac-sdks

    Prevents removal of SDKs and runtimes that have a high probability of being used by Visual Studio for Mac.

    Note

    Visual Studio for Mac is out of support.

  • -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:

    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:

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

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

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

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

    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):

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

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

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

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

    2.2.300
6.0.301

See also

  • Last updated on