Parámetros de la línea de comandos de UiPathRobot.msi

Puedes instalar el UiPath Robot ejecutando el instalador UiPathRobot.msi desde la línea de comandos.

Consulta las siguientes secciones para ver las descripciones de los parámetros disponibles y algunos ejemplos de uso.

Nota:

• Se necesitan derechos de administrador para ejecutar estos comandos.
• No se admite el uso de la opción /passive de msiexec.exe para ejecutar una instalación no asistida.

Descripciones de argumentos de la línea de comandos

La siguiente lista muestra todos los parámetros de línea de comandos disponibles.

• /q: instala silenciosamente, sin mostrarlo en la interfaz de usuario, las características de UiPath especificadas.
• /l*vx <LogFile>: genera un archivo de registro del instalador en la ruta especificada. Puedes enviarle el archivo a nuestro equipo de soporte si, por cualquier razón, tienes dificultades durante el proceso de instalación.
• ADDLOCAL: permite seleccionar las características que se instalan. Sin este parámetro, las siguientes características se instalan de forma predeterminada: robot en modo de servicio, paquetes de actividad predeterminados y complemento de JavaScript.

  Es compatible con las siguientes opciones:

  • DesktopFeature— indica que quieres instalar la característica UiPath Robot.
  • Studio (exclusivamente para UiPathStudio.msi) — Instala Studio. Debe utilizarse junto con el parámetro DesktopFeature.
  • ExcelAddin (exclusivamente para UiPathStudio.msi) — Instala el complemento de StudioX Excel. Debe utilizarse junto con el parámetro Studio.
  • Robot — Instala el robot en modo de usuario o modo de servicio, así como UiPath Assistant. Debe utilizarse junto con el DesktopFeatureparámetro.
  • RegisterService — Necesario para las instalaciones en modo de servicio. No lo añadas para instalaciones en modo de usuario.
  • StartupLauncher — Ejecuta el robot al inicio de Windows. Debe utilizarse junto con el parámetro DesktopFeature.
  • Packages (exclusivamente para UiPathStudio.msi) — instala los paquetes de actividad predeterminados. Debe utilizarse junto con el parámetro Robot.
  • JavaBridge — Instala el puente Java de UiPath para una mejor integración y automatización con aplicaciones Java. Añadir esto puede aumentar el tiempo de instalación. Debe utilizarse junto con el parámetro Robot.
  • ChromeExtension — Instala la extensión de Google Chrome. Debe utilizarse junto con el parámetro Robot.
  • FirefoxExtension — Instala la extensión de Firefox. Debe utilizarse junto con el parámetro Robot.
  • EdgeExtension — Instala la extensión basada en Microsoft Edge Chromium. Debe utilizarse junto con el parámetro Robot.
  • CitrixClient — instala la extensión del cliente de UiPath Citrix. Debe utilizarse junto con el parámetro Robot. No disponible para instalaciones por usuario.
  • JavaScriptAddOn — Instala el complemento de integración del navegador. Debe utilizarse junto con el parámetro Robot. No se puede utilizar con derechos elevados.
  • SapPlugin (exclusivamente para UiPathStudio.msi) — Instala el complemento de SAP Solution Manager. Requiere que se instale SAP Connector para Microsoft en tu máquina. En instalaciones limpias, también deberás proporcionar una dirección para la instancia utilizando el parámetro SAP_SOL_MAN_HOST. Debe utilizarse junto con el parámetro Studio. No disponible para instalaciones por usuario.
  • VMwareExtension — instala la extensión UiPath para VMware Horizon. Debe utilizarse junto con el parámetro Robot. No disponible para instalaciones por usuario.
  • WindowsRdpExtension — Instala la extensión UiPath para el escritorio remoto de Windows. Debe utilizarse junto con el parámetro Robot.
