Migración: mapa de comandos

Mapa de comandos de verbos `uipcli` heredados a equivalentes de UiPath CLI, agrupados por familia de comandos.

Cada verbo uipcli heredado con su equivalente uip . Las entradas heredadas reflejan la superficie pública uipcli documentada para 2025.10 y anteriores; la columna uip coincide con las páginas de referencia publicadas.

Cómo leer esta página. Las filas se agrupan por familia de verbos heredados (package, job, test, asset, solution, run). Cada fila lleva una clasificación:

• 1:1 — cambio de nombre directo; el nuevo conjunto de marcadores está lo suficientemente cerca como para que funcione un puerto mecánico.
• 2 pasos / N pasos : un verbo heredado se asigna a varias llamadas uip .
• Eliminado — reemplazo: … — el verbo heredado no tiene sucesor directo; la columna "reemplazo" te indica el flujo idiomático de nueva CLI para el mismo resultado.

Para obtener detalles en el nivel de marca dentro de cada verbo, consulta Marcar cambios de nombre. Para conocer los cambios de autenticación/salida subyacentes que se aplican a cada verbo, consulta Cambios de última hora.

Paquete

Comando heredado	uip equivalente	Notas
uipcli package pack <project>	uip rpa pack <project> <output-path>	1:1, pero no caso kebab puro. --outputType → --output-type como se esperaba, pero --autoVersion no tiene equivalente — no hay marca de generación automática de versión en uip rpa pack; calcula la versión tú mismo y pasa --package-version. --author/--description se convierte en --package-author/--package-description, y los marcadores de certificado obtienen un prefijo signing- (--signing-certificate-path, etc). Los comandos uip rpa invocan el empaquetador de Studio, que está respaldado por .NET: el ejecutor sigue necesitando un runtime de .NET disponible. Consulta el paquete uip rpa y la tabla de marcadores completa enmigration-flag-renames.md.
uipcli package analyze <project>	uip rpa analyze <project> --governance-file-path <policy>	1:1 para los marcadores que se transfieren, pero --resultPath y --stopOnRuleViolation no tienen equivalente en absoluto : no existen en uip rpa analyze, no simplemente no documentados. Redirigir stdout tú mismo para obtener resultados; usa --default-severity si una puerta de gravedad basta es suficiente. --governanceFilePath se convierte en --governance-file-path (kebab-case). Las reglas del analizador de flujo de trabajo no se modifican. Se aplica el backend .NET, igual que rpa pack. Consulta el análisis de uip rpa y la tabla de marcadores completa en migración-flag-renames.md.
uipcli package deploy <path> <url> <tenant>	uip or packages upload <path> Entonces uip or processes create --name <n> --package-key <k> --package-version <v> --folder-path <path>	2 pasos. La implementación heredada carga el .nupkg y crea un proceso en una llamada; la nueva CLI divide esas preocupaciones. Consulta uip o carga de paquetes y uip o creación de procesos.
uipcli package restore <project>	uip rpa restore <project> [output-path]	1:1, sin marcas específicas de restauración en absoluto : restore solo toma las opciones comunes del empaquetador (--project-dir, --exclude-configured-sources, --nuget-sources-config-path, --feed-folder, --format, --log-level) más sus dos posicionales . --nugetConfigFilePath se asigna a --nuget-sources-config-path. Se aplica el backend.NET. Consulta restauración de uip rpa.

paquete paquete

# Legacy
uipcli package pack "C:\proj\project.json" -o "C:\dist" \
    --outputType Process --autoVersion

# uip - no --auto-version equivalent; pass an explicit --package-version instead
uip rpa pack ./proj ./dist --output-type Process --package-version 1.0.0

Consulta uip rpa pack para ver la lista completa de marcadores. La herramienta envuelve el mismo empaquetador de Studio que utilizaba la CLI heredada, por lo que el formato de salida y la compatibilidad del proyecto son idénticos.

Analizar paquete

# Legacy
uipcli package analyze "C:\proj\project.json" \
    --governanceFilePath "C:\policy.json" \
    --resultPath "C:\result.json" \
    --stopOnRuleViolation

# uip - --result-path and --stop-on-rule-violation do not exist; redirect stdout instead
uip rpa analyze ./proj \
    --governance-file-path ./policy.json \
    > ./result.json

