Средство удаления .NET Core.NET Core Uninstall Tool

Средство удаления .NET Core (dotnet-core-uninstall) позволяет удалять пакеты SDK и среды выполнения .NET Core из системы.The .NET Core Uninstall Tool (dotnet-core-uninstall) lets you remove .NET Core SDKs and Runtimes from a system. Указать версии, которые нужно удалить, можно с помощью ряда параметров.A collection of options is available to specify which versions you want to uninstall.

Это средство поддерживают ОС Windows и macOS.The tool supports Windows and macOS. ОС Linux сейчас не поддерживает это средство.Linux is currently not supported.

В ОС Windows средство может удалять только пакеты SDK и среды выполнения, установленные с помощью одного из следующих установщиков:On Windows, the tool can only uninstall SDKs and Runtimes that were installed using one of the following installers:

  • установщик сред выполнения и пакетов SDK для .NET Core;The .NET Core SDK and runtime installer.
  • установщик Visual Studio более ранних версий, чем Visual Studio 2019 версии 16.3.The Visual Studio installer in versions earlier than Visual Studio 2019 version 16.3.

В macOS средство может удалять только пакеты SDK и среды выполнения, расположенные в папке /usr/local/share/dotnet.On macOS, the tool can only uninstall SDKs and runtimes located in the /usr/local/share/dotnet folder.

Из-за этих ограничений средство не сможет удалить все пакеты SDK и среды выполнения .NET Core на компьютере.Because of these limitations, the tool may not be able to uninstall all of the .NET Core SDKs and runtimes on your machine. Вы можете использовать команду dotnet --info, чтобы найти все установленные пакеты SDK и среды выполнения .NET Core, в том числе те, которые не удается удалить с помощью этого средства.You can use the dotnet --info command to find all of the .NET Core SDKs and runtimes installed, including those SDKs and runtimes that this tool can't remove. Команда dotnet-core-uninstall list позволяет просмотреть, какие пакеты SDK можно удалить с помощью средства.The dotnet-core-uninstall list command displays which SDKs can be uninstalled with the tool.

Установка средстваInstall the tool

Средство удаления .NET Core можно скачать из репозитория GitHub dotnet/cli-lab.You can download the .NET Core Uninstall Tool from the dotnet/cli-lab GitHub repository.

Примечание

Для удаления пакетов SDK и сред выполнения .NET Core средству требуются повышенные права.The tool requires elevation to uninstall .NET Core SDKs and runtimes. Следовательно, его нужно устанавливать в защищенном от записи каталоге, например C:\Program Files в ОС Windows или /usr/local/bin в macOS.Therefore, it should be installed in a write-protected directory such as C:\Program Files on Windows or /usr/local/bin on macOS. Ознакомьтесь также со статьей Повышенные права доступа для команд dotnet.See also Elevated access for dotnet commands. Подробные инструкции по установке доступны на странице выпусков GitHub.Detailed installation instructions are available on the GitHub Releases page.

Запуск программыRun the tool

Шаги ниже демонстрируют рекомендуемый подход к работе со средством удаления.The following steps show the recommended approach for running the uninstall tool:

Шаг 1. Отображение установленных пакетов SDK и сред выполнения .NET CoreStep 1 - Display installed .NET Core SDKs and runtimes

Команда dotnet-core-uninstall list перечисляет установленные пакеты SDK и среды выполнения .NET Core, которые можно удалить с помощью этого средства.The dotnet-core-uninstall list command lists the installed .NET Core SDKs and runtimes that can be removed with this tool. Некоторые пакеты SDK и среды выполнения могут требоваться для работы Visual Studio, и они отображаются с предупреждением о том, почему их не рекомендуется удалять.Some SDKs and runtimes may be required by Visual Studio and they're displayed with a note of why it isn't recommended to uninstall them.

dotnet-core-uninstall listdotnet-core-uninstall list

Краткий обзорSynopsis

dotnet-core-uninstall list [options]

