Migración desde .NET CLI

UiPath CLI 1.x (uip, distribuido en npm como @uipath/cli) reemplaza al .NET CLI heredado (uipcli.exe, distribuido como UiPath.CLI a través de las versiones de calendario 2023.10, 2024.10 y 2025.10) . Esta página explica quién debe migrar, qué cambia en el nivel de herramientas y cómo navegar por las cuatro páginas de detalles a continuación.

Si solo quieres la respuesta bandera por bandera a "¿qué debo escribir en uipcli <verb> de?", salta a Mapa de comandos y Cambios de nombre de bandera.

Para quién es esta guía

Debes migrar si se aplica alguna de las siguientes condiciones:

• Tu proceso llama a uipcli.exe : directamente, a través de la tarea UiPathCLI de Azure DevOps, o desde un paso de shell de Acciones de Jenkins/GitHub.
• Fijas la CLI heredada a una versión de calendario (2023.10, 2024.10, 2025.10) y has realizado un seguimiento de su cadencia anual.
• Utilizas la autenticación de usuario/contraseña (-u/-p) o la autenticación de token de actualización (-t/-a) contra Orchestrator.
• Creas un .nupkg con uipcli package pack, lo implementas con uipcli package deploy o ejecutas pruebas de Orchestrator con uipcli test run.

Puedes permanecer en la CLI heredada por ahora si necesitas una característica solo de Windows que aún no se haya migrado a la herramienta multiplataforma uip rpa (integración del depurador de Studio, validate, find-package, find-activities, type-definition). Una herramienta uip rpa-legacy hermana envuelve el binario 2025.10 en Windows; consulta uip rpa: contenedor heredado solo para Windows. Todo lo demás (empaquetado en Linux/macOS, operaciones de Orchestrator, soluciones, Test Manager, agentes, flujos, Maestro) está en uip hoy.

Qué cambia de un vistazo

Dimensión	Legado uipcli (hasta 2025.10)	uip 1.x
Nombre binario	uipcli.exe / uipcli.dll	uip
Distribución	MSI, NuGet (UiPath.CLI, UiPath.CLI.Windows)	npm (@uipath/cli)
Tiempo de ejecución	.NET 6/.NET Framework	Node.js 18+
Plataforma	Windows (primario), Linux a través de NuGet multiplataforma	Windows, macOS, Linux, ARM64
Control de versiones	Calendario (2023.10, 2024.10, 2025.10)	Semántico (1.0.0, 1.1.0, 2.0.0)
Instalar modelo	Monolítico	Host + complementos de herramientas por superficie (consulta Herramientas)
Salida predeterminada	Envía registros de texto a stdout + código de salida	Sobre JSON en stdout, inicia sesión en stderr
Flujos de autenticación principales	usuario/contraseña, token de actualización, aplicación externa	aplicación externa (CI), OAuth interactivo (dev), env-token (contenedor)
Configuración	Solo marcadores CLI	Marcadores + variables de entorno (consulta Configuración)

Consulta Novedades del resumen de reescritura.

¿En qué versión de CLI estoy?

Ejecuta uipcli --version (o dotnet uipcli.dll --version). El resultado es 23.10.8817.35919, 24.10.9248.xxxxx o 25.10.xxxx.xxxxx. Las siguientes rutas de migración cubren las tres.

Está ejecutando	Dónde ir
uipcli 23.10.*	Lee toda esta página y, a continuación, Mapa de comandos + Cambios de nombre de marca. Los verbos deploy y asset deploy que utiliza están todos asignados.
uipcli 24.10.*	Igual que en la versión 23.10: la superficie de comando apenas ha cambiado. Si adoptaste el verbo solution añadido en 24.10, se asigna cada subcomando.
uipcli 25.10.*	Igual que el anterior. test parallel y el formulario de implementación de múltiples puntos de entrada --processNames <csv> tienen notas de migración específicas en el mapa de comandos.
Utilizar uipcli run <args.json>	Consulta Mapa de comandos — ejecutar — la nueva CLI no tiene equivalente directo; el patrón recomendado es un script de shell con una invocación uip por paso.

Tabla de decisiones: elija su punto de partida

Su caso de uso en uipcli	Destino de la migración	Página de detalles
Empaquetar un proyecto de Studio → cargar en Orchestrator → crear un proceso	uip rpa pack → uip or packages upload → uip or processes create	Mapa de comandos: paquete
Empaquetar e implementar una solución (.uipx)	uip solution pack → uip solution publish → uip solution deploy run	Mapa de comandos: solución, primer proceso
Iniciar un trabajo de Orchestrator	uip or jobs start <process-key> [--wait-for-completion]	Mapa de comandos: trabajo
Ejecutar un conjunto de pruebas de Test Manager	uip tm testsets run → uip tm wait → uip tm report get	Mapa de comandos: prueba
Implementar activos declarados en CSV	uip resource assets create en un bucle (no hay implementación de CSV de una sola vez hoy)	Mapa de comandos: activo
Ejecutar el analizador de flujo de trabajo	uip rpa analyze <project> --governance-file-path <policy>	Mapa de comandos: analizar
Autenticar un proceso de CI	uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant <name>	Cambios de nombre de marca: autenticación
Portar un proceso de Azure DevOps/Jenkins	Reemplazar UiPathCLI bloques de tareas por uip pasos de shell	Ejemplos de proceso

Cambios de última hora más comunes

Estos tres aparecen en casi todas las migraciones. Consulta Romper cambios para ver la lista completa.

1. La autenticación básica (-u/-p) y el token de actualización (-t/-a) han desaparecido. Solo se admiten las credenciales de cliente de aplicación externa, OAuth2 interactivo y los tokens de acceso a variables de entorno. Consulta Autenticación.
2. UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET ya no se leen implícitamente. Pásalas como --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET (el prefijo env. lee la variable sin exponerla en la línea de comandos).
3. La salida estándar es JSON de forma predeterminada. Los scripts de shell heredados que analizaban la salida de texto uipcli deben utilizar jq (o --output plain + --output-filter) o cambiar a --output table para la lectura humana.

Antes de comenzar

Completa estos cuatro pasos antes de empezar a portar un proceso.

1. Haz una copia de seguridad de tus archivos de proceso actuales

Confirma una copia en buen estado de cada azure-pipelines.yml, Jenkinsfile, .github/workflows/*.yml o .gitlab-ci.yml en una rama (o etiqueta). El puerto es más fácil de revisar como diferencia.

2. Anclar @uipath/cli a una versión específica

Instala siempre con una versión explícita durante la migración para que el comportamiento del proceso no cambie inesperadamente:

npm install -g @uipath/cli@1.0.0

Las herramientas se anclan implícitamente a la línea MAJOR.MINOR de la CLI (consulta Versiones), por lo que una CLI anclada también ancla cada herramienta a un rango menor conocido. Para una reproducibilidad estricta en el nivel de parche, fija también las herramientas: consulta la sección "Fijar versiones en CI" de Patrones de scripting.

3. Marca los documentos heredados de .NET CLI

Comportamiento del marcador de referencia cruzada durante el puerto. La referencia 2025.10 se encuentra en docs.uipath.com — Interfaz de línea de comandos de UiPath (2025.10). Mantenlo abierto en una pestaña.

4. Crear una aplicación externa en UiPath

La CLI heredada aceptaba varios modos de autenticación; la nueva CLI colapsa la autenticación CI en las credenciales de cliente de la aplicación externa. Crea la aplicación ahora para que el puerto tenga algo a lo que apuntar. Consulta Autenticación: flujo 2.

Consejo:

Otorga a la aplicación externa los mismos ámbitos que utilizaba tu CLI heredada: OR.Folders, OR.Jobs, OR.Execution, OR.Assets, OR.Users.Read, OR.Machines.Read, OR.TestSets, OR.TestSetExecutions cubre el caso común de CI. Consulta el valor --applicationScope de tus llamadas uipcli existentes para obtener la lista exacta que necesitas.

Las cuatro páginas de detalles

Cada página a continuación está lo suficientemente enfocada como para revisarla de una sola vez. Trabaja en ellos en orden si estás portando un proceso completo; salta directamente a la que necesitas si solo quieres una respuesta específica.

Mapa de comandos

Cada verbo heredado: package pack, package analyze, package deploy, package restore, job run, test run, test parallel, asset deploy, asset delete, solution pack, solution deploy, run — con su equivalente uip , una clasificación 1:1 / multipaso / eliminado y un fragmento de shell antes/después para cada fila no trivial.

Marcar cambios de nombre

Asignación en el nivel de marca con el bloque de autenticación en la parte superior. Legado -u/-p/-t/-a/-A/-I/-S/-o/--applicationScope/--identityUrl/--outputType/--traceLevel asignado a sus homólogos uip (o llamados como eliminados, con el reemplazo). Lee esto junto con el mapa de comandos: el mapa de comandos muestra el verbo, Marcar renombra muestra el marcador.

Cambios de última hora

Cobertura en prosa de los cambios que interrumpen los procesos sin previo aviso. Eliminaciones del modo de autenticación, eliminación de lectura automática de env-var, ajuste del contrato de código de salida, JSON-stdout predeterminado, carpetas NuGet con versión de calendario desaparecidas, .NET runtime eliminado. Un párrafo por cambio con una corrección de "qué hacer".

Procesos

Fragmentos de antes/después para Azure DevOps y Jenkins (obligatorio), con fragmentos más cortos de GitHub Actions y GitLab CI. Enlace cruzado a las recetas CI/CD completas para procesos completos.

Ver también

• Novedades : resumen del título de la reescritura.
• Tu primer proceso : tutorial práctico de pack → publish → deploy run con la nueva CLI.
• Autenticación : los tres flujos de autenticación compatibles en 1.x.
• Códigos de salida : el contrato de cinco niveles más estricto.
• Herramientas (complementos) : por qué la superficie de comandos se divide en paquetes npm y qué se instala automáticamente en el primer uso.