implementación del paquete

Esta es la fila que captura cada puerto del proceso. El deploy heredado es una carga y creación de una sola vez; uip lo divide en dos pasos explícitos para que el paquete pueda cargarse una vez y vincularse a varias carpetas.

# Legacy — upload and create a process in one call
uipcli package deploy "C:\pkg\InvoiceProcessing.1.0.3.nupkg" \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders OR.Execution" \
    -o "Shared" \
    --processName "InvoiceProcessing" \
    --entryPointsPath "Main.xaml"

# uip — upload, then create the process
uip login \
  --client-id env.UIPATH_CLIENT_ID \
  --client-secret env.UIPATH_CLIENT_SECRET \
  --tenant TenantName

uip or packages upload ./InvoiceProcessing.1.0.3.nupkg
#    response includes "body": "InvoiceProcessing:1.0.3"

uip or processes create \
    --name InvoiceProcessing \
    --package-key InvoiceProcessing \
    --package-version 1.0.3 \
    --folder-path Shared \
    --entry-point Main.xaml

Notas:

• Los <orchestrator_url> posicionales y <orchestrator_tenant> heredados se reemplazan por el contexto de sesión de uip login (cambiar tenants a mitad de sesión con uip login tenant set <name>). Nunca aparecen como argumentos posicionales en uip.
• Legacy --processName es un nombre para mostrar personalizado para el proceso creado. En uip el equivalente es --name en processes create , no --process (que no existe).
• El --processNames <csv> heredado (creación masiva multiproceso en 25.10) no tiene equivalente directo; crea un bucle sobre las filas o lee Soluciones para el flujo multiproceso recomendado.
• El --entryPointsPath heredado (CSV) se convierte en --entry-point (ruta única) en uip or processes create; ejecuta processes create una vez por punto de entrada para paquetes de varios puntos de entrada.

Restaurar paquete

# Legacy
uipcli package restore "C:\proj" \
    --restoreFolder "C:\deps" \
    --nugetConfigFilePath "C:\NuGet.Config"

# uip
uip rpa restore ./proj ./deps

Trabajo

Comando heredado	uip equivalente	Notas
uipcli job run <processName> <url> <tenant>	uip or jobs start <process-key>	1:1 en intención; la identidad es un GUID, no un nombre. La CLI heredada tomaba el nombre de la versión del proceso como argumento posicional; la nueva CLI toma la clave de proceso (GUID) devuelta por uip or processes list. Utiliza --wait-for-completion para el comportamiento heredado de -w true + -W <timeout> . Consulta uip o inicio de trabajos.

# Legacy
uipcli job run "InvoiceProcessing" \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders OR.Execution OR.Jobs" \
    -o "Shared" \
    -i "C:\input.json" \
    -w true -W 3600

# uip — resolve the name to a key, then start with wait-for-completion
PROCESS_KEY=$(uip or processes list --folder-path Shared \
    --name InvoiceProcessing \
    --output-filter "Data[0].Key" \
    --output plain)

uip or jobs start "$PROCESS_KEY" \
    --input-file ./input.json \
    --wait-for-completion \
    --timeout 3600

--name en processes list es una coincidencia contiene, no una coincidencia exacta: un nombre de supercadena (p. ej. InvoiceProcessingV2) también podría coincidir y desplazar o duplicar Data[0]. Para obtener una garantía de coincidencia exacta, filtra más en el campo Name devuelto (por ejemplo, --output-filter "Data[?Name=='InvoiceProcessing'].Key | [0]") antes de confiar en el resultado.

Detalle a nivel de marca:

• El -i, --input_path <file> heredado → uip ofrece dos alternativas: --input-arguments '<json>' para JSON en línea, o --input-file <path> para una carga útil de archivo. Son mutuamente excluyentes.
• Legado -j, --jobscount <n> → --jobs-count <n>.
• Legado -P, --priority <Low|Normal|High> → --job-priority <Low|Normal|High>.
• Legado -r, --robots <csv> → sin equivalente directo (concepto clásico de solo carpeta en heredado). Máquinas de destino con --machine-keys <csv> (GUID) o usuarios con --user-keys <csv> (GUID).
• Legado -f, --fail_when_job_fails (predeterminado true) → la nueva CLI siempre sale 1 si un trabajo esperado finaliza Faulted; no hay opción de exclusión.
• Legado -R, --result_path <file> → el nuevo CLI imprime el sobre del trabajo en la salida estándar; redirigir con > result.json, o utilizar --output-filter para extraer campos específicos.
• Legado -b, --job_type <Unattended|NonProduction> → --runtime-type <Unattended|Headless|Serverless|NonProduction|Development|TestAutomation>.