ПараметрыOptions

  • --aspnet-runtime

    Перечисляет все среды выполнения ASP.NET Core, которые можно удалить с помощью этого средства.Lists all the ASP.NET Core runtimes that can be uninstalled with this tool.

  • --hosting-bundle

    Перечисляет все среды выполнения и пакеты размещения .NET Core, которые можно удалить с помощью этого средства.Lists all the .NET Core runtime and hosting bundles that can be uninstalled with this tool.

  • --runtime

    Перечисляет все среды выполнения .NET Core, которые можно удалить с помощью этого средства.Lists all .NET Core runtimes that can be uninstalled with this tool.

  • --sdk

    Перечисляет все пакеты SDK для .NET Core, которые можно удалить с помощью этого средства.Lists all .NET Core SDKs that can be uninstalled with this tool.

  • -v, --verbosity <LEVEL>

    Устанавливает уровень детализации.Sets the verbosity level. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. Значение по умолчанию — normal.The default value is normal.

  • --x64

    Перечисляет все пакеты SDK и среды выполнения .NET Core x64, которые можно удалить с помощью этого средства.Lists all x64 .NET Core SDKs and runtimes that can be uninstalled with this tool.

  • --x86

    Перечисляет все пакеты SDK и среды выполнения .NET Core x86, которые можно удалить с помощью этого средства.Lists all x86 .NET Core SDKs and runtimes that can be uninstalled with this tool.

ПримерыExamples

  • Перечисление всех пакетов SDK и сред выполнения .NET Core, которые можно удалить с помощью этого средства:List all .NET Core SDKs and runtimes that can be removed with this tool:

    dotnet-core-uninstall list
    
  • Перечисление всех пакетов SDK и сред выполнения .NET Core x64:List all x64 .NET Core SDKs and runtimes:

    dotnet-core-uninstall list --x64
    
  • Перечисление всех пакетов SDK для .NET Core x86:List all x86 .NET Core SDKs:

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

Шаг 2. Пробный запускStep 2 - Do a dry run

Команды dotnet-core-uninstall dry-run и dotnet-core-uninstall whatif позволяют просмотреть пакеты SDK и среды выполнения .NET Core, которые будут удалены, на основе указанных параметров без выполнения удаления.The dotnet-core-uninstall dry-run and dotnet-core-uninstall whatif commands display the .NET Core SDKs and runtimes that will be removed based on the options provided without performing the uninstall. Эти синонимичные команды.These commands are synonyms.

dotnet-core-uninstall dry-run and dotnet-core-uninstall whatifdotnet-core-uninstall dry-run and dotnet-core-uninstall whatif

Краткий обзорSynopsis

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

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

АргументыArguments

  • VERSION

    Указанная версия для удаления.The specified version to uninstall. Вы можете перечислить несколько версий одну за другой, разделяя их пробелами.You may list several versions one after the other, separated by spaces. Поддерживаются также файлы ответов.Response files are also supported.

    Совет

    Файлы ответов можно использовать вместо того, чтобы указывать все версии в командной строке.Response files are an alternative to placing all the versions on the command line. Это текстовые файлы, обычно с расширением *.rsp. Каждая версия указывается в отдельной строке.They're text files, typically with a *.rsp extension, and each version is listed on a separate line. Чтобы указать файл ответов для аргумента VERSION, используйте символ @ сразу после имени файла ответа.To specify a response file for the VERSION argument, use the @ character immediately followed by the response file name.