• MSIINSTALLPERUSER: te permite instalar solo para el usuario actual.
  • Para instalarlos por usuario, añade MSIINSTALLPERUSER=1. Las siguientes opciones no están disponibles en instalaciones por usuario: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
  • Para instalarlos por máquina, no incluyas este parámetro.
• SAP_SOL_MAN_HOST (exclusivamente para UiPathStudio.msi): el Nombre del Host o la dirección IP de tu instancia de SAP Solución Gestor. Obligatorio para instalaciones limpias donde se ha añadido el parámetro SapPlugin en la opción ADDLOCAL.
• APPLICATIONFOLDER: Te permite instalar UiPath Robot en una ubicación personalizada.
• NUGET_OPTIONS - para entornos sin conexión. Si se establece como DisableOnlineFeeds, este parámetro deshabilita las fuentes oficiales y de Comunidad en línea de UiPath para el Robot, y utiliza exclusivamente Orchestrator y fuentes locales.
  Nota: Las fuentes de URL permanecen en los archivos de configuración, pero se ignoran.

• PACKAGES_FOLDER

  • Te permite cambiar la ubicación de descarga de tus flujos de trabajo y sus dependencias. La carpeta elegida puede ser específica del usuario o accesible para todos los usuarios en una máquina.
  • Sin este parámetro, la ubicación de descarga predeterminada es %userProfile%\.nuget\packages.

  • No disponible para instalaciones por usuario.

    Nota: Asegúrate de que todos los usuarios que necesitan ejecutar procesos tengan acceso de lectura a la nueva carpeta.
  • Descubre cómo configurar .
  • Para instalaciones en máquinas Windows Server que permiten la ejecución simultánea, debes proporcionar rutas específicas para cada usuario. Más información sobre .
  • Consulta cómo cambiar la carpeta de descarga de paquetes después de la instalación.
• CUSTOM_NUGET_FEEDS: te permite añadir fuentes de actividades de NuGet personalizadas para Studio y/o Robot. Este comando solo añade o actualiza la lista de fuentes existentes. Debe completarse con los pares de valores-claves del tipo cadena.
  • Las ubicaciones válidas incluyen fuentes en línea, rutas de carpetas y unidades de red compartidas.
  • Asegúrate de que todos los usuarios pueden acceder a las fuentes proporcionadas desde la máquina correspondiente.

  • Separa las fuentes con punto y coma (;).

    Por ejemplo:

    CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"

• ENFORCE_SIGNED_EXECUTION: Opcional. Te permite hacer que tus UiPath Robots ejecuten solo paquetes firmados. Sin este parámetro, la firma de paquetes no está habilitada. Tiene las siguientes opciones:
  • 1: el robot solo maneja paquetes firmados por autores o repositorios verificados por UiPath. Para añadir tu propio certificado como origen de confianza, modifica el archivo nuget.config.
  • 0: no se aplica ninguna regla de firma de paquetes a la implementación de tu UiPath Robot.
  Para obtener más información, consulta Firma de paquetes.
• CODE: licencia tu instancia de robot. No disponible para instalaciones por usuario.
• CLIENT_ID y CLIENT_SECRET: conecta automáticamente el Robot a Orchestrator con las credenciales del cliente, mientras lo instala. Por ejemplo:

  UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k

• CHROME_INSTALL_TYPE: te permite elegir el método de instalación de la extensión de Chrome. Necesita derechos de administrador. Sin este parámetro, se selecciona automáticamente el método más adecuado. Tiene las siguientes opciones:
  • POLICYOFFLINE: la extensión de Chrome es instalada automáticamente por el sistema mediante el método Sin conexión Política de grupo, el equivalente a invocar el /Chrome-Policy-Offlinecomando usando la herramienta SetupExtensions.
  • POLICYONLINE: la extensión de Edge es instalada automáticamente en cada sistema mediante el método En línea de la política de grupo, el equivalente a invocar el comando /Edge-Chromium-PolicyGlobal usando la herramienta SetupExtensions.
  • MANUALPERMACHINE: la extensión de Chrome se instala para todos los usuarios, el equivalente a invocar al comando /ChromeGlobal usando la herramienta SetupExtensions.
  • NATIVEHOSTONLY: solo se instala el componente host nativo de mensajería (ChromeNativeMessaging.exe), el equivalente a invociar al comando /ChromeNativeHostGlobal usando la herramienta SetupExtensions.
  Nota: Los nombres de los métodos de instalación antiguos (STORE, GLOBAL) se mantienen para la compatibilidad con versiones posteriores.