test

Comando heredado	uip equivalente	Notas
uipcli test run <url> <tenant> -s <testset>	uip tm testsets run --test-set-key <key> Entonces uip tm wait --execution-id <id> Entonces uip tm report get --execution-id <id>	3 pasos (iniciar → esperar → verificar). La nueva CLI separa "activar la ejecución" desde "bloquear en él" desde "leer el veredicto", para que los scripts de CI puedan ramificarse limpiamente en cada uno. Consulta la ejecución de conjuntos de pruebas de uip tm. El verbo para iniciar una nueva ejecución a partir de un conjunto de pruebas reside en el recurso testsets como uip tm testsets run. uip tm executions run también existe, pero tiene un propósito diferente: vuelve a ejecutar registros de casos de prueba específicos de una ejecución existente , no lanza una nueva ejecución desde un conjunto de pruebas.
uipcli test run <url> <tenant> -P <project.json> (empaquetar + probar un proyecto)	uip rpa pack → uip or packages upload → crear un conjunto de pruebas en Test Manager → uip tm testsets run	N pasos. El flujo único heredado "empaqueta este proyecto, impleméntalo, ejecuta sus pruebas" se divide en las herramientas rpa, or y tm . La creación del conjunto de pruebas suele ser una configuración única que se realiza en la IU web de Test Manager.
uipcli test parallel <url> <tenant> --testsConfigurationFilePath <file>	Sin equivalente directo: bucle sobre las llamadas uip tm testsets run	Eliminado: reemplazo: crea un script de lanzamiento paralelo de conjuntos de pruebas independientes con uip tm testsets run (cada uno devuelve un ExecutionId), luego un solo uip tm wait por ejecución. El controlador de proyecto de prueba del verbo heredado parallel (que invocaba uipcli test run internamente) no tiene contrapartida; el nuevo modelo supone que los conjuntos de pruebas ya están creados en Test Manager.

ejecución de prueba (conjunto de pruebas único)

# Legacy
uipcli test run \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders OR.TestSets OR.TestSetExecutions" \
    -o "Shared" \
    -s "Smoke Suite" \
    --out junit \
    --result_path "C:\results.xml" \
    --timeout 1800

# uip — three verbs, clean exit-code branching
EXECUTION_ID=$(uip tm testsets run \
    --test-set-key DEMO:10 \
    --output-filter "Data.ExecutionId" \
    --output plain)

if ! uip tm wait --execution-id "$EXECUTION_ID" --project-key DEMO --timeout 1800; then
    case $? in
        2) echo "timeout" >&2; exit 2 ;;
        *) echo "wait failed" >&2; exit 1 ;;
    esac
fi

FAILED=$(uip tm report get --execution-id "$EXECUTION_ID" --project-key DEMO \
    --output-filter "Data.Failed" --output plain)

if [ "$FAILED" -gt 0 ]; then
    uip tm result download --execution-id "$EXECUTION_ID" --project-key DEMO \
        --result-path ./results.xml
    exit 1
fi

Notas a nivel de indicador:

• El -s, --testset <name> heredado toma un nombre para mostrar; el nuevo --test-set-key <key> toma la clave de Test Manager (formato PROJECT:NN). Búscalo con uip tm testsets list --project-key <key>.
• También existe -t, --testsetkey <key> heredado (un alias heredado más nuevo): esos valores se portan directamente al nuevo --test-set-key.
• El --out junit|uipath heredado no tiene un marcador equivalente: uip tm result download no tiene ninguna opción --output-format; solo se admite JUnit XML hoy en día (la propia descripción del comando dice exactamente eso).
• Legado --attachRobotLogs → adjuntar artefactos a través de uip tm attachment download --execution-id <id> después de la ejecución.
• Legado --retryCount <n> → uip tm executions retry --execution-id <id> vuelve a ejecutar solo los casos fallidos de una ejecución finalizada. No hay marca de reintento automático en el lanzamiento; crea un script con la rama de salida report get anterior.

prueba paralela

No hay ningún verbo uip que refleje el test parallel heredado. La expresión idiomática más cercana es un bucle de shell que lanza varias llamadas uip tm testsets run simultáneamente, captura cada ExecutionId y luego espera en cada una:

# Launch in parallel (bash)
EXEC1=$(uip tm testsets run --test-set-key DEMO:10 --output-filter Data.ExecutionId --output plain) &
EXEC2=$(uip tm testsets run --test-set-key DEMO:11 --output-filter Data.ExecutionId --output plain) &
wait

# Then wait on each
uip tm wait --execution-id "$EXEC1" --project-key DEMO --timeout 1800 &
uip tm wait --execution-id "$EXEC2" --project-key DEMO --timeout 1800 &
wait

El esquema --testsConfigurationFilePath heredado (que enumeraba las rutas por proyecto y sus conjuntos de pruebas) no tiene contrapartida uip ; controla el bucle desde tu matriz de CI o una simple lista de shell de claves del conjunto de pruebas.

Activo

Comando heredado	uip equivalente	Notas
uipcli asset deploy <csv> <url> <tenant>	Recorre uip or assets create <name> <value> por fila	Eliminado: reemplazo: iterar el CSV en un bucle de shell y llamar create por fila. La nueva CLI no ofrece una implementación de CSV de una sola vez; consulta uip o activos.
uipcli asset delete <csv> <url> <tenant>	Recorre uip or assets delete <key> --yes por fila	Eliminado: reemplazo: iterar y eliminar por clave. delete toma el GUID del activo, no el nombre: resuelve los nombres en claves primero con uip or assets list --folder-path <path>. -y, --yes es obligatorio; la CLI nunca solicita.

# Legacy — bulk CSV
uipcli asset deploy "C:\assets.csv" "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Assets" -o "Shared"

# uip — script the loop
# CSV columns: name,type,value,description
while IFS=, read -r NAME TYPE VALUE DESCRIPTION; do
    [ "$NAME" = "name" ] && continue    # skip header
    uip or assets create "$NAME" "$VALUE" \
        --folder-path Shared \
        --type "$TYPE" \
        --description "$DESCRIPTION"
done < assets.csv

Nota:

Los activos de tipo credencial en heredados utilizan la forma de valor username::password. Con uip or assets create, el formato del valor de Credencial es username:password (dos puntos simples) y los secretos requieren --credential-store-key <guid>. Consulta uip o assets: crear.

Solución

Comando heredado	uip equivalente	Notas
uipcli solution pack <path>	uip solution pack <solutionPath> <outputPath>	1:1 en intención. La salida es un .zip en ambas generaciones (contiene archivos .nupkg internos); la forma del argumento ha cambiado de -o a un directorio de salida posicional.
uipcli solution analyze <path>	uip rpa analyze <project> por proyecto	N pasos. Ejecuta el analizador en cada proyecto dentro de la solución; no hay un solo verbo uip solution analyze .
uipcli solution restore <path>	uip rpa restore <project> por proyecto	N pasos. El mismo patrón que solution analyze.
uipcli solution upload-package <zip>	uip solution publish <zip>	1:1. El nuevo nombre es publish; el comportamiento (cargar en la fuente de soluciones del tenant) no ha cambiado.
uipcli solution download-package <name> <version>	Sin equivalente directo	Eliminado — reemplazo: descarga los paquetes .nupkg subyacentes con uip or packages download <key>, o recupera el registro de solución publicado a través de la API REST de Orchestrator.
uipcli solution delete-package <name> <version>	uip solution packages delete <packageName> <packageVersion> --yes	1:1, más un marcador de confirmación -y, --yes obligatorio (heredado no lo requería).
uipcli solution download-config <name>	uip solution deploy config get <package-name> [--package-version <v>] [-d <path>]	1:1.
uipcli solution deploy <...>	uip solution deploy run --name <n> --package-name <n> --package-version <v> --folder-name <n> [--parent-folder-path <path>]	1:1 en intención; los nombres de los marcadores han cambiado. --name es el nombre de la implementación , no el nombre del paquete. Consulta first-pipeline.md — Paso 3.
uipcli solution deploy-activate <...>	uip solution deploy activate <deployment-name>	1:1.
uipcli solution deploy-uninstall <...>	uip solution deploy uninstall <deployment-name>	1:1.