ПараметрыOptions

  • --all

    Удаляет все пакеты SDK и среды выполнения .NET Core.Removes all .NET Core SDKs and runtimes.

  • --all-below <VERSION>

    Удаляет только пакеты SDK и среды .NET Core, версия которых вышла раньше, чем указанная.Removes only the .NET Core SDKs and runtimes with a version smaller than the specified version. Указанная версия не удаляется.The specified version remains installed.

  • --all-but <VERSIONS>

    Удаляет все пакеты SDK и среды выполнения .NET Core, за исключением указанных версий.Removes all .NET Core SDKs and runtimes, except those versions specified.

  • --all-but-latest

    Удаляет пакеты SDK и среды выполнения .NET Core, за исключением самых поздних версий.Removes .NET Core SDKs and runtimes, except the one highest version.

  • --all-lower-patches

    Удаляет пакеты SDK и среды выполнения .NET Core, замененные более поздними исправлениями.Removes .NET Core SDKs and runtimes superseded by higher patches. Этот параметр обеспечивает защиту файла global.json.This option protects global.json.

  • --all-previews

    Удаляет пакеты SDK и среды выполнения .NET Core, помеченные как предварительные версии.Removes .NET Core SDKs and runtimes marked as previews.

  • --all-previews-but-latest

    Удаляет пакеты SDK и среды выполнения .NET Core, помеченные как предварительные версии, за исключением самых поздних.Removes .NET Core SDKs and runtimes marked as previews except the one highest preview.

  • --aspnet-runtime

    Удаляет только среды выполнения ASP.NET Core.Removes ASP.NET Core runtimes only.

  • --hosting-bundle

    Удаляет только среду выполнения и пакеты размещения .NET Core.Removes .NET Core runtime and hosting bundles only.

  • --major-minor <MAJOR_MINOR>

    Удаляет пакеты SDK и среды выполнения .NET Core, соответствующие указанной версии major.minor.Removes .NET Core SDKs and runtimes that match the specified major.minor version.

  • --runtime

    Удаляет только среды выполнения .NET Core.Removes .NET Core runtimes only.

  • --sdk

    Удаляет только пакеты SDK для .NET Core.Removes .NET Core SDKs only.

  • -v, --verbosity <LEVEL>

    Устанавливает уровень детализации.Sets the verbosity level. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. Значение по умолчанию — normal.The default value is normal.

  • --x64

    Необходимо использовать с --sdk, --runtime и --aspnet-runtime для удаления пакетов SDK или сред выполнения x64.Must be used with --sdk, --runtime, and --aspnet-runtime to remove x64 SDKs or runtimes.

  • --x86

    Необходимо использовать с --sdk, --runtime и --aspnet-runtime для удаления пакетов SDK или сред выполнения x86.Must be used with --sdk, --runtime, and --aspnet-runtime to remove x86 SDKs or runtimes.

  • --force Принудительно удаляет версии, которые могут использоваться в Visual Studio.--force Forces removal of versions that might be used by Visual Studio.

Примечания.Notes:

  1. Требуется только один из параметров --sdk, --runtime, --aspnet-runtime или --hosting-bundle.Exactly one of --sdk, --runtime, --aspnet-runtime, and --hosting-bundle is required.
  2. Параметры --all, --all-below, --all-but, --all-but-latest, --all-lower-patches, --all-previews, --all-previews-but-latest, --major-minor и [<VERSION>...] служат для исключения.--all, --all-below, --all-but, --all-but-latest, --all-lower-patches, --all-previews, --all-previews-but-latest, --major-minor, and [<VERSION>...] are exclusive.
  3. Если --x64 или --x86 не указаны, будут удалены обе версии.If --x64 or --x86 aren't specified, then both x64 and x86 will be removed.

ПримерыExamples

Примечание

По умолчанию пакеты SDK и среды выполнения .NET Core, которые могут требоваться для работы Visual Studio или других пакетов SDK, не включаются в выходные данные dotnet-core-uninstall dry-run.By default, .NET Core SDKs and runtimes that may be required by Visual Studio or other SDKs are not included in dotnet-core-uninstall dry-run output. В примерах ниже некоторые указанные пакеты SDK и среды выполнения могут быть исключены из выходных данных в зависимости от состояния компьютера.In the following examples, some of the specified SDKs and runtimes may not be included in the output, depending on the state of the machine. Чтобы включить все пакеты SDK и среды выполнения, укажите их явно в качестве аргументов или используйте параметр --force.To include all SDKs and runtimes, list them explicitly as arguments or use the --force option.

  • Пробный запуск удаления всех сред выполнения .NET Core, замененных более поздними версиями:Dry run of removing all .NET Core runtimes that have been superseded by higher patches:

    dotnet-core-uninstall dry-run --all-lower-patches --runtime
    
  • Пробный запуск удаления всех пакетов SDK для .NET Core, версия которых вышла раньше 2.2.301:Dry run of removing all .NET Core SDKs below the version 2.2.301:

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

