.NET 卸载工具 dry-run 命令详解

.NET 卸载工具 dry-run 命令详解

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

概述

dotnet-core-uninstall dry-run 是 .NET 卸载工具包含的一个测试性命令，它允许开发者在实际执行卸载操作前，预览哪些 .NET SDK 或运行时将被移除。这个命令对于系统维护和版本管理非常有用，可以避免意外删除重要组件。

命令基本语法

Windows 系统

dotnet-core-uninstall dry-run <TARGET> [--x64|--x86] <VERSION>...
    [-v|--verbosity <LEVEL>] [--force]

dotnet-core-uninstall dry-run <TARGET> [--x64|--x86] <FILTER>
    [-v|--verbosity <LEVEL>]

macOS 系统

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

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

核心参数解析

TARGET 参数

指定要卸载的目标类型，可选值包括：

• --runtime：.NET 运行时
• --sdk：.NET SDK
• --aspnet-runtime：ASP.NET Core 运行时（仅Windows）
• --hosting-bundle：.NET 托管捆绑包（仅Windows）

VERSION 参数

指定要卸载的具体版本号，可以同时指定多个版本，用空格分隔。也支持使用响应文件（.rsp 文件）批量指定版本。

FILTER 参数

提供了一组强大的筛选条件，可以批量选择要卸载的版本：

1. --all：卸载所有匹配的版本
2. --all-below <VERSION>：卸载低于指定版本的所有版本
3. --all-but <VERSION>：卸载除指定版本外的所有版本
4. --all-but-latest：卸载除最新版本外的所有版本
5. --all-lower-patches：卸载已被更高补丁版本取代的版本
6. --all-previews：卸载所有预览版
7. --all-previews-but-latest：卸载除最新预览版外的所有预览版
8. --major-minor <MAJOR_MINOR>：卸载指定主次版本的所有版本

实用选项

• --force：强制包含可能被 Visual Studio 使用的版本
• -v|--verbosity：设置输出详细级别（quiet/minimal/normal/detailed/diagnostic）
• -h|--help|-?：显示帮助信息

使用场景示例

场景一：预览将被更高补丁版本取代的运行时

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

这个命令会显示所有可以被更高补丁版本取代的 .NET 运行时，但不会实际执行卸载。

场景二：预览低于特定版本的所有 SDK

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

注意：whatif 是 dry-run 的别名，功能完全相同。

注意事项

1. 默认情况下，可能被 Visual Studio 或其他 SDK 依赖的版本不会包含在 dry-run 结果中
2. 使用 --force 选项可以覆盖这一保护机制
3. 系统状态可能影响 dry-run 的结果，某些指定版本可能不会出现在输出中
4. 对于关键生产环境，建议先执行 dry-run 确认后再执行实际卸载

最佳实践

1. 在执行实际卸载前，总是先使用 dry-run 命令预览将要发生的变更
2. 对于复杂的卸载场景，可以先使用 dotnet-core-uninstall list 命令查看当前安装的所有版本
3. 考虑使用响应文件管理大量版本的卸载操作
4. 在自动化脚本中，dry-run 可以作为安全检查步骤

通过合理使用 dry-run 命令，开发者可以安全地管理 .NET 环境，避免因误操作导致的环境问题。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs