Información general sobre la migración

La sección Migración es para los equipos que migran del .NET CLI heredado (uipcli.exe / dotnet uipcli.dll, versión de calendario 2025.10 y anteriores) a UiPath CLI 1.x (uip, TypeScript en npm). Los dos CLI son binarios diferentes con diferentes formas de comando, modelos de autenticación y formatos de salida: esta sección te proporciona la asignación.

Si estás empezando desde cero en 1.x y no tienes procesos heredados para migrar, omite esta sección y ve directamente a las guías Primeros pasos y Tutoriales.

Las cuatro páginas

Página	Qué cubre	Leerlo cuando
Migrar desde la CLI de .NET heredada	La descripción general de la narración: qué cambió y por qué. Diferencias de encabezado en runtime, distribución, ámbito y salida.	Leer primero: establece el contexto para los otros tres.
Mapa de comandos	Asignación por verbo (uipcli package pack → uip rpa pack, etc.) con clasificación (1:1, 2 pasos, eliminado). Fragmentos antes/después.	Al portar una invocación uipcli específica.
Marcar cambios de nombre	Asignación por bandera dentro de cada verbo (--governanceFilePath → --governance-file-path, -A/--accountForApp → --organization, etc.).	Cuando tienes un verbo asignado, pero falta un marcador o se ha cambiado su nombre.
Cambios de última hora	Cambios semánticos que afectan a cada comando: modos de autenticación eliminados, lectura implícita de env-var eliminada, contrato de código de salida, formato stdout.	Antes de cualquier portabilidad: esto se aplica en todos los ámbitos.

Orden de migración recomendado

Para una migración de proceso de CI típica:

1. Migrar desde .NET CLI heredado → comprender el runtime y el cambio de distribución (.NET → Node/Bun, MyGet → npm).
2. Romper cambios → antes de cambiar una sola línea, debes saber cuáles son las diferencias transversales. La autenticación por sí sola puede interrumpir su proceso.
3. Mapa de comandos → guía tus llamadas uipcli existentes una por una. Ten en cuenta las filas marcadas con 2 pasos o N pasos : necesitan una nueva lógica de shell, no un simple cambio de nombre.
4. Cambios de nombre de marcador → rellenar los detalles de cada indicador.
5. A continuación, una receta de CI/CD para tu plataforma: copiar y adaptar.

Inicio rápido para impacientes

El puerto mínimo viable:

# 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

Los detalles completos por indicador se encuentran en Cambios de nombre de indicadores.

Qué no está en la migración

• Nuevas características en 1.x que no tienen equivalente heredado (habilidades, MCP, sesiones, filtrado JMESPath). Estos se encuentran en Novedades.
• La documentación de CLI heredada. Todavía se encuentra en los documentos de integraciones de CI/CD, que siguen siendo canónicos para 2025.10 y versiones anteriores.

Ver también

• Novedades : resumen del título, público objetivo: cualquiera que decida migrar.
• Control de versiones y estabilidad : el contrato en el que puedes confiar después de migrar.
• Autenticación : el flujo de autenticación que utilizará tu proceso después de la migración.