Migración: marca cambia el nombre

Esta página asigna marcadores uipcli individuales a sus homólogos uip . Úsalo junto con el mapa de comandos : el mapa de comandos muestra a qué verbo llamar; esta página muestra qué hacer con cada marca en ese verbo.

Los marcadores se agrupan por dominio. Auth es lo primero porque cambia para cada comando a la vez. El resto de la página cubre los marcadores que difieren según el verbo: salida del paquete/solución, ejecución del trabajo, salida del ejecutor de pruebas, seguimiento, etc.

Las entradas de marca heredadas reflejan la superficie de marca pública uipcli documentada para 2025.10 y anteriores. La columna uip coincide con las páginas de referencia actuales.

Cómo leer la columna "Dónde reside"

uip te ofrece tres lugares para poner un valor que era un marcador en uipcli:

• Marca en cada comando : pásalo literalmente cada vez (--tenant <name>, --folder-path Shared).
• Estado de la sesión desde uip login : el marcador se ha convertido en algo que se establece una vez con uip login; los comandos posteriores lo recogen automáticamente. Anula por llamada con el marcador adecuado.
• Variable de entorno : leída por la CLI en runtime. Cuando corresponda, da preferencia a la forma de prefijo --client-id env.VARNAME / --client-secret env.VARNAME en uip login para mantener el secreto fuera de la línea de comandos.

La columna "Dónde reside" te dice cuál de ellos se aplica.

Autenticación

Este es el bloque que más cambia. La CLI heredada aceptaba tres modos de credenciales por comando (usuario/contraseña, token de actualización, aplicación externa). La nueva CLI solo acepta credenciales de aplicaciones externas y OAuth interactivo: se eliminan la autenticación de usuario/contraseña y el token de actualización. Consulta Romper cambios: modos de autenticación eliminados.

Aplicación externa (el flujo de CI)

Indicador heredado	Propósito heredado	uip Marca	Dónde vive	Notas
-A, --accountForApp <name>	Nombre de la organización para la aplicación externa	--organization <name>	Marcar activado uip login	A menudo opcional: la organización se infiere del registro de la aplicación externa. Pásalo cuando necesites eliminar la ambigüedad.
-I, --applicationId <id>	ID de cliente de aplicación externa	--client-id <id> (o --client-id env.VARNAME)	Marcar activado uip login	Prefiere env.VARNAME leer desde una variable de entorno.
-S, --applicationSecret <secret>	Secreto de cliente de aplicación externa	--client-secret <secret> (o --client-secret env.VARNAME)	Marcar activado uip login	Utiliza siempre el prefijo env. en CI para evitar filtrar el secreto en el historial del shell y la salida ps .
--applicationScope "<space-separated>"	Ámbitos de OAuth	--scope "<space-separated>" / -s, --scope	Marcar activado uip login	Mismo formato separado por espacios. Las llamadas heredadas suelen enumerar todos los ámbitos OR.* ; mantener la misma lista.
--identityUrl <url>	Autoridad de identidad personalizada (Automation Suite / PaaS)	--authority <url>	Marcar activado uip login	Renombrado; semántica idéntica. Omitir para Automation Cloud.
(posicional) <orchestrator_url>	OrchestratorBaseURL	(implícito desde la sesión)	No se necesita el marcador en uip login : la CLI resuelve la URL de Orchestrator desde el tenant/organización elegido al iniciar sesión.
(posicional) <orchestrator_tenant>	Nombre del tenant	-t, --tenant <name>	Marcar en uip login (predeterminado) o por comando -t	Una vez establecido al iniciar sesión, cada comando posterior utiliza este tenant; -t en cualquier comando lo anula para esa llamada.
-o, --organizationUnit <folder>	Carpeta predeterminada para el comando	--folder-path <path> o --folder-key <guid>	Marcar en el comando que lo necesita	No es un concepto a nivel de sesión en uip; transmitirlo en cada llamada jobs/processes/resource * . El archivo de configuración puede anclar los valores predeterminados.

Autenticación de usuario/contraseña: eliminada

