迁移概述

“迁移”部分适用于从旧版.NET CLI （ uipcli.exe / dotnet uipcli.dll 、日历版本的2025.10及更低版本）迁移到UiPath CLI 1.x（ uip 、npm 上的 TypeScript）的团队。这两个 CLI 是不同的二进制文件，具有不同的命令形式、身份验证模型和输出格式 — 本节将为您提供其映射。

如果您是在 1.x 版本上重新开始，并且没有要迁移的旧版管道，请跳过本部分，直接转到“入门指南”和“操作指南” 。

四个页面

页面	涵盖内容	在以下情况下阅读
从旧版 .NET CLI 迁移	记述概述：发生变化的内容及原因。runtime、发行版、作用域和输出方面的显着差异。	先读取 — 为其他三个设置上下文。
命令映射表	按动词进行带分类的映射（ uipcli package pack → uip rpa pack等）（1:1，2 步骤，已移除）。代码片段之前/之后。	当您移植特定的uipcli调用时。
标记重命名	每个动词内基于标志的映射（ --governanceFilePath → --governance-file-path 、 -A/--accountForApp → --organization等）。	映射动词但缺少或重命名标志时。
重大变更	影响每个命令的语义变化：已删除身份验证模式、删除隐式环境变量读取、退出代码合同、标准输出格式。	在进行任何移植之前 — 这些要求全面适用。

建议的迁移顺序

对于典型的 CI 管道迁移：

1. 从旧版 .NET CLI 迁移→ 了解运行时和发行版变化（ .NET → 节点/Bun、MyGet → npm）。
2. 重大变更→ 在更改单个行之前，请了解横向差异有哪些。单独使用身份验证可能会破坏管道。
3. 命令映射表→ 逐个遍历现有的uipcli调用。请注意标记为“2 步骤”或“N 步骤”的行 — 它们需要新的 Shell 逻辑，而不是简单的重命名。
4. 标记重命名→ 填写每个标记的详细信息。
5. 则适用于您平台的CI/CD 秘方— 复制并调整。

适合不耐心等待的人快速入门

最小可行端口：

# Legacy
uipcli package pack <project> -o <out>
uipcli package deploy <pkg> <url> <tenant> -A <org> -I <id> -S <secret> --processName <name>

# New (uip)
uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant <tenant>
uip rpa pack <project>
uip or packages upload <pkg>
uip or processes create --name <name> --package-key <key> --package-version <v> --folder-path Shared

每个标志的完整详细信息位于标志重命名中。

不在迁移中的内容

• 1.x 中没有对等旧版功能的新功能（技能、MCP、会话、JMESPath 筛选）。这些内容位于“新增功能”中。
• 旧版 CLI 文档。它仍位于CI/CD 集成文档中，这些文档在2025.10及更早版本中仍然是规范的。

另请参阅

• 新增功能— 标题摘要，目标受众：决定是否迁移的任何人。
• 版本控制和稳定性— 迁移后可以信赖的合同。
• 身份验证— 您的管道在迁移后将使用的身份验证流程。