• EDGE_INSTALL_TYPE: te permite elegir el método de instalación de la extensión de Edge. Necesita derechos de administrador. Sin este parámetro, se selecciona automáticamente el método más adecuado. Tiene las siguientes opciones:
  • POLICYOFFLINE: la extensión de Edge es instalada automáticamente en cada sistema mediante el método Sin conexión de la política de grupo, el equivalente a invocar el comando /Edge-Policy-Offline usando la herramienta SetupExtensions.
  • POLICYONLINE: la extensión de Edge es instalada automáticamente en cada sistema mediante el método En línea de la política de grupo, el equivalente a invocar el comando /Edge-Chromium-PolicyGlobal usando la herramienta SetupExtensions.
  • MANUALPERMACHINE: La extensión para Edge se instala para todos los usuarios, y es el equivalente a llamar al comando /Edge-Chromium-Global con la herramienta SetupExtensions.
  • NATIVEHOSTONLY: solo se instala el componente host nativo de mensajería (ChromeNativeMessaging.exe), el equivalente a invociar al comando /Edge-Chromium-NativeHostGlobal usando la herramienta SetupExtensions.
  Nota: Los nombres de los métodos de instalación antiguos (STORE, GLOBAL) se mantienen para la compatibilidad con versiones posteriores.
• DISABLE_SECURE_XAML: te permite deshabilitar la seguridad de XAML los archivos para los robots instalados como servicio de Windows. Los archivos no seguros XAMLpermiten a los usuarios leer y modificar los archivos del proceso y la lógica. Tiene las siguientes opciones:
  • 0: la opción predeterminada. Habilita la seguridad para archivos XAML para Robots de servicio de Windows.
  • 1: deshabilita la seguridad para los archivos XAML para los UiPath Robots de servicio de Windows.
• SERVICE_URL: te permite definir la URL de la instancia de Orchestrator a la que se conectará con el inicio de sesión interactivo. Este valor se guarda en el uipath.config archivo. Requerido por las instalaciones en modo de usuario. Las instalaciones en modo de servicio ignoran este parámetro.
• ORCHESTRATOR_URL: en instalaciones limpias, puedes especificar la URL principal de Orchestrator, que se utiliza para recuperar información de las actualizaciones automáticas. Por ejemplo: https://orchestrator.local/organizationName/tenantName.
• TELEMETRY_ENABLED: te permite deshabilitar la colección de datos de uso. Tiene las siguientes opciones:
  • 0: deshabilita la telemetría para Studio y Robot.
  • 1: opción predeterminada.Habilita la telemetría para Studio y Robot.
  Consulta cómo excluirse de la telemetría.
• ENABLE_PIP: te permite habilitar la funcionalidad de sesión de robot (imagen en imagen) de la máquina. Tiene las siguientes opciones:
  • 0: opción predeterminada.La capacidad de sesión del robot está deshabilitada.
  • 1: habilita la capacidad de sesión del robot.
• INSTALLER_LANGUAGE: te permite seleccionar el idioma de visualización del instalador. Sin este parámetro, el instalador utiliza la configuración de idioma de Windows. Tiene las siguientes opciones:
  • 2052: chino (simplificado)
  • 12: francés
  • 7: alemán
  • 17: japonés
  • 1 - coreano
  • 22: portugués (Portugal)
  • 1046 - portugués (Brasil)
  • 25: ruso
  • 10 - español (España)
  • 2058: español (México)
  • 31 - turco