Шаг 3. Удаление пакетов SDK и сред выполнения .NET CoreStep 3 - Uninstall .NET Core SDKs and Runtimes

Команда dotnet-core-uninstall remove удаляет пакеты SDK и среды выполнения .NET Core, указанные с использованием коллекции параметров.dotnet-core-uninstall remove uninstalls .NET Core SDKs and Runtimes that are specified by a collection of options. Средство нельзя использовать для удаления пакетов SDK и сред выполнения с версией 5.0 или более поздней.The tool can't be used to uninstall SDKs and Runtimes with version 5.0 or above.

У средства разрушающее поведение, поэтому настоятельно рекомендуется выполнять пробный запуск перед выполнением команды удаления.Since this tool has a destructive behavior, it's highly recommended that you do a dry run before running the remove command. В ходе пробного запуска будут показаны пакеты SDK и среды .NET Core, подлежащие удалению при использовании команды remove.The dry run will show you what .NET Core SDKs and runtimes will be removed when you use the remove command. Чтобы узнать, какие пакеты SDK и среды выполнения безопасно удалять, обратитесь к разделу Нужно ли удалять версию.Refer to Should I remove a version? to learn which SDKs and runtimes are safe to remove.

Внимание!

Учитывайте следующие факторы.Keep in mind the following caveats:

  • Это средство может удалять версии пакета SDK для .NET Core, необходимые для файлов global.json на компьютере.This tool can uninstall versions of the .NET Core SDK that are required by global.json files on your machine. Эти пакеты можно повторно установить, предварительно скачав их на этой странице.You can reinstall .NET Core SDKs from the Download .NET Core page.
  • Средство может удалять версии среды выполнения .NET Core, необходимые для зависимых от платформы приложений на компьютере.This tool can uninstall versions of the .NET Core runtime that are required by framework dependent applications on your machine. Вы можете переустановить среду выполнения .NET Core, предварительно скачав ее с этой страницы.You can reinstall .NET Core runtimes from the Download .NET Core page.
  • Это средство может удалять версии пакета SDK и среды выполнения .NET Core, от которых зависит работа Visual Studio.This tool can uninstall versions of the .NET Core SDK and runtime that Visual Studio relies on. Если нарушите работу установленной версии Visual Studio, выполните команду "Исправить" в установщике Visual Studio, чтобы восстановить рабочее состояние.If you break your Visual Studio installation, run "Repair" in the Visual Studio installer to get back to a working state.

По умолчанию все команды поддерживают пакеты SDK и среды выполнения .NET Core, которые могут потребоваться для работы Visual Studio или других пакетов SDK.By default, all commands keep the .NET Core SDKs and runtimes that may be required by Visual Studio or other SDKs. Эти пакеты и среды выполнения можно удалить путем их явного перечисления в виде аргументов или с использованием параметра --force.These SDKs and runtimes can be uninstalled by listing them explicitly as arguments or by using the --force option.

Для удаления пакетов SDK и сред выполнения .NET Core средству требуются повышенные права.The tool requires elevation to uninstall .NET Core SDKs and runtimes. Запустите средство в командной строке администратора в ОС Windows или с помощью команды sudo в macOS.Run the tool in an Administrator command prompt on Windows and with sudo on macOS. Для команд dry-run и whatif повышение прав не требуется.The dry-run and whatif commands don't require elevation.

dotnet-core-uninstall removedotnet-core-uninstall remove