Indicador heredado	Estado en uip
-u, --username <user>	Eliminado. Crea una aplicación externa y utiliza --client-id.
-p, --password <pass>	Eliminado. Usa --client-secret.

La CLI heredada admitía la autenticación de usuario/contraseña contra Orchestrator para entornos en los que aún no se había aprovisionado una aplicación externa. uip no; consulta Cambios importantes: modos de autenticación eliminados.

Autenticación de token de actualización: eliminada

Indicador heredado	Estado en uip
-t, --token <refresh-token>	Eliminado. El -t heredado era la forma abreviada de --token; en uip, -t es la forma abreviada de --tenant.
-a, --accountName <name>	Eliminado. Usa --organization con una aplicación externa en su lugar.

Si un proceso heredado utilizaba la autenticación de token de actualización, migra a la aplicación externa. Automation Cloud ya no aprovisiona el flujo de token de actualización para nuevas cargas de trabajo.

Token en mano (nuevo, sin equivalente heredado)

Para contenedores o ejecutores que ya tienen un token de acceso a UiPath y no necesitan intercambiar credenciales, uip admite autenticación de variable de entorno: establece UIPATH_CLI_ENABLE_ENV_AUTH=true y pasa el token + organización + tenant a través de env vars. Consulta Autenticación: flujo 3. No se escribe ningún archivo; el token no se actualiza.

env.Prefijo NOMBRE_VAR

uip login acepta un secreto literal en --client-id / --client-secret, o la forma de prefijo env.VAR_NAME que lee el valor de una variable de entorno en tiempo de ejecución:

# Resolves at runtime from $UIPATH_CLIENT_SECRET; the secret never appears on the command line.
uip login \
  --client-id env.UIPATH_CLIENT_ID \
  --client-secret env.UIPATH_CLIENT_SECRET \
  --tenant "$UIPATH_TENANT"

A diferencia de uipcli, uip no lee implícitamente UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET; debes hacer referencia a ellos a través del prefijo env. (o pasar valores literales). Consulta Autenticación: prefijo env.VAR_NAME y Romper cambios: lectura implícita de env-var eliminada.

Salida, registro y seguimiento

Se aplica a todos los verbos uipcli .

Indicador heredado	Propósito heredado	uip Marca	Dónde vive	Notas
--traceLevel <None|Critical|Error|Warning|Information|Verbose>	Verbosidad del registro	--log-level <debug|info|warn|error>	Marcador global en cada comando	Rango de valores reducido a cuatro niveles; predeterminado info. Verbose → debug, Information → info, Warning → warn, todo lo demás → error. Consulta Opciones globales.
(stdout de texto heredado; sin marcador)	Salida estructurada	--output <json|table|yaml|plain>	Indicador global	El valor predeterminado es json en cada comando. Texto impreso heredado legible por humanos; uip imprime JSON. Usa --output table para la vista humana. Consulta Formatos de salida.
(sin equivalente)	Salida posterior al filtro	--output-filter "<JMESPath>"	Indicador global	Nuevo en uip. Permite que los procesos extraigan campos específicos sin canalizar a través de jq.
(sin equivalente)	Duplicar registros en un archivo	--log-file <path>	Indicador global	Nuevo en uip. Anexa líneas JSON.
-l, --language <locale>	Idioma de registro	(sin equivalente)	Eliminado.	La salida del registro está en inglés en uip.
--captureCommandToJsonFile <path>	Serializar la invocación a JSON	(sin equivalente)	Eliminado.	Se utiliza para impulsar uipcli run, que también se elimina. Consulta Mapa de comandos: ejecutar.

Marcadores de paquete

Las marcas de PascalCase heredadas se convierten en kebab-case en uip rpa. Para cada fila a continuación, el marcador uip rpa pack equivalente es el nombre heredado con CamelCase dividido en palabras y unido con - (por ejemplo, --autoVersion → --auto-version). Ejecuta uip rpa pack --help para obtener la lista completa en la versión de tu herramienta instalada.

paquete paquete

