UiPath Documentation
uipath-cli
latest
false
Importante :
Este contenido se ha traducido mediante traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Guía del usuario de UiPath CLI

RPA de UIP

uip rpa es la herramienta RPA: el puente entre la CLI y una instalación de UiPath Studio. Empaqueta proyectos de Studio en archivos .nupkg , ejecuta el analizador y compilador de flujos de trabajo, andamios y ejecuta proyectos, y expone las operaciones de Studio utilizadas por los agentes de codificación de IA y el sistema de habilidades.

Instálalo con o invoca uip tools install rpa y deja que se ejecute uip rpa … instalación automática. Consulta Herramientas (complementos) para el modelo de instalación y herramientas uip para el comando que gestiona la instalación de herramientas. rpa es el prefijo del comando; el paquete subyacente es @uipath/rpa-tool.

Before running the packager verbs in CI or on a fresh machine, make sure your runtime and runner OS match the project flavor — see Prerequisites.

Comandos

Cada verbo uip rpa tiene su propia página de referencia. Para obtener listas de argumentos activos en la versión de tu herramienta instalada, ejecuta uip rpa <verb> --help.

VerboDescripción
add-test-data-entityAñade una entidad de Data Service como origen de datos para un caso de prueba.
add-test-data-queueAñade una cola de datos de prueba desde Orchestrator como origen de datos para un caso de prueba.
add-test-data-variationAñade un archivo de variación de datos CSV/Excel a un caso de prueba.
analyzeEjecuta el analizador de flujo de trabajo en un proyecto con una política de gobernanza.
buildCompila un proyecto de Studio sin producir un .nupkg.
create-projectAplica andamios a un nuevo proyecto a partir de una plantilla.
diffMostrar diferencias entre dos archivos en una ventana de diferencias de Studio.
find-activitiesBuscar actividades que coincidan con una consulta y etiquetas opcionales.
get-analyzer-rulesEnumera las reglas del analizador de flujo de trabajo habilitadas para el proyecto abierto.
get-default-activity-xamlRecupera la representación XAML de una actividad con valores predeterminados.
get-errorsRecuperar diagnósticos de un archivo o de todo el proyecto, filtrados por gravedad.
get-manual-test-casesObtén casos de prueba manuales de Test Manager.
get-manual-test-stepsObtenga pasos de prueba manuales para una lista de ID de casos de prueba.
get-versionsEnumerar las versiones disponibles de un paquete NuGet en todas las fuentes configuradas.
get-workflow-exampleRecupera el XAML para un ejemplo de flujo de trabajo por clave.
indicate-applicationIndica una aplicación en pantalla utilizando Studio.
indicate-elementIndica un elemento de IU en la pantalla utilizando Studio.
inspect-packageInspecciona la API pública de un paquete NuGet a través de la reflexión.
install-data-fabric-entitiesAñada o elimine las vinculaciones de entidades de Data Fabric en el proyecto activo.
install-or-update-packagesInstala o actualiza los paquetes NuGet en el proyecto actual.
list-data-fabric-entitiesEnumerar las entidades de Data Fabric relevantes para el proyecto activo.
list-workflow-examplesBuscar ejemplos de flujo de trabajo de RPA por etiqueta de servicio.
packEmpaqueta un proyecto de Studio en un .nupkg.
restoreDescarga las dependencias declaradas en project.json
run-fileEjecutar o depurar un flujo de trabajo/archivo codificado.
search-templatesBuscar plantillas de proyecto en fuentes NuGet configuradas.
start-studioAsegúrate de que se esté ejecutando una instancia de Studio.
stop-executionDetener una ejecución en curso iniciada previamente con run-file.
uiaSubgrupo CLI de Automatización de IU.

list-instances también está registrado, oculto de --help : enumera las instancias de Studio en ejecución visibles para el resolver.

Sinopsis

uip rpa pack <project> [options]
uip rpa build <projectDir> [options]
uip rpa analyze <project> --governance-file-path <policy> [options]
uip rpa restore <project> [outputPath] [options]
uip rpa start-studio [options]
uip rpa <verb> [options]
uip rpa pack <project> [options]
uip rpa build <projectDir> [options]
uip rpa analyze <project> --governance-file-path <policy> [options]
uip rpa restore <project> [outputPath] [options]
uip rpa start-studio [options]
uip rpa <verb> [options]

Todos los verbos uip rpa respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Se aplican los códigos de salida estándar.

El grupo uip rpa principal acepta un pequeño conjunto de opciones compartidas por cada verbo:

Opción principalDescripción
--project-dir <path>Directorio del proyecto en el que opera el verbo. El valor predeterminado es el directorio de trabajo actual.
--studio-dir <path>Ruta a una instalación de Studio cuando la detección no puede encontrar una automáticamente.
--robot-dir <path>Ruta a un directorio de instalación de Robot.
--timeout <seconds>Espera máxima para la operación subyacente. Predeterminado: 300.
--verboseRegistro detallado.

Estos pueden pasarse antes o después del nombre del subcomando.

Nota:

Marcar superficie

Las páginas por verbo documentan las opciones principales. Como rpa-tool integra el empaquetador de Studio, un puñado de marcas de empaquetador de nicho (material de firma, configuración de fuentes de NuGet, filtros de tipo de salida) siguen las marcas nativas del empaquetador subyacente: ejecute uip rpa <verb> --help en una instalación en vivo para ver el conjunto completo para su versión de la herramienta instalada. Los nombres de los marcadores son coherentes en todas las versiones de la herramienta dentro de la línea MAYOR.MENOR de CLI; consulta Control de versiones y estabilidad.

Nota:

Envoltorio heredado solo para Windows

Una herramienta hermana, @uipath/rpa-legacy-tool (alias rpa-legacy), envuelve la .NET CLI heredada 2025.10 para los usuarios que necesitan características solo de Windows que aún no se han portado a multiplataforma uip rpa. Expone uip rpa-legacy <verb> para package, validate, debug, find-package, find-activities y type-definition. Consulta la documentación de .NET CLI 2025.10 heredado para su referencia de marcador. rpa-legacy es solo para Windows; rpa cubre la superficie moderna.

Requisitos previos

Two environmental constraints govern when and where the packager verbs can run.

.NET runtime

The packager verbs (pack, build, analyze, restore) wrap the Studio packager and the workflow compiler — both .NET-backed. A runner that invokes them must have a .NET runtime available.

For the full context on why rpa-tool keeps a .NET dependency while the rest of the CLI runs on Node.js, see Breaking changes — Runtime change.

Runner OS for Windows projects

Studio projects come in two non-legacy flavors — Cross-platform (targetFramework: "Portable" in project.json) and Windows (targetFramework: "Windows"). The runner OS must match the project flavor:

  • Cross-platform projects can be operated on from any OS — Windows, macOS, or Linux.
  • Windows projects require a Windows runner, regardless of which verb you are running. The Linux and macOS toolchain cannot resolve the Windows-only references these projects pull in.
  • Los proyectos Windows: heredados son una categoría independiente: requieren la herramienta uip rpa-legacy , que es solo para Windows por diseño.

Match the runner OS in your CI to the project flavor, or split the pipeline so cross-platform work runs on Linux/macOS and Windows project work runs on a Windows agent.

Ver también

  • Comandos
  • Sinopsis
  • Requisitos previos
  • .NET runtime
  • Runner OS for Windows projects
  • Ver también

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado