本文适用于：✔️ .NET Core 2.x SDK
“属性”
dotnet migrate - 将预览版 2 .NET Core 项目迁移到 .NET Core SDK 样式的项目中。
摘要
dotnet migrate [<SOLUTION_FILE|PROJECT_DIR>] [--format-report-file-json <REPORT_FILE>]
[-r|--report-file <REPORT_FILE>] [-s|--skip-project-references [Debug|Release]]
[--skip-backup] [-t|--template-file <TEMPLATE_FILE>] [-v|--sdk-package-version]
[-x|--xproj-file]
dotnet migrate -h|--help
描述
此命令已弃用。 自 .NET Core 3.0 SDK 起，dotnet migrate 命令不再可用。 它只能将预览版 2 .NET Core 项目迁移到不支持的 1.x .NET Core 项目。
默认情况下，命令迁移根项目和根项目包含的任何项目引用。 在运行时使用 --skip-project-references 选项禁用此行为。
可在下列资产上执行迁移：
通过指定 project.json 文件进行迁移的单个项目。
通过将路径传递到 global.json 文件在 global.json 文件中指定的所有目录。
一个 solution.sln 文件，它迁移在解决方案中引用的项目。
以递归方式迁移给定目录的所有子目录。
dotnet migrate 命令将迁移的 project.json 文件保存在 backup 目录中，如果该目录不存在，将创建一个。 使用 --skip-backup 选项重写此行为。
默认情况下，迁移操作会将迁移过程的状态输出到标准输出 (STDOUT)。 如果使用 --report-file <REPORT_FILE> 选项，输出将保存到指定的文件中。
dotnet migrate 命令仅支持有效的预览版 2 基于 project.json 的项目。 这意味着，不能使用它将 DNX 或预览版 1 基于 project.json 的项目直接迁移到 MSBuild/csproj 项目。 首先需要将项目手动迁移到预览版 2 基于 project.json 的项目，然后使用 dotnet migrate 命令迁移该项目。
自变量
PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR
下列路径之一：
要迁移的 project.json 文件。
global.json 文件：迁移在 global.json 中指定的文件夹 。
solution.sln 文件：迁移该解决方案中引用的项目。
要迁移的目录：在指定的目录中以递归方式搜索要迁移的 project.json 文件。
如未指定，则默认为当前目录。
选项
--format-report-file-json <REPORT_FILE>
将迁移报告文件（而非用户消息）作为 JSON 输出。
-h|--help
打印出有关命令的简短帮助。
-r|--report-file <REPORT_FILE>
除控制台外，还将迁移报告输出到文件。
-s|--skip-project-references [Debug|Release]
跳过迁移项目引用。 默认情况下，以递归方式迁移项目引用。
--skip-backup
在成功迁移后，跳过将 project.json、global.json 和 *.xproj 移动到 backup 目录的步骤。
-t|--template-file <TEMPLATE_FILE>
用于迁移的模板 csproj 文件。 默认情况下，使用与被 dotnet new console 删除的模板相同的模板。
-v|--sdk-package-version <VERSION>
在已迁移应用中将被引用的 sdk 包的版本。 默认为 dotnet new 中 SDK 的版本。
-x|--xproj-file <FILE>
要使用的 xproj 文件的路径。 当项目目录中有多个 xproj 时需要。
示例
将当前目录中的项目及其所有项目迁移到项目依赖项：
dotnet migrate
迁移 global.json 文件所包含的所有项目：
dotnet migrate path/to/global.json
仅迁移当前项目，不迁移项目到项目 (P2P) 的依赖项。 此外，使用特定的 SDK 版本：
dotnet migrate -s -v 1.0.0-preview4