Indicador heredado	uip rpa pack	Notas
<workspace_path> (posicional)	<project> (posicional)	Ruta a project.json o directorio que lo contiene.
-o, --output <dir>	-o, --output <dir>	Misma forma. Directorio de salida para el .nupkg generado.
-v, --version <semver>	-v, --version <semver>	Establece la versión del paquete.
--autoVersion	--auto-version	Generar automáticamente la versión a partir de la fecha/marca de tiempo.
--outputType <Process|Library|Tests|Objects>	--output-type <Process|Library|Tests|Objects>	Fuerza el tipo de salida.
--splitOutput	--split-output	Divide el runtime y las bibliotecas de diseño.
--releaseNotes <text>	--release-notes <text>	Incrustado en los metadatos .nupkg .
--repositoryUrl, --repositoryCommit, --repositoryBranch, --repositoryType	--repository-url, --repository-commit, --repository-branch, --repository-type	Metadatos de VCS.
--projectUrl <url>	--project-url <url>	URL de la idea de Automation Hub.
--certificatePath, --certificatePassword, --timestampServerUrl	--certificate-path, --certificate-password, --timestamp-server-url	Firma de código.
--author <name>	--author <name>	Autor del paquete.
--governanceFilePath <policy>	--governance-file-path <policy>	Ejecuta el analizador como parte del paquete.
Autorización de biblioteca (--libraryOrchestratorUrl, --libraryOrchestratorTenant, -u/-p/-t/-a/-A/-I/-S, --libraryOrchestratorApplicationScope, --libraryOrchestratorFolder, --libraryIdentityUrl, --libraryOrchestratorAccountForApp, --libraryOrchestratorAccountName, --libraryOrchestratorApplicationId, --libraryOrchestratorApplicationSecret, --libraryOrchestratorUsername, --libraryOrchestratorPassword, --libraryOrchestratorAuthToken)	Sesión desde uip login	Todos los marcadores de autenticación library* colapsan en la sesión única configurada por uip login. El paquete está sin conexión, excepto cuando necesita resolver las dependencias de la biblioteca desde una fuente privada; en ese caso, la CLI utiliza la sesión activa.

Analizar paquete

Indicador heredado	uip rpa analyze
<workspace_path> (posicional)	<project> (posicional)
--governanceFilePath <policy>	--governance-file-path <policy>
--analyzerTraceLevel <Off|Error|Warning|Info|Verbose>	(aún no documentado)
--stopOnRuleViolation	(aún no documentado; probablemente un umbral de gravedad)
--treatWarningsAsErrors	(aún no documentado)
--resultPath <path>	(aún no documentado)
--ignoredRules <id1,id2>	(aún no documentado)

implementación del paquete

El deploy heredado ahora son dos uip llamadas; consulta Mapa de comandos: implementación de paquetes. Por marcador:

Indicador heredado	uip equivalente	Notas
<packages_path> (posicional)	<file> (posicional en uip or packages upload)	Archivo único. Para una carpeta de .nupkgs, bucle en el shell.
<orchestrator_url> (posicional)	(sesión)	Suéltalo; proporcionado por uip login.
<orchestrator_tenant> (posicional)	-t, --tenant en uip login o el comando	El valor predeterminado es sesión.
-c, --createProcess <true|false>	(implícito)	uip or packages upload nunca crea el proceso. Llama a uip or processes create después de la carga si quieres un proceso.
--processName <name>	--name <name> Activado uip or processes create	Renombrado; nota: --process <name> no existe en la nueva CLI.
--processNames <csv>	(bucle en shell: sin equivalente directo)	Script de la iteración CSV; llamada processes create por fila.
--processDescription <text>	-d, --description <text> Activado uip or processes create
--use-package-description	(comportamiento predeterminado)	processes create hereda la descripción del paquete de forma predeterminada al crear.
--ignoreLibraryDeployConflict	(sin equivalente)	Las cargas de biblioteca a través de uip resource libraries upload fallan limpiamente en la versión duplicada; ajusta la lógica del proceso para omitir si la versión ya existe.
-e, --environments <csv>	(sin equivalente; solo carpetas modernas)	El concepto de "entornos" de carpetas clásicas heredadas no está representado en el modelo de carpetas moderno.
-h, --entryPointsPath <csv>	--entry-point <path> Activado uip or processes create	Punto de entrada único por llamada; bucle para paquetes de varios puntos de entrada.