Краткий обзорSynopsis

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

АргументыArguments

  • VERSION

    Указанная версия для удаления.The specified version to uninstall. Вы можете перечислить несколько версий одну за другой, разделяя их пробелами.You may list several versions one after the other, separated by spaces. Поддерживаются также файлы ответов.Response files are also supported.

    Совет

    Файлы ответов можно использовать вместо того, чтобы указывать все версии в командной строке.Response files are an alternative to placing all the versions on the command line. Это текстовые файлы, обычно с расширением *.rsp. Каждая версия указывается в отдельной строке.They're text files, typically with a *.rsp extension, and each version is listed on a separate line. Чтобы указать файл ответов для аргумента VERSION, используйте символ @ сразу после имени файла ответа.To specify a response file for the VERSION argument, use the @ character immediately followed by the response file name.

ПараметрыOptions

  • --all

    Удаляет все пакеты SDK и среды выполнения .NET Core.Removes all .NET Core SDKs and runtimes.

  • --all-below <VERSION>

    Удаляет только пакеты SDK и среды .NET Core, версия которых вышла раньше, чем указанная.Removes only the .NET Core SDKs and runtimes with a version smaller than the specified version. Указанная версия не удаляется.The specified version remains installed.

  • --all-but <VERSIONS>

    Удаляет все пакеты SDK и среды выполнения .NET Core, за исключением указанных версий.Removes all .NET Core SDKs and runtimes, except those versions specified.

  • --all-but-latest

    Удаляет пакеты SDK и среды выполнения .NET Core, за исключением самых поздних версий.Removes .NET Core SDKs and runtimes, except the one highest version.

  • --all-lower-patches

    Удаляет пакеты SDK и среды выполнения .NET Core, замененные более поздними исправлениями.Removes .NET Core SDKs and runtimes superseded by higher patches. Этот параметр обеспечивает защиту файла global.json.This option protects global.json.

  • --all-previews

    Удаляет пакеты SDK и среды выполнения .NET Core, помеченные как предварительные версии.Removes .NET Core SDKs and runtimes marked as previews.

  • --all-previews-but-latest

    Удаляет пакеты SDK и среды выполнения .NET Core, помеченные как предварительные версии, за исключением самых поздних.Removes .NET Core SDKs and runtimes marked as previews except the one highest preview.

  • --aspnet-runtime

    Удаляет только среды выполнения ASP.NET Core.Removes ASP.NET Core runtimes only.

  • --hosting-bundle

    Удаляет только среду выполнения и пакеты размещения .NET Core.Removes .NET Core runtime and hosting bundles only.

  • --major-minor <MAJOR_MINOR>

    Удаляет пакеты SDK и среды выполнения .NET Core, соответствующие указанной версии major.minor.Removes .NET Core SDKs and runtimes that match the specified major.minor version.

  • --runtime

    Удаляет только среды выполнения .NET Core.Removes .NET Core runtimes only.

  • --sdk

    Удаляет только пакеты SDK для .NET Core.Removes .NET Core SDKs only.

  • -v, --verbosity <LEVEL>

    Устанавливает уровень детализации.Sets the verbosity level. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. Значение по умолчанию — normal.The default value is normal.

  • --x64

    Необходимо использовать с --sdk, --runtime и --aspnet-runtime для удаления пакетов SDK или сред выполнения x64.Must be used with --sdk, --runtime, and --aspnet-runtime to remove x64 SDKs or runtimes.

  • --x86

    Необходимо использовать с --sdk, --runtime и --aspnet-runtime для удаления пакетов SDK или сред выполнения x86.Must be used with --sdk, --runtime, and --aspnet-runtime to remove x86 SDKs or runtimes.

  • -y, --yes Выполняет команду без подтверждения Yes или No.-y, --yes Executes the command without requiring a yes or no confirmation.

  • --force Принудительно удаляет версии, которые могут использоваться в Visual Studio.--force Forces removal of versions that might be used by Visual Studio.

