Parámetros de la línea de comandos

Puedes instalar y actualizar Studio y el Robot, o cambiar una instalación existente ejecutando el UiPathStudio.msio UiPathStudioCloud.msiinstalador 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 requieren derechos de administrador para ejecutar estos comandos. * No se admite el cambio de una instalación existente ejecutando el instalador desde la línea de comandos en modo silencioso. Sin embargo, puedes ejecutar el instalador en modo silencioso para actualizar desde una versión anterior. * No se admite el uso de la opción /passive de msiexec.exe para ejecutar una instalación desatendida.

Descripciones de argumentos de la línea de comandos

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

Puedes utilizar todos los parámetros para instalaciones limpias, pero solo los siguientes son compatibles al actualizar desde una versión anterior o cambiar una instalación existente:

• Habilita características usando ADDLOCAL.
• Deshabilita funciones con REMOVE. Ten en cuenta que el UiPath Robot no se puede deshabilitar.
• Habilita o deshabilita las opciones del Asistente con ASSISTANT_OPTIONS.
• SERVICE_URL: disponible al cambiar el UiPath Robot del modo de servicio al modo de usuario sin incluir el argumento RegisterService.
• NUGET_OPTIONS, ENFORCE_SIGNED_EXECUTION, DISABLE_SECURE_XAML y TELEMETRY_ENABLED: disponible al actualizarse desde una versión anterior, no disponible al cambiar una instalación existente.
• Consulta la dirección del servidor proxy, ya sea IP o nombre de dominio, usando PROXY_ADDRESS.

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 ^ - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • En scripts por lotes, utiliza ^ - UiPathStudio.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, UiPathStudio.msi APPLICATIONFOLDER="C:\folder name".
  • En PowerShell, entre comillas simples y dobles ('" "'). Por ejemplo, ./UiPathStudio.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	Para instalar el robot en modo de servicio, añade 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. Si conviertes el Robot del modo de servicio al modo de usuario, es posible que el Robot no pueda acceder a los archivos .xaml de la carpeta original de Paquetes NuGet. Para obtener más información sobre cómo resolver este problema, consulta el artículo de resolución de problemas No se puede acceder a los paquetes NuGet tras la migración. StartupLauncher: ejecuta el robot al iniciar Windows. No se puede utilizar sin el argumento Robot. JavaBridge: instala UiPath Java Bridge para mejorar la integración y automatización de las aplicaciones Java. La instalación de Java Bridge puede hacer que la instalación tarde más de lo habitual. No se puede utilizar sin el argumento Robot. ChromeExtension: instala la extensión UiPath de Google Chrome. No se puede utilizar sin el argumento Robot. FirefoxExtension – Installs the UiPath Mozilla Firefox Extension. It cannot be used without the Robot argument. Example: UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension. EdgeExtension: instala la extensión UiPath para Microsoft Edge (basado en Chromium). No se puede utilizar sin el argumento Robot. CitrixClient: instala la extensión de cliente de Citrix de UiPath. No se puede utilizar sin el argumento Robot. JavaScriptAddOn: instala el complemento de JavaScript de robot necesario para el SDK de JavaScript de robot. SapPlugin: instala el complemento de SAP Solution Manager. Requiere el conector de SAP para Microsoft. Para instalaciones limpias, también debes proporcionar la dirección de la instancia utilizando SAP_SOL_MAN_HOST. No se puede utilizar sin Studio. VMwareExtension: instala la extensión de UiPath para VMware Horizon. No se puede utilizar sin el argumento Robot. WindowsRdpExtension: instala la extensión de UiPath para el escritorio remoto de Microsoft. No se puede utilizar sin el argumento Robot. AmazonWorkSpacesClient: instala la extensión de UiPath para Amazon WorkSpaces. No se puede utilizar sin el argumento Robot. LiveStreaming: instala el software de transmisión en vivo (RealVNC) necesario para la depuración remota.Consulta la característica de transmisión en vivo en la guía del robot.