• ASSISTANT_OPTIONS - habilita o deshabilita el widget de Marketplace para Assistant. Tiene las siguientes opciones:
  • Ausente o EnableMarketplace: la opción predeterminada. Habilita el widget.
  • DisableMarketplace: deshabilita el widget.
• ORCHESTRATOR_AUTO_SIGNIN : habilita el inicio de sesión automático en tu cuenta. Para instalaciones y entornos de modo de usuario configurados para utilizar el SSO con Azure Active Directory. Debe utilizarse junto con el parámetro ORCHESTRATOR_URL . Tiene las siguientes opciones:
  • 0: deshabilita el inicio de sesión automático.
  • 1: habilita el inicio de sesión automático.

Usar rutas en la línea de comandos

Al introducir rutas, tenga en cuenta lo siguiente:

• Si hay que utilizar variables de entorno como %USERNAME% o %USERPROFILE%, debe evitarse el carácter especial % de la siguiente manera:
  • Cuando la configuración se invoca desde el símbolo del sistema, usa ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • En scripts por lotes, utiliza ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • En la consola PowerShell o scripts no es necesario evitarlo.
  • Cuando se utilizan cuentas de dominio de Active Directory, se recomienda especificar también el nombre del dominio en la estructura de carpetas, como por ejemplo C:\packages\^%UserDomain^%.^%Username^%.
• Si necesitas utilizar rutas con espacios, deben envolverse de la siguiente manera:
  • En el símbolo del sistema, rodear con comillas dobles (" "). Por ejemplo, UiPathRobot.msi APPLICATIONFOLDER="C:\folder name".
  • En PowerShell, entre comillas simples y dobles ('" "'). Por ejemplo,./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'.

Realización de una instalación síncrona

Si quieres realizar configuraciones adicionales después de haber completado la instalación, puedes ejecutar el instalador de forma síncrona. Esto te permite añadir otros comandos que se realizarán después de que termine el instalador, por ejemplo, puedes instalar y también configurar una conexión de robot o configurar fuentes.

Los siguientes scripts realizan la instalación y te permiten añadir otros comandos que se realizarán si la instalación tiene éxito.

:: Runnning the MSI synchronously
start /wait /b UiPathRobot.msi /Q
:: Assert the exit code and continue accordingly
set "_isSuccess="
if %ERRORLEVEL% EQU 0 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 1641 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 3010 Set "_isSuccess=1"
:: test for success and run follow-up commands
if (%_isSuccess% EQU 1) (
    echo "success"
) ELSE (
    echo "fail"
)

Ejemplos

Estos ejemplos se han escrito teniendo en cuenta que ya estás en el directorio en el que está ubicada el instalador de UiPathRobot.msi. Por ejemplo, puedes hacerlo con el siguiente comando: cd D:\UiPathInstaller.

• Instala el UiPath Robot en modo de usuario solo para el usuario actual: UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Robot
• Instala el UiPath Robot de forma silenciosa: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Instala el UiPath Robot y la extensión de Chrome mediante la política de forma silenciosa: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q

• Instala silenciosamente el UiPath Robot como servicio de Windows y conéctalo a Orchestrator:

  UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q

• Instala UiPath Robot de forma silenciosa como servicio de Windows y añade dos fuentes de actividad personalizadas: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• Instala y licencia un UiPath Robot de forma silenciosa registrado como servicio de Windows y la fuente de actividad local: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,CODE=1234567890 /Q
• Instala UiPath Robot como servicio de Windows y deshabilita las fuentes en línea oficiales: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Desinstala la extensión de Chrome - UiPathRobot.msi REMOVE=ChromeExtension /Q

• Configurar la conexión de actualización automática durante la instalación de Anattended Robot:

  UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService SERVICE_URL="https://demo.uipath.com/myorg/mytenant"

• Configurar la conexión de actualización automática durante la instalación de Unattended Robot:

  UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"