Migración: mapa 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>	1:1. La nueva superficie de bandera utiliza kebab-case; Los comandos --outputType → --output-type, --autoVersion → --auto-version, etc. uip rpa invocan el empaquetador de Studio, que está respaldado por .NET: el ejecutor sigue necesitando un tiempo de ejecución de .NET disponible. Consulta paquete rpa de uip.
uipcli package analyze <project>	uip rpa analyze <project> --governance-file-path <policy>	1:1. --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 uip rpa analizar.
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> [outputPath]	1:1. Restaura las dependencias del paquete NuGet; admite configuraciones de NuGet aisladas y personalizadas a través de los mismos marcadores que el legado. 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 \
    --traceLevel Information

# uip
uip rpa pack ./proj --output-type Process --auto-version

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
uip rpa analyze ./proj \
    --governance-file-path ./policy.json \
    --result-path ./result.json \
    --stop-on-rule-violation

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 (más la anulación opcional de -t, --tenant en cada llamada). 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

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" de "bloquear en ella" de "leer el veredicto", por lo que los scripts de CI pueden ramificarse limpiamente en cada uno. Consulta la ejecución de conjuntos de pruebas de uip tm. El nuevo verbo vive en el recurso testsets como uip tm testsets run , no en el recurso executions (no hay uip tm executions run).
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 \
        --destination ./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 se convierte en el nuevo uip tm result download --output-format junit (JUnit es el valor predeterminado; también se admite XML nativo de UiPath).
• 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 resource 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 activos de recursos de uip.
uipcli asset delete <csv> <url> <tenant>	Recorre uip resource assets delete <key> 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 resource assets list --folder-path <path>.

# 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 resource 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 resource assets create, el formato del valor de Credencial es username:password (dos puntos únicos) y los secretos requieren --credential-store-key <guid>. Consulta activos de recursos de uip: 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>	1:1.
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> [--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 \
    --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 resource buckets / bucket-files / libraries / queues / queue-items / triggers / webhooks — Recurso CRUD de Orchestrator.
• uip agent *, uip codedagent *, uip codedapp *, uip flow *, uip maestro *, uip api-workflow *, uip df *, uip insights *, uip traces *, uip docsai *, uip vss * : superficies completamente nuevas.
• 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.