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 tabla muestra todos los parámetros de la línea de comandos disponibles.

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"'.

Comando	Descripción
/q	Te ayuda a instalar las características de UiPath® especificadas de forma silenciosa sin mostrar la interfaz de usuario.
/l*vx <LogFile>	Genera un archivo de registro del instalador en la ruta especificada. A partir de la versión v2018.4.2, este archivo también puede incluir información de la licencia si aplicas la licencia a Studio o a UiPath Robot en el momento de instalación. Puedes enviarle el archivo a nuestro equipo de soporte si, por cualquier razón, tienes dificultades durante el proceso de instalación.
ADDLOCAL	Te permite seleccionar qué características instalar. Si se utiliza ADDLOCAL, solo se instalarán las características especificadas en él. Si no se utiliza ADDLOCAL, se instalarán las siguientes características: el UiPath Robot en modo de servicio, los paquetes de actividades y el complemento JavaScript. Es compatible con las siguientes opciones: DesktopFeature: indica que quieres instalar la característica UiPath Robot. Robot: instala el UiPath Robot en modo usuario o en modo servicio, así como el Assistant. No se puede utilizar sin DesktopFeature. Para instalar el Robot en modo de servicio, añade también la opción RegisterService. Esa es la opción recomendada para robots desatendidos. Para instalar el UiPath Robot en modo de usuario, no añadas la opción RegisterService.Esa es la opción recomendada para robots atendidos y de desarrollo. Nota: si conviertes el UiPath Robot del modo de servicio al modo de usuario, puede que el UiPath Robot no sea capaz de acceder a los archivos .xaml desde la carpeta NuGet Packages original. Para obtener más información sobre cómo resolver este problema, consulta el artículo de resolución de problemas Los paquetes NuGet no son accesibles tras la migración. StartupLauncher: ejecuta el UiPath Robot al inicio de Windows. No se puede utilizar sin el argumento Robot. JavaBridge: instala Java Bridge para UiPath® para lograr una mejor integración y automatización de las aplicaciones Java. Ten en cuenta que la instalación de Java Bridge puede hacer que la instalación dure más tiempo de lo habitual. No se puede utilizar sin el argumento Robot. ChromeExtension: instala la extensión de Google Chrome para UiPath®. No se puede utilizar sin el argumento Robot. FirefoxExtension : por ejemplo : UiPathRobot.msi ADDLOCAL=Robot,ChromeExtension,FirefoxExtension /Q EdgeExtension: instala la extensión basada en Chromium de Microsoft Edge para UiPath.No se puede utilizar sin el argumento Robot. CitrixClient: instala la extensión de Citrix Client para UiPath®. No se puede utilizar sin el argumento Robot. JavaScriptAddOn: instala el complemento de integración del navegador para el UiPath Robot. VMwareExtension: instala la extensión UiPath® para VMware Horizon. No se puede utilizar sin el argumento Robot. WindowsRdpExtension: instala la extensión UiPath® para el escritorio remoto de Microsoft. No se puede utilizar sin el argumento Robot.
MSIINSTALLPERUSER	Te permite instalar solo para el usuario actual. Para instalarlos por usuario, añade MSIINSTALLPERUSER=1. Para instalarlos por máquina, no incluyas este parámetro. Las siguientes opciones no están disponibles en instalaciones por usuario: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
APPLICATIONFOLDER	Te permite instalar UiPath Robot en una ubicación personalizada.
NUGET_OPTIONS	Este parámetro se recomienda si trabajas en un entorno sin conexión. Si se establece en DisableOnlineFeeds, este parámetro deshabilitará las fuentes oficiales y Community en línea de UiPath® para el Robot (solo se tendrán en cuenta las fuentes locales y de Orchestrator). Ten en cuenta que las fuentes URL no se eliminarán de los archivos de configuración; solo se omitirán. Puede utilizarse tanto para instalaciones como para actualizaciones.
PACKAGES_FOLDER	Te permite cambiar la ubicación de descarga de tus flujos de trabajo y sus dependencias para Studio y UiPath Robot.Esta carpeta puede ser específica del usuario o accesible para todos los usuarios desde una máquina.Este parámetro puede utilizarse tanto para robots en modo servicio como en modo usuario. Si no proporcionas este parámetro, la carpeta predeterminada será %userProfile%\.nuget\packages. Nota: al cambiar la carpeta de paquetes, asegúrate de que todos los usuarios que necesitan ejecutar procesos tienen acceso de lectura a esta carpeta. Nota: al usar el parámetro PACKAGES_FOLDER hay algunas limitaciones. Encuentra más en las carpetas de paquete personalizadas y la documentación de rutas de red. Para instalaciones en máquinas con Windows Server (que permiten la ejecución concurrente: robots HD), debes proporcionar rutas específicas para cada usuario. Más información sobre el uso de la misma ruta para varios robots. Para obtener información sobre cómo cambiar la carpeta de descarga para los paquetes tras la instalación, consulta Administrar paquetes de actividades.
CUSTOM_NUGET_FEEDS	Te permite añadir fuentes de actividades de NuGet personalizadas para Studio o UiPath 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 (;). 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. Se puede utilizar en instalaciones limpias o en actualizaciones de tus instancias. Si este parámetro no se especifica en el momento de la implementación, no se habilitará la firma del paquete. Es compatible con las siguientes opciones: 1: el UiPath Robot puede descargar, instalar o ejecutar solo paquetes firmados por el autor o el repositorio por UiPath®. Si quieres añadir tu propio certificado como fuente de confianza, puedes hacerlo modificando el archivo nuget.config. Para descubrir cómo hacerlo, consulta esta página. 0: no se aplica ninguna regla de firma de paquetes a la implementación de tu UiPath Robot. Para obtener información sobre cómo aplicar la ejecución firmada después de la instalación, consulta Firma de paquetes.
CODE	Licencia tu instancia de UiPath Robot.
CLIENT_ID y CLIENT_SECRET	Conecta automáticamente el UiPath Robot a Orchestrator utilizando las credenciales del cliente a la vez que lo instala. 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 para la extensión de Chrome. Este parámetro requiere que el instalador se ejecute con derechos de administrador. Si se omite, se selecciona automáticamente el método de instalación más adecuado. Es compatible con 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 Chrome se instala automáticamente por el sistema mediante el método En línea de la política de grupo, el equivalente a invocar el /ChromePolicyGlobalcomando 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. Este parámetro requiere que el instalador se ejecute con derechos de administrador. Si se omite, se selecciona automáticamente el método de instalación más adecuado. Es compatible con 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 los archivos XAML para los UiPath Robots instalados como servicio de Windows. Los archivos XAML no seguros permiten a los usuarios leer y modificar los archivos del proceso y la lógica. Es compatible con las siguientes opciones: 0: la opción predeterminada. Cuando se utiliza, habilita la seguridad para los archivos XAML para los UiPath Robots de servicio de Windows. 1: deshabilita la seguridad para los archivos XAML para los UiPath Robots de servicio de Windows. Nota: este parámetro solo puede utilizarse durante una instalación limpia o una actualización.
SERVICE_URL	Te permite definir la URL de la instancia de Orchestrator a la que los usuarios se conectarán usando el inicio de sesión interactivo. La URL proporcionada se guarda en el archivo uipath.config y solo se guarda para los UiPath Robots en modo de usuario. Para las instalaciones en modo de servicio, el argumento se ignora. Al ejecutar el instalador para actualizar desde una versión anterior o cambiar tu instalación existente, este parámetro es compatible si cambias el UiPath Robot del modo de servicio al modo de usuario (no se incluye la opción RegisterService).
ORCHESTRATOR_URL	En instalaciones limpias, puedes especificar la URL principal de Orchestrator, utilizada para recuperar información de actualización automática (por ejemplo, https://orchestrator.local/organizationName/tenantName).
TELEMETRY_ENABLED	Te permite deshabilitar la recopilación de datos de uso y puede llevarse a cabo en el momento de la instalación de UiPath Robot. La telemetría está habilitada de forma predeterminada para Studio y UiPath Robot. Para deshabilitarla, utiliza el siguiente valor para el parámetro cada vez que realices una instalación limpia o una actualización: TELEMETRY_ENABLED=0 Si quieres habilitar la telemetría, no incluyas el parámetro, o inclúyelo con el valor siguiente: TELEMETRY_ENABLED=1 Para obtener más información sobre la recopilación de datos de uso y cómo cambiar la configuración de telemetría, consulta el documento Deshabilitar la telemetría.
ENABLE_PIP	Te permite habilitar la funcionalidad Imagen en imagen de la máquina durante la instalación desde la línea de comandos de UiPath®. Para habilitarlo, utiliza el siguiente parámetro: ENABLE_PIP=1 Ejemplo: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	Te permite seleccionar el idioma de visualización del instalador. Si no se especifica, el idioma configurado en Windows determinará el idioma de instalación. Para especificar el idioma escribe el parámetro INSTALLER_LANGUAGE=<language_code>. Las siguientes opciones están disponibles: Chino (simplificado): INSTALLER_LANGUAGE=2052 Francés: INSTALLER_LANGUAGE=12 Alemán: INSTALLER_LANGUAGE=7 Japonés: INSTALLER_LANGUAGE=17 Coreano: INSTALLER_LANGUAGE=1 Portugués (Portugal): INSTALLER_LANGUAGE=22 Portugués (Brasil): INSTALLER_LANGUAGE=1046 Ruso: INSTALLER_LANGUAGE=25 Español (España): INSTALLER_LANGUAGE=10 Español (México): INSTALLER_LANGUAGE=2058 Turco: INSTALLER_LANGUAGE=31
ASSISTANT_OPTIONS	Le permite especificar si habilitar o deshabilitar el widget de Marketplace para Assistant. Para habilitar el widget, utiliza ASSISTANT_OPTIONS=EnableMarketplace o no incluyas el parámetro. Para deshabilitar el widget, usa ASSISTANT_OPTIONS=DisableMarketplace.
ORCHESTRATOR_AUTO_SIGNIN	Si instalas el robot atendido en modo de usuario y tu entorno está configurado para usar SSO con Azure Active Directory, esto habilita el inicio de sesión automático en tu cuenta. Este parámetro debe utilizarse junto con ORCHESTRATOR_URL. Para habilitar esta opción, utilice ORCHESTRATOR_AUTO_SIGNIN=1

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_"