迁移概述

The Migration section is for teams moving from the legacy .NET CLI (uipcli.exe / dotnet uipcli.dll, calendar-versioned 2025.10 and earlier) to UiPath CLI 1.x (uip, TypeScript on npm). The two CLIs are different binaries with different command shapes, auth models, and output formats — this section gives you the mapping.

If you are starting fresh on 1.x and have no legacy pipelines to migrate, skip this section and go straight to Get started and How-to guides.

The four pages

页面	What it covers	Read it when
Migrating from the legacy .NET CLI	The narrative overview: what changed and why. Headline differences in runtime, distribution, scope, and output.	Read first — sets context for the other three.
Command map	Per-verb mapping (uipcli package pack → uip rpa pack, etc.) with classification (1:1, 2 steps, removed). Before/after snippets.	When you are porting a specific uipcli invocation.
Flag renames	Per-flag mapping inside each verb (--governanceFilePath → --governance-file-path, -A/--accountForApp → --organization, etc.).	When you have a verb mapped but a flag is missing or renamed.
重大变更	Semantic shifts that affect every command: auth modes removed, implicit env-var reading removed, exit-code contract, stdout format.	Before any porting — these apply across the board.

Recommended migration order

For a typical CI pipeline migration:

1. Migrating from the legacy .NET CLI → understand the runtime and distribution change (.NET → Node/Bun, MyGet → npm).
2. Breaking changes → before you change a single line, know what the cross-cutting differences are. Auth alone may break your pipeline.
3. Command map → walk your existing uipcli calls one by one. Note the rows marked 2 steps or N steps — they need new shell logic, not a simple rename.
4. Flag renames → fill in per-flag detail.
5. Then a CI/CD recipe for your platform — copy and adapt.

Quick-start for the impatient

The minimum viable port:

# 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

Full per-flag detail is in Flag renames.

What's not in Migration

• New features in 1.x that have no legacy equivalent (skills, MCP, sessions, JMESPath filtering). Those live in What's new.
• The legacy CLI's documentation. It still lives at the CI/CD integrations docs, which remain canonical for 2025.10 and earlier.

另请参阅

• What's new — headline summary, target audience: anyone deciding whether to migrate.
• Versioning and stability — the contract you can rely on after migrating.
• Authentication — the auth flow your pipeline will use post-migration.