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 necesitan derechos de administrador para ejecutar estos comandos.
• No es posible cambiar una instalación existente ejecutando el instalador desde la línea de comandos en el modo silencioso. No obstante, 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 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.

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.
• 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.

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	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: Studio, el UiPath Robot en modo de servicio, los paquetes de actividades y el complemento JavaScript. Es compatible con las siguientes opciones: Studio: instala Studio. ExcelAddin: instala el complemento de Excel de StudioX. No se puede utilizar sin Studio. Robot: instala el UiPath Robot en modo usuario o en modo servicio, así como el Assistant. 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. 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. Packages: instala los paquetes de actividades. No se puede utilizar sin el argumento Robot. 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 para 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 : UiPathStudio.msi ADDLOCAL=Studio,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 JavaScript de UiPath Robot para admitir el SDK JavaScript de UiPath Robot. SapPlugin: Instala el plugin 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. No se puede utilizar sin Studio. VMwareExtension: instala la extensión UiPath para VMware Horizon. No se puede utilizar sin el argumento Robot. WindowsRdpExtension: instala la extensión UiPath para Escritorio remoto de Microsoft. No se puede utilizar sin el argumento 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 al realizar 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. It can be used for both installations and upgrades. The NUGET_OPTIONS parameter does not disable the online UiPath official and Community feeds for Studio.
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. Al cambiar la carpeta de paquetes, asegúrate de que todos los usuarios que necesiten ejecutar procesos tengan acceso de lectura a esta carpeta. When using the PACKAGES_FOLDER parameter, there are some limitations. Find out more in the custom package folders and network paths documentation. For installations on Windows Server machines (that enable concurrent execution - HD Robots), you must provide paths that are specific to each user. Read more about using the same path for multiple robots. For information on how to change the download folder for packages after installation, see Managing Activities Packages.
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 - The Robot is able to download, install, or execute only packages author or repository signed by UiPath. If you want to add your own certificate as a trusted source, you have to do so by modifying the nuget.config file. To learn how to do this, please see this page. 0: no se aplica ninguna regla de firma de paquetes a la implementación de tu UiPath Robot. For information on how to enforce signed execution after installation, see Signing Packages .
CODE	Aplica una licencia a tu instancia de Studio.
CONNECTIONSTRING	Automatically connects the Robot to Orchestrator on-premises using the connection string while also installing it. Please note that the following are required: el parámetro WindowsAuth.Enabled del archivo UiPath.Orchestrator.dll.config debe establecerse en true el parámetro WindowsAuth.Domain debe establecerse como un dominio válido the Service Mode Robot a Standard Machine configuration has to be in place. Automatic enrollment with standard machines using the CONNECTIONSTRING can only be used with Orchestrator v2020.10.
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	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 - The Chrome Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the /Chrome-Policy-Offline command using the SetupExtensions tool. POLICYONLINE - The Chrome Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the /ChromePolicyGlobal command using the SetupExtensions tool. MANUALPERMACHINE - The Chrome Extension is installed for all users, the equivalent of calling the /ChromeGlobal command using the SetupExtensions tool. NATIVEHOSTONLY - Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the /ChromeNativeHostGlobal command using the SetupExtensions tool. Los nombres de los métodos de instalación antiguos (STORE, GLOBAL) se mantienen para garantizar la compatibilidad con versiones anteriores.
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 - The Edge Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the /Edge-Policy-Offline command using the SetupExtensions tool. POLICYONLINE - The Edge Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the /Edge-Chromium-PolicyGlobal command using the SetupExtensions tool. MANUALPERMACHINE - The Edge Extension is installed for all users, the equivalent of calling the /Edge-Chromium-Global command using the SetupExtensions tool. NATIVEHOSTONLY - Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the /Edge-Chromium-NativeHostGlobal command using the SetupExtensions tool. Los nombres de los métodos de instalación antiguos (STORE, GLOBAL) se mantienen para garantizar la compatibilidad con versiones anteriores.
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. 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 Studio y UiPath Robot. Este parámetro solo puede utilizarse durante una instalación limpia o una actualización. 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 Esto deshabilita la telemetría tanto para Studio como para Robot. Si quieres habilitar la telemetría, no incluyas el parámetro, o inclúyelo con el valor siguiente: TELEMETRY_ENABLED=1 For more information about usage data collection and how to change telemetry settings, see the Opting Out of Telemetry document.
ENABLE_PIP	Te permite habilitar la funcionalidad Imagen en imagen de la máquina durante la instalación de línea de comandos de UiPath. Para habilitarlo, utiliza el siguiente parámetro: ENABLE_PIP=1 Ejemplo: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages 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 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
ORCHESTRATOR_AUTO_SIGNIN	For user-mode installations in environments configured to use SSO with Azure Active Directory, this parameter enables automatic sign-in to your account. Must be used together with ORCHESTRATOR_URL. Para habilitar esta opción, utiliza ORCHESTRATOR_AUTO_SIGNIN=1.
ENFORCE_DEFAULT_SERVICE_URL	Para las 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.

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,Packages

• Instalar Studio y un UiPath Robot en modo usuario solo para el usuario actual: UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot

• Instala silenciosamente el conjunto de aplicaciones de escritorio: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages,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,Packages,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,Packages 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,Packages 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_"