MSIINSTALLPERUSER	Este parámetro te permite instalar Studio y Robot por usuario o por máquina. Si no se incluye el parámetro, la instalación es por máquina. Si añades el parámetro MSIINSTALLPERUSER=1, la instalación es por usuario. El parámetro solo se puede utilizar cuando se realiza una instalación limpia. Las siguientes opciones no están disponibles en instalaciones por usuario: RegisterService, CitrixExtension, VMwareExtension, SapPlugin, PACKAGES_FOLDER, CODE.
SAP_SOL_MAN_HOST	Nombre de host o dirección IP para tu instancia de SAP Solution Manager. Obligatorio para instalaciones limpias si se proporciona el argumento SapPlugin para la opción ADDLOCAL. Por ejemplo, UiPathStudio.msi ADDLOCAL=Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address
APPLICATIONFOLDER	Te permite instalar Studio y 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 UiPath 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. Al actualizar, puedes establecer el parámetro en EnableOnlineFeeds para habilitar fuentes en línea. Nota: el parámetro NUGET_OPTIONS no deshabilita las fuentes oficiales de UiPath y Community en línea para Studio.
PACKAGES_FOLDER	Te permite cambiar la ubicación de descarga de tus flujos de trabajo y sus dependencias para Studio y/o 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 de servicio como para robots en modo de usuario. Si no proporcionas este parámetro, la carpeta predeterminada será %userProfile%\\.nuget\\packages. Al cambiar la carpeta de paquetes, asegúrate de que todos los usuarios que necesiten ejecutar procesos tengan acceso de lectura a esta carpeta. Al utilizar el parámetro PACKAGES_FOLDER, hay algunas limitaciones. Obtendrás más información en la documentación de carpetas de paquetes y rutas de red personalizadas . Para instalaciones en máquinas Windows Server (que habilitan la ejecución simultánea: HD Robots), debes proporcionar rutas específicas para cada usuario. Más información sobre cómo utilizar 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	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	Aplica una licencia a tu instancia de Studio.
CLIENT_ID y CLIENT_SECRET	Conecta automáticamente el UiPath Robot a Orchestrator utilizando las credenciales de cliente a la vez que lo instala. Ejemplo: UiPathStudio.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
CHROME_INSTALL_TYPE	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. Los nombres de los métodos de instalación antiguos ( STORE , GLOBAL ) se mantienen para garantizar la compatibilidad con versiones anteriores.
EDGE_INSTALL_TYPE	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. Los nombres de los métodos de instalación antiguos ( STORE , GLOBAL ) se mantienen para garantizar la compatibilidad con versiones anteriores.
DISABLE_SECURE_XAML	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. 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	TELEMETRY_ENABLED=0 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	ENABLE_PIP=1 Ejemplo: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	Chino (simplificado): INSTALLER_LANGUAGE=2052 Inglés: INSTALLER_LANGUAGE=9 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	Para habilitar el widget, utiliza ASSISTANT_OPTIONS=EnableMarketplace o no incluyas el parámetro. Para deshabilitar el widget, utiliza ASSISTANT_OPTIONS=DisableMarketplace .
ORCHESTRATOR_AUTO_SIGNIN	Si instalas el attended robot en modo de usuario y tu entorno está configurado para utilizar SSO con Azure Active Directory , esto permite el inicio de sesión automático en tu cuenta. Este parámetro debe utilizarse junto con ORCHESTRATOR_URL. Para habilitar esta opción, utiliza ORCHESTRATOR_AUTO_SIGNIN=1 .
ENFORCE_DEFAULT_SERVICE_URL	Para instalaciones en modo de usuario, este parámetro aplica la URL de servicio predeterminada. Para habilitar esta opción, utiliza ENFORCE_DEFAULT_SERVICE_URL=1 . ORCHESTRATOR_URL también debe estar habilitado.
PROXY_SCRIPT_ADDRESS	Si utilizas este parámetro, no utilices otros parámetros específicos del proxy. Cuando todos los parámetros están presentes en el archivo UiPath.config, solo se utiliza la ScriptAddressclave.
PROXY_BYPASS_LOCAL_ADDRESS PROXY_BYPASS_LIST PROXY_USER_NAME PROXY_PASSWORD PROXY_DOMAIN	La dirección del servidor proxy, ya sea IP o nombre de dominio. Por ejemplo, http://my.proxy.net:8008.
PROXY_ADDRESS PROXY_BYPASS_LIST	Permite la conexión directa para direcciones locales, pasando el servidor proxy. Configúralo en 1 para pasar por la dirección local o en 0 de lo contrario.
PROXY_ADDRESS PROXY_BYPASS_LOCAL_ADDRESS	La lista de direcciones que se conectan directamente a Internet, pasando el servidor proxy. Debe contener cadenas RegExr que contienen las URL de los servidores a evitar. Por ejemplo, "server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}".
PROXY_USER_NAME (requiere PROXY_PASSWORD.)	La credencial del nombre de usuario para la autenticación del servidor proxy.
PROXY_PASSWORD	La contraseña asociada con el nombre de usuario para la autenticación del servidor proxy.
PROXY_DOMAIN	El dominio donde reside el servidor proxy, necesario para la autenticación.

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 UiPathStudio.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 UiPathStudio.msi. Por ejemplo, puedes hacerlo con el siguiente comando: cd D:\UiPathInstaller.

• Instala Studio, un UiPath Robot como servicio de Windows y los paquetes de actividades: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService
• Instalar Studio y un UiPath Robot en modo usuario solo para el usuario actual: UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot
• Instalar la característica de transmisión en vivo para las versiones 2024.10+ de Robot: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,LiveStreaming
• Instala silenciosamente el conjunto de aplicaciones de escritorio: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Instala silenciosamente todo el conjunto de aplicaciones de escritorio y la extensión de Chrome mediante directiva: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
• Instala silenciosamente Studio, el UiPath Robot como servicio de Windows y los paquetes de actividades, todo en la carpeta D:\UiPath: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService APPLICATIONFOLDER=D:\UiPath /Q
• Instala silenciosamente el UiPath Robot como servicio de Windows y conéctalo a Orchestrator:

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

• Instala silenciosamente Studio, el UiPath Robot como servicio de Windows y añade dos fuentes de actividad personalizadas: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• Instala silenciosamente y aplica una licencia a Studio, un UiPath Robot registrado como servicio de Windows y la fuente de actividad local: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CODE=1234567890 /Q
• Instala UiPath Robot como servicio de Windows y deshabilita las fuentes en línea oficiales: UiPathStudio.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Desinstala la extensión de Chrome - UiPathStudio.msi REMOVE=ChromeExtension /Q
• Configurar la conexión de actualización automática durante la instalación del Attended Robot: UiPathStudio.msi ADDLOCAL=Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"
• Configurar la conexión de actualización automática durante la instalación del Unattended Robot: UiPathStudio.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"