# Legacy — pack + upload + deploy, one verb each
uipcli solution pack "C:\my-solution" \
    -o "C:\dist" \
    -v 1.2.0
uipcli solution upload-package "C:\dist\my-solution.1.2.0.zip" \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders"
uipcli solution deploy "..." "..."

# uip — publish replaces upload-package; positional --version in pack
uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant TenantName
uip solution pack ./my-solution ./dist --version 1.2.0
uip solution publish ./dist/my-solution_1.2.0.zip
uip solution deploy run \
    --name "my-solution-deployment" \
    --package-name my-solution \
    --package-version 1.2.0 \
    --folder-name MySolution \
    --parent-folder-path Shared

Consulta Tu primer proceso para obtener una guía con explicaciones de cada paso.

Iniciar

Comando heredado	uip equivalente	Notas
uipcli run <arguments.json>	Sin equivalente directo	Eliminado — reemplazo: reescribir el paso del proceso como un script de shell que llama directamente con uip . El verbo heredado run consumía un archivo JSON que serializaba una invocación uipcli <verb> <args> completa (producida por el marcador oculto --captureCommandToJsonFile ); uip no envía un equivalente.

Nota:

La CLI 1.x no expone un marcador universal --from-file para la reproducción masiva de argumentos. Si tu proceso depende de este patrón (común con el flujo de trabajo captureCommandToJsonFile + uipcli run heredado), convierte la carga útil de JSON en invocaciones directas uip .

Comandos sin equivalente heredado

Estos uip verbos no tienen equivalente en la CLI heredada; abren flujos de trabajo que no eran posibles solo con uipcli . Ninguno de ellos requiere migración: son nuevas capacidades.

• uip login, uip login tenant list/set, uip logout, uip login status — gestión completa de la sesión.
• uip or folders *, uip or machines *, uip or users *, uip or roles *, uip or licenses *, uip or sessions *, uip or audit-logs *, uip or calendars *, uip or credential-stores *, uip or feeds *, uip or settings * : superficie completa de administración de Orchestrator.
• uip or jobs list / get / stop / restart / resume / logs / traces / healing-data / history, uip or processes list / get / edit / update-version / rollback, uip or packages list / get / versions / entry-points / download : verbos de introspección que el legado no exponía.
• uip or assets / buckets / bucket-files / libraries / queues / queue-items / triggers / webhooks — CRUD de recursos de tiempo de ejecución de Orchestrator.
• uip agent *, uip codedagent *, uip codedapp *, uip maestro flow *, uip maestro *, uip api-workflow *, uip df *, uip insights *, uip traces *, uip docsai *, uip vss * : superficies completamente nuevas.
• uip eval *, uip gov *, uip admin *, uip tasks *, uip aops *, uip llm-configuration *, uip llm-gateway *, uip guardrails *, uip model-hub *, uip platform *, uip ixp *, uip pm *, uip coder *, uip ah *, uip agenthub *, uip conversational *, uip context-grounding *, uip function *: 18 paquetes de herramientas independientes más sin contrapartida CLI heredada.
• uip solution deploy upgrade / status / list, uip solution feeds list, uip solution project *, uip solution resource *, uip solution cleanup, uip solution init, uip solution download, uip solution run — Los verbos de herramientas de solución más allá del flujo heredado de empaquetado/publicación/implementación tenían.
• uip tools *, uip skills *, uip mcp, uip completion — gestión en el nivel de host.

Ver también

• Cambios de nombre de marcador : cada marcador que cambió de nombre entre uipcli y uip, con la regla de asignación.
• Cambios de última hora : cambios semánticos detrás del cambio de nombre (auth, formato stdout, códigos de salida).
• Ejemplos de procesos : antes/después de los procesos de Azure DevOps y Jenkins.
• Índice de referencia : cada herramienta uip y verbo en un solo lugar.