Restaurar paquete

Indicador heredado	uip rpa restore
<workspace_path> (posicional)	<project> (posicional)
--restoreFolder <dir>	[outputPath] (posicional)
--nugetConfigFilePath <path>	(aún no documentado)
Marcadores de autenticación de biblioteca	Sesión desde uip login

Marcadores de trabajo (ejecución de trabajo uipcli → uip o inicio de trabajos)

Indicador heredado	uip or jobs start	Notas
<process_name> (posicional)	<process-key> (posicional)	GUID, no nombre. Resolver con uip or processes list --name <name> --output-filter 'Data[0].Key' --output plain.
<orchestrator_url> (posicional)	(sesión)	—
<orchestrator_tenant> (posicional)	-t, --tenant	El valor predeterminado es sesión.
-i, --input_path <file>	--input-file <path> (archivo) o --input-arguments '<json>' (en línea)	Dos alternativas, mutuamente excluyentes.
-P, --priority <Low|Normal|High>	--job-priority <Low|Normal|High>	—
-j, --jobscount <n>	--jobs-count <n>	—
-r, --robots <csv>	(sin equivalente directo)	Solo carpeta clásica en legado. Usa --machine-keys o --user-keys (GUID) para las carpetas modernas.
-U, --user <user>	--user-keys <guid[,guid]>	Primero debe resolver el nombre de usuario en un GUID de usuario (uip or users list).
-M, --machine <hostname>	--machine-keys <guid[,guid]>	Primero debe resolver el nombre de host en un GUID de máquina (uip or machines list).
-R, --result_path <file>	(redirigir stdout o utilizar --output-filter)	uip imprime el sobre del trabajo en la salida estándar. uip or jobs start <key> --wait-for-completion > result.json escribe el sobre lleno.
-W, --timeout <seconds>	--timeout <seconds>	Requiere --wait-for-completion.
-f, --fail_when_job_fails <true|false>	(siempre activo)	Con --wait-for-completion, el código de salida es 1 si el trabajo finaliza Faulted. Sin opción de exclusión.
-w, --wait <true|false>	--wait-for-completion (bandera)	El nuevo formulario es un marcador booleano (sin valor).
-b, --job_type <Unattended|NonProduction>	--runtime-type <Unattended|Headless|Serverless|NonProduction|Development|TestAutomation>	Enumeración más amplia
-o, --organizationUnit <folder>	--folder-path <path> o --folder-key <guid>	U omite: uip infiere la carpeta a partir de la clave del proceso.

Marcadores de prueba

Ejecutar prueba de uipcli → ejecutar conjuntos de pruebas de uip tm + esperar de uip tm + obtener informe de uip tm

Indicador heredado	uip target	Notas
-s, --testset <name>	--test-set-key <key> Activado uip tm testsets run	Clave, no nombre. Formato PROJECT:NN. Resolver con uip tm testsets list --project-key <key>.
-t, --testsetkey <key>	--test-set-key <key>	Mismo valor. Nota: el -t heredado entra en conflicto con el nuevo -t, --tenant CLI; utiliza la forma larga.
-P, --project-path <project.json>	(reelaboración)	El flujo heredado de empaquetar y probar sobre la marcha se divide: uip rpa pack → uip or packages upload → conjunto de pruebas de autor en Test Manager → uip tm testsets run. La creación del conjunto de pruebas es una configuración única.
-a, --projectKey <key>	--project-key <key> el uip tm wait / uip tm report get	projectKey: el conjunto de indicadores heredados projectKey para Test Manager; el nuevo indicador limita el ámbito de espera/informe a un proyecto de Test Manager. Mismo valor subyacente.
-e, --environment <name>	(sin equivalente)	Concepto de carpeta clásica.
-o, --organizationUnit <folder>	--folder-path <path> Activado uip tm testsets list	Se utiliza para encontrar el conjunto de pruebas; no en execute.
--out <junit|uipath>	--output-format <junit|uipath> Activado uip tm result download	Descargar después de la ejecución.
-r, --result_path <file>	--destination <path> Activado uip tm result download	Descargar después de la ejecución.
-w, --timeout <seconds>	--timeout <seconds> Activado uip tm wait	Misma semántica, diferente verbo.
-i, --input_path <file>	--input-path <file> Activado uip tm testsets run	Exactamente la misma bandera; el esquema para el archivo JSON no ha cambiado.
--attachRobotLogs	(usa uip tm attachment download después de la ejecución)
--retryCount <n>	uip tm executions retry --execution-id <id>	Vuelve a ejecutar los casos fallidos. Sin reintento automático en el lanzamiento.
--repositoryUrl, --repositoryCommit, --repositoryBranch, --repositoryType, --projectUrl, --releaseNotes, --disableBuiltInNugetFeeds, --nugetConfigFilePath, --author	(no en uip tm)	Estas eran entradas del lado del paquete cuando test run tenía que empaquetar primero. Pertenecen a uip rpa pack.