Примечания.Notes:

  1. Требуется только один из параметров --sdk, --runtime, --aspnet-runtime или --hosting-bundle.Exactly one of --sdk, --runtime, --aspnet-runtime, and --hosting-bundle is required.
  2. Параметры --all, --all-below, --all-but, --all-but-latest, --all-lower-patches, --all-previews, --all-previews-but-latest, --major-minor и [<VERSION>...] служат для исключения.--all, --all-below, --all-but, --all-but-latest, --all-lower-patches, --all-previews, --all-previews-but-latest, --major-minor, and [<VERSION>...] are exclusive.
  3. Если --x64 или --x86 не указаны, будут удалены обе версии.If --x64 or --x86 aren't specified, then both x64 and x86 will be removed.

ПримерыExamples

Примечание

По умолчанию пакеты SDK и среды выполнения .NET Core, которые могут требоваться для работы Visual Studio или других пакетов SDK, сохраняются.By default, .NET Core SDKs and runtimes that may be required by Visual Studio or other SDKs are kept. В примерах ниже могут остаться некоторые из указанных пакетов SDK и сред выполнения в зависимости от состояния компьютера.In the following examples, some of the specified SDKs and runtimes may remain, depending on the state of the machine. Чтобы удалить все пакеты и среды выполнения, укажите их явно в качестве аргументов или используйте параметр --force.To remove all SDKs and runtimes, list them explicitly as arguments or use the --force option.

  • Удаление всех сред выполнения .NET Core, кроме версии 3.0.0-preview6-27804-01 без подтверждения Yes или No:Remove all .NET Core runtimes except the version 3.0.0-preview6-27804-01 without requiring Y/N confirmation:

    dotnet-core-uninstall remove --all-but 3.0.0-preview6-27804-01 --runtime --yes
    
  • Удаление всех пакетов SDK для .NET Core 1.1 без подтверждения Yes или No:Remove all .NET Core 1.1 SDKs without requiring Y/n confirmation:

    dotnet-core-uninstall remove --sdk --major-minor 1.1 -y
    
  • Удаление пакета SDK для .NET Core 1.1.11 без вывода на консоль:Remove the .NET Core 1.1.11 SDK with no console output:

    dotnet-core-uninstall remove 1.1.11 --sdk --yes --verbosity q
    
  • Удаление всех пакетов SDK для .NET Core, которые можно безопасно удалить с помощью этого средства:Remove all .NET Core SDKs that can safely be removed by this tool:

    dotnet-core-uninstall remove --all --sdk
    
  • Удаление всех пакетов SDK для .NET Core, которые можно безопасно удалить с помощью этого средства, в том числе тех, которые могут требоваться для работы Visual Studio (не рекомендуется):Remove all .NET Core SDKs that can be removed by this tool, including those SDKs that may be required by Visual Studio (not recommended):

    dotnet-core-uninstall remove --all --sdk --force
    
  • Удаление всех пакетов SDK для .NET Core, указанных в файле ответов versions.rsp:Remove all .NET Core SDKs that are specified in the response file versions.rsp

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

    В файле versions.rsp содержится следующее:The content of versions.rsp is as follows:

    2.2.300
    2.1.700
    

Шаг 4. Удаление резервной папки NuGet (необязательный)Step 4 - Delete the NuGet fallback folder (optional)

В некоторых случаях папка NuGetFallbackFolder может больше не требоваться, и ее понадобится удалить.In some cases, you no longer need the NuGetFallbackFolder and may wish to delete it. Дополнительные сведения об удалении папки NuGetFallbackFolder см. в этом разделе.For more information about deleting this folder, see Remove the NuGetFallbackFolder.

Удаление средстваUninstall the tool

  1. Откройте окно Установка и удаление программ.Open Add or Remove Programs.
  2. Найдите Microsoft .NET Core SDK Uninstall Tool.Search for Microsoft .NET Core SDK Uninstall Tool.
  3. Выберите Удалить.Select Uninstall.