studio
2023.4
false
UiPath logo, featuring letters U and I in white
Guía de usuario de Studio
Last updated 18 de nov. de 2024

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:

DesktopFeature: indica que quieres instalar características de UiPath Robot y Studio.
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.
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.
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=DesktopFeature,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.
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 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 Gestionar 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

Aplica una licencia a tu instancia de Studio.

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: 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 : la extensión de Chrome se instala automáticamente en cada sistema a través del método de política de grupo sin conexión , el equivalente a llamar al comando /Chrome-Policy-Offline con la herramienta SetupExtensions.
  • POLICYONLINE : la extensión de Chrome se instala automáticamente en cada sistema a través del método de Política de grupo en línea , el equivalente a llamar al comando /ChromePolicyGlobal mediante la herramienta SetupExtensions.
  • MANUALPERMACHINE: la extensión de Chrome se instala para todos los usuarios, el equivalente a llamar al comando /ChromeGlobal usando la herramienta SetupExtensions.
  • NATIVEHOSTONLY: solo se instala el componente host nativo de mensajería (ChromeNativeMessaging.exe), el equivalente a llamar 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 se instala automáticamente en cada sistema a través del método de directiva de grupo sin conexión , el equivalente a llamar al comando /Edge-Policy-Offline con la herramienta SetupExtensions.
  • POLICYONLINE : la extensión de Edge se instala automáticamente en cada sistema a través del método de Política de grupo en línea , el equivalente a llamar al comando /Edge-Chromium-PolicyGlobal mediante la herramienta SetupExtensions.
  • MANUALPERMACHINE: La extensión para Edge está instalada para todos los usuarios, y es 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 llamar 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 Studio y UiPath Robot.

Nota: 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
Nota: esta acción deshabilita la telemetría tanto para Studio como para UiPath Robot.

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 de línea de comandos de UiPath.

Para habilitarlo, utiliza el siguiente parámetro:

  • ENABLE_PIP=1

Ejemplo:

UiPathStudio.msi ADDLOCAL=DesktopFeature,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

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, 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"
):: 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=DesktopFeature,Studio,Robot,RegisterService,Packages
  • Instalar Studio y un UiPath Robot en modo usuario solo para el usuario actual: UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Studio,Robot
  • Instala silenciosamente el conjunto de aplicaciones de escritorio: UiPathStudio.msi ADDLOCAL=DesktopFeature,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=DesktopFeature,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=DesktopFeature,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=DesktopFeature,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=DesktopFeature,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=DesktopFeature,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=DesktopFeature,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 de Anattended Robot:

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

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

    UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/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
Confianza y seguridad
© 2005-2024 UiPath. Todos los derechos reservados.