prueba uipcli paralela

Indicador heredado	uip equivalente
--testsConfigurationFilePath <file>	(sin equivalente) : escribe un bucle de shell sobre uip tm testsets run
--projectsRootDirectoryPath <dir>	(sin equivalente)
--executionArtifactsDirectoryPath <dir>	--destination <path> el uip tm result download y uip tm attachment download, ejecutar por ejecución
--cliDirectoryPath <uipcli.dll>	(sin equivalente)
--out <junit|uipath>	--output-format Activado uip tm result download
--disableBuiltInNugetFeeds	(no en uip tm; utilizar en uip rpa pack al empaquetar proyectos de prueba)
--projectKey <key>	--project-key <key>
--author <name>	(no en uip tm)

Marcadores de activos

Ambos verbos heredados (asset deploy y asset delete) consumían un archivo CSV; la nueva CLI no tiene implementación masiva: recorre las filas de CSV y llama a uip resource assets create / delete por fila. Consulta Mapa de comandos: activo.

Indicador heredado	uip equivalente	Notas
<assets_file> (posicional)	(analizar el CSV en el shell)	—
<orchestrator_url> (posicional)	(sesión)	—
<orchestrator_tenant> (posicional)	-t, --tenant	—
Columna CSV name	<name> (posicional) en uip resource assets create	—
Columna CSV value	<value> (posicional)	—
Columna CSV type	--type <Text|Bool|Integer|Credential|Secret>	No distingue entre mayúsculas y minúsculas.
Columna CSV description	-d, --description <text>	—

Marcadores de solución

La estructura del verbo se conserva en gran medida; los nombres de los marcadores se normalizaron a kebab-case y el bloque de autenticación se contrajo en la sesión.

Marca heredada (en todos los verbos)	uip equivalente	Notas
-o, --output <dir> Activado solution pack	(posicional <outputPath>)	—
-v, --version <semver> Activado solution pack	--version <semver>	—
-n, --name <name> Activado solution pack	--name <name>	—
Bloque de autenticación (en cada verbo solution que afecta a Orchestrator)	Sesión desde uip login	—
--packageName <n> Activado solution deploy	--package-name <n> Activado uip solution deploy run	—
--packageVersion <v> Activado solution deploy	--package-version <v>	—
--folderName <n> Activado solution deploy	--folder-name <n>	—
<deploymentName> posicional en solution deploy-activate / solution deploy-uninstall	<deployment-name> el uip solution deploy activate / uip solution deploy uninstall	—

Telemetría y marcadores ocultos

Indicador heredado	Estado
-y, --disableTelemetry (oculto)	Reemplazado por env var UIPATH_TELEMETRY_DISABLED=1. Consulta Novedades: telemetría.
--origin (oculto)	Eliminado.
--captureCommandToJsonFile (oculto)	Eliminado junto con uipcli run.

Ver también

• Mapa de comandos : asignación por verbo con fragmentos antes/después.
• Cambios de última hora : autenticación, variables de entorno, códigos de salida, formato de salida estándar.
• Autenticación : los tres flujos de autenticación compatibles.
• Configuración : variables de entorno y prioridad de banderas.
• Opciones globales : --output, --output-filter, --log-level, --log-file.