Migración: marca cambia el nombre

Referencia de cambio de nombre de marcadores para migrar de `uipcli` a UiPath CLI, agrupados por dominio.

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.
• 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 activado uip login	Una vez establecido al iniciar sesión, cada comando posterior utiliza este tenant. Cámbialo en mitad de la sesión con uip login tenant set <name>, sin volver a autenticarte.
-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

La mayoría de las marcas de PascalCase heredadas se convierten en kebab-case en uip rpa (por ejemplo, --outputType → --output-type), pero varias se renombran por completo o se eliminan por completo en lugar de solo volver a escribirse; consulta la columna de notas en cada tabla a continuación. Ejecuta uip rpa pack --help para obtener la lista completa en tu versión de herramienta instalada.

paquete paquete

Varios marcadores no siguen la regla simple de camelCase a kebab-case a continuación, verificada contra la fuente real (rpa-tool/src/commands/packager/pack.ts) en lugar de asumida:

Indicador heredado	uip rpa pack	Notas
<workspace_path> (posicional)	[project-dir] (posicional, opcional)	Ruta al directorio del proyecto, project.json o un archivo .uip. El valor predeterminado es --project-dir o el directorio actual.
-o, --output <dir>	[output-path] (posicional) o --output-path <path>	No hay alias corto -o . Obligatorio, páselo como la segunda posición o a través de --output-path; el comando da error si se omiten ambos.
-v, --version <semver>	--package-version <version>	No hay -v alias corto y el propio marcador es --package-version, no --version.
--autoVersion	(sin equivalente, este marcador no existe)	No hay marca de generación automática de versión en uip rpa pack. Calcule la versión usted mismo y pase --package-version.
--outputType <Process|Library|Tests|Objects>	--output-type <Process|Library|Tests|Objects>	Fuerza el tipo de salida.
--splitOutput	--split-packages	No es un cambio de nombre puro de kebab-case : el propio marcador pasa a llamarse --split-packages.
--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	--signing-certificate-path, --signing-certificate-password, --signing-timestamp-server	No es un caso de kebab puro : los tres obtienen un prefijo signing- .
--author <name>	--package-author <name>	No --author : el marcador es --package-author.
--governanceFilePath <policy>	--governance-file-path <policy>	Ejecuta el analizador como parte del paquete. --governance-file-type <type> también está disponible (enumeración de opciones) si no se puede inferir el formato de archivo.
(sin equivalente heredado)	--package-id <id>, --package-description <desc>, --skip-analyze, --skip-dependency-optimization, --include-sources / --no-include-sources, --detailed-log-path <path>	Nuevos marcadores sin contraparte uipcli package pack heredada.
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

Verificados con la fuente real (rpa-tool/src/commands/packager/analyze.ts), varios marcadores heredados no tienen equivalente en absoluto, en lugar de simplemente estar indocumentados:

Indicador heredado	uip rpa analyze
<workspace_path> (posicional)	[project-dir] (posicional, opcional, el valor predeterminado es --project-dir o el directorio actual)
--governanceFilePath <policy>	--governance-file-path <policy> (alias: --policy-file <path>)
--analyzerTraceLevel <Off|Error|Warning|Info|Verbose>	(sin equivalente, este marcador no existe)
--stopOnRuleViolation	(sin equivalente, este marcador no existe). El control disponible más cercano es --default-severity <level>, que establece la gravedad predeterminada para las reglas que no especifican la suya propia.
--treatWarningsAsErrors	(sin equivalente, este marcador no existe)
--resultPath <path>	(sin equivalente, este marcador no existe). uip rpa analyze escribe sus hallazgos en la salida estándar en el --format seleccionado; redirígelo tú mismo (uip rpa analyze ... > result.json).
--ignoredRules <id1,id2>	(sin equivalente, este marcador no existe)
(sin equivalente heredado)	--governance-file-type <type>, --policy-file-type <type> (alias de --governance-file-type, el valor predeterminado es AutomationOps cuando se proporciona un archivo de política/control), --repository-path <path> (paridad de Pipeline Analyze), --detailed-log-path <path>, --skip-analyze

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 Activado uip login	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>	--description <text> Activado uip or processes create	No hay -d alias corto en create: ese alias solo existe en uip or processes update.
--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 or 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

uip rpa restore solo toma las siguientes opciones comunes del empaquetador más sus dos posicionales, no hay marcadores específicos de restauración en absoluto (verificados con rpa-tool/src/commands/packager/restore.ts):

Indicador heredado	uip rpa restore
<workspace_path> (posicional)	[project-dir] (posicional, opcional)
--restoreFolder <dir>	[output-path] (posicional, opcional, debe estar FUERA del árbol de directorios del proyecto; omitir para restaurar solo en la caché NuGet compartida)
--nugetConfigFilePath <path>	--nuget-sources-config-path <path>
(sin equivalente heredado)	--exclude-configured-sources, --feed-folder <name> (resuelve las dependencias de la biblioteca desde una fuente de carpetas de Orchestrator en lugar de cada fuente de tenant)
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 Activado uip login	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-key <uuid> Activado uip tm testsets list	Se utiliza para encontrar el conjunto de pruebas; no en execute. Toma un GUID de carpeta (de uip or folders list), no una cadena de ruta: no hay ninguna opción --folder-path en testsets list.
--out <junit|uipath>	(sin equivalente)	uip tm result download no tiene opción --output-format: hoy en día solo se admite JUnit XML.
-r, --result_path <file>	--result-path <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>	--result-path <path> el uip tm result download y uip tm attachment download, ejecutar por ejecución
--cliDirectoryPath <uipcli.dll>	(sin equivalente)
--out <junit|uipath>	(sin equivalente) — uip tm result download no tiene opción --output-format ; solo se admite JUnit XML hoy en día
--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 or 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 Activado uip login	—
Columna CSV name	<name> (posicional) en uip or 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>	—
--deploymentParentFolder <path> Activado solution deploy	--parent-folder-path <path> (o --parent-folder-key <guid>) el uip solution deploy run	Nombra la carpeta principal en la que se crea la carpeta de implementació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.