Visão geral da migração

Visão geral da migração para equipes que mudam do.NET CLI legado para o UiPath CLI, com links para o mapa de comando, renomeações de sinalizadores, alterações significativas e exemplos de pipeline.

A seção Migração é para equipes que estão migrando do legado .NET CLI (uipcli.exe / dotnet uipcli.dll, com versão de calendário 2025.10 e anterior) para o UiPath CLI 1.x (uip, TypeScript no npm). As duas CLIs são binários diferentes com formas de comando, modelos de autenticação e formatos de saída — esta seção fornece o mapeamento.

Se você estiver começando do zero na versão 1.x e não tiver pipelines legados para migrar, pule esta seção e vá diretamente para os Guias de introdução e Como fazer.

As quatro páginas

Página	O que ela cobre	Leia quando
Migração do.NET CLI legado	A visão geral nativa: o que mudou e por que. Diferenças de destaque no runtime, distribuição, escopo e saída.	Ler primeiro — define o contexto para os outros três.
Mapa de comando	Mapeamento por verbo (uipcli package pack → uip rpa pack etc.) com classificação (1:1, 2 etapas, removido). Fragmentos antes/depois.	Quando você está portando uma invocação uipcli específica.
Renomeações de sinalizadores	Mapeamento por sinalizador dentro de cada verbo (--governanceFilePath → --governance-file-path, -A/--accountForApp → --organization, etc.).	Quando você tem um verbo mapeado, mas um sinalizador está ausente ou é renomeado.
Mudanças de impacto	Deslocamentos semânticos que afetam cada comando: modos de autenticação removidos, leitura implícita de env-var removida, contrato de código de saída, formato stdout.	Antes de qualquer portabilidade — elas se aplicam a toda a linha.

Ordem de migração recomendada

Para uma migração típica do pipeline de CI:

1. Migração do .NET CLI legado → entenda a mudança de runtime e distribuição (.NET → Nó/Bun, MyGet → npm).
2. Mudanças de impacto → antes de alterar uma única linha, saiba quais são as diferenças horizontais. A autenticação somente pode interromper seu pipeline.
3. Mapa de comando → percorra suas chamadas uipcli existentes uma por uma. Observe as linhas marcadas com 2 etapas ou N etapas — elas precisam de uma nova lógica de shell, não de uma simples renomeação.
4. Renomeação de sinalizadores → preencha os detalhes por sinalizador.
5. Em seguida, uma receita de CI/CD para sua plataforma — copie e adapte.

Início rápido para os impaciências

A porta viável mínima:

# 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

O detalhe completo por sinalizador está em Renomeações de sinalizadores.

O que não está em Migração

• Novos recursos na 1.x que não têm equivalente legado (Habilidades, MCP, sessões, filtragem JmesPath). Esses ficam em O que há de novo.
• A documentação da CLI legada. Ele ainda reside nos documentos de integrações de CI/CD, que permanecem canônicos para 2025.10 e anteriores.

Veja também

• O que há de novo — resumo do título, público-alvo: qualquer pessoa que decide migrar.
• Controle de versão e estabilidade — o contrato no qual você pode confiar após a migração.
• Autenticação — o fluxo de autenticação que seu pipeline usará após a migração.