robot
latest
false
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.
UiPath logo, featuring letters U and I in white

Guía del administrador de robots

Última actualización 12 de may. de 2025

Interfaz de la línea de comandos de Robot

La interfaz de línea de comandos de UiPath Robot es una herramienta que permite interactuar con el robot desde un terminal de línea de comandos. Utiliza el archivo UiRobot.exe para iniciar, detener o supervisar las automatizaciones attended y unattended directamente desde la línea de comandos. También puedes obtener detalles sobre los paquetes instalados, crear registros o actualizar configuraciones.

Cómo funciona

Para utilizar la CLI, asegúrate de lo siguiente:

  • El mantenimiento de robot de UiPath se está ejecutando

  • Estás en el directorio en el que está instalado el robot.

A continuación, introduce las instrucciones o comandos que se refieran al programa UiRobot.exe junto con los parámetros necesarios, dependiendo de lo que deseas que logre tu automatización.

Por ejemplo, para iniciar un proceso desde la línea de comandos, se utilizaría el siguiente comando:

UiRobot.exe -file "C:\UiPath\Projects\YourProject\Main.xaml".UiRobot.exe -file "C:\UiPath\Projects\YourProject\Main.xaml".

Comandos comunes de UiRobot.exe

Ejecutar

Utiliza este comando para iniciar la ejecución de un archivo de proyecto de los siguientes tipos:
  • JSON

  • XAML

  • NUPKG

Nota:

A partir de la versión 2023.4 de Robot, UiPath actualiza la lista de procesos al mismo tiempo que se ejecuta un proceso. Si hay una actualización de proceso disponible al inicio del trabajo, el trabajo utiliza la versión anterior del proceso. Las ejecuciones posteriores aplican el proceso actualizado.

El comando de ejecución utiliza los siguientes argumentos:

UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]
  • -p--process <Package_ID> (obligatorio): inicia la ejecución de un proceso local o de Orchestrator.

    Ejemplos:

    UiRobot.exe execute --process UiPathDemoProcessUiRobot.exe execute --process UiPathDemoProcess
    UiRobot.exe execute -p UiPathDemoProcessUiRobot.exe execute -p UiPathDemoProcess
  • -f--file <File_Path> (obligatorio): inicia la ejecución de un archivo de proyecto local. El archivo de destino puede ser JSON, XAML o NUPKG.

    Ejemplos:

    UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"
    UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"
    UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"
  • --folder <Orchestrator_Folder_ID> (opcional): te permite especificar la carpeta de Orchestrator desde la que instalar y ejecutar el proceso de destino. Solo se puede utilizar junto con el argumento --process.

    Ejemplo:

    UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1
  • --input <Input_Parameters> (opcional): te permite especificar argumentos de entrada para la ejecución. Se puede utilizar con los argumentos --process o --file.

    Ejemplos:

    UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}"
    UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}"
    UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}"
  • --entry <entrypoint> (opcional): te permite seleccionar el punto de entrada de un proceso al iniciarlo a través de la línea de comandos.

    Ejemplo:

    UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"

Importante:
  • Los siguientes comandos no son compatibles con proyectos de Windows o multiplataforma:

    • UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml"
    • UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"
  • No se pueden utilizar los argumentos --process (-p) y --file (-f) simultáneamente en el comando de ejecución.

Proceso de instalación

Utiliza este comando para instalar un proceso. Si el robot está conectado a Orchestrator, busca el proceso en la fuente de Orchestrator. Sin una conexión de Orchestrator, el robot utiliza la fuente local.

El comando del proceso de instalación utiliza los siguientes argumentos:

UiRobot.exe installprocess [--process-name <process_name>] [--folder <orchestrator_folder>]UiRobot.exe installprocess [--process-name <process_name>] [--folder <orchestrator_folder>]
  • --process-name <process_name> (obligatorio): el nombre del proceso que deseas instalar.

    Ejemplo:

    UiRobot installprocess --process-name MyProcessUiRobot installprocess --process-name MyProcess
  • --folder <orchestrator_folder> (opcional): el nombre de la carpeta de Orchestrator que contiene el proceso que deseas instalar. Este argumento se aplica solo cuando la conexión a Orchestrator está activa. Si solo una carpeta contiene el proceso de instalación, omite este parámetro.

    Ejemplo:

    UiRobot installprocess -p MyProcess --folder MyOrchestratorFolderUiRobot installprocess -p MyProcess --folder MyOrchestratorFolder

Conectar

Utiliza este comando para conectar tu robot a una instancia de Orchestrator. Si tu robot ya está conectado a Orchestrator y ejecutas este comando, se devuelve el mensaje "Orchestrator ya está conectado".

El comando de conexión utiliza los siguientes argumentos:

UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]
  • connect: establece la conexión a Orchestrator. Debe utilizarse juntos los argumentos --url, --key o --clientID --clientSecret. Si no especificas estos argumentos, el comando utiliza la configuración de Configuración de Orchestrator.

    Ejemplos:

    // no arguments
    
    UiRobot.exe connect// no arguments
    
    UiRobot.exe connect
    //using the machine key
    
    UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-ABCD-1234-7788GG99HH00//using the machine key
    
    UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-ABCD-1234-7788GG99HH00
    
    //using the client ID and secret
    
    UiRobot.exe connect --url https://demo.uipath.com/ --clientID 696CCA0C-1234-ABCD-1234-F65BBC2F15DE --clientSecret QJX!jv12345A4q4N//using the client ID and secret
    
    UiRobot.exe connect --url https://demo.uipath.com/ --clientID 696CCA0C-1234-ABCD-1234-F65BBC2F15DE --clientSecret QJX!jv12345A4q4N

Desconectar

Utiliza este comando para desconectar el Robot de la instancia actual de Orchestrator.

El comando desconectar utiliza los siguientes argumentos:

UiRobot.exe disconnect --force | --waitUiRobot.exe disconnect --force | --wait
  • disconnect: desconecta el Robot de Orchestrator solo cuando no hay trabajos en ejecución en la máquina del robot.

    Ejemplo:

    UiRobot.exe disconnectUiRobot.exe disconnect
  • --force: elimina todos los trabajos en ejecución en la máquina y luego desconecta el robot de Orchestrator.

    Ejemplo:

    UiRobot.exe disconnect --forceUiRobot.exe disconnect --force
  • --wait: espera a que se completen los trabajos en ejecución antes de desconectar el robot de Orchestrator.

    Ejemplo:

    UiRobot.exe disconnect --waitUiRobot.exe disconnect --wait

Trace

Utiliza este comando para habilitar o deshabilitar el seguimiento de bajo nivel para el robot.

El comando de seguimiento utiliza los siguientes argumentos:

UiRobot.exe trace --enableLowLevel | --disableLowLevelUiRobot.exe trace --enableLowLevel | --disableLowLevel
  • --enableLowLevel: habilita el seguimiento detallado para el ejecutor de robot y el servicio en el visor de eventos. Genera un archivo ETL que puedes abrir con el Visor de eventos para ayudar a resolver problemas de bloqueos y errores.

    Ejemplo:

    UiRobot.exe trace --enableLowLevelUiRobot.exe trace --enableLowLevel
  • --disableLowLevel: deshabilita el seguimiento detallado para el ejecutor y el mantenimiento de robot de UiPath. Genera un archivo ETL que puedes abrir con el Visor de eventos para ayudar a resolver problemas de bloqueos y errores.

    Ejemplo:

    UiRobot.exe trace --disableLowLevelUiRobot.exe trace --disableLowLevel

PiP

Utiliza este comando para habilitar o deshabilitar la sesión del robot o la capacidad Picture in Picture en la máquina. Este ajuste modifica las instalaciones existentes y se aplica a todos los usuarios en la máquina local. Requiere privilegios de administrador.

El comando PiP utiliza los siguientes argumentos:

UiRobot.exe pip --enable | --disableUiRobot.exe pip --enable | --disable
  • --enable: habilita la sesión del robot (funcionalidad PiP) de la máquina.

    Ejemplo:

    UiRobot.exe pip --enableUiRobot.exe pip --enable
  • --disable: deshabilita la sesión del robot (funcionalidad PiP) de la máquina.

    Ejemplo:

    UiRobot.exe pip --disableUiRobot.exe pip --disable

Otros argumentos

Los siguientes argumentos son puramente informativos y no tienen impacto en tus proyectos de automatización:

  • --version: muestra información sobre la versión del Robot.

  • --help: muestra la lista de comandos compatibles, así como la información y ejemplos correspondientes.
  • flushlogs [--timeout <timeout_in_seconds>]: envía todos los registros pendientes a Orchestrator.

¿Te ha resultado útil esta página?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Uipath Logo White