Instala desde la línea de comandos

Instala los clientes de escritorio de UiPath desde la línea de comandos en modo interactivo o silencioso, utilizando los parámetros y archivos de configuración UiPathPlatform.msi compatibles.

Puedes instalar los clientes de escritorio de UiPath con el instalador de UiPath Platform (UiPathPlatform.msi) desde la línea de comandos, en modo completamente interactivo o completamente silencioso, utilizando los parámetros MSI compatibles. El modo silencioso está destinado a implementaciones desatendidas. Para la instalación interactiva, consulta Instalar los clientes de escritorio.

Sintaxis

msiexec /i UiPathPlatform.msi [PARAMETER=value ...] [/qn]

Los parámetros se pasan como pares de PARAMETER=value después de la ruta del paquete. Envuelve valores que contienen espacios entre comillas dobles.

Modos de instalación

Mode	Interruptor	Descripción
Interactividad completa	(omitir)	Ejecuta el asistente de instalación con la IU completa. El usuario ve el progreso y todas las solicitudes.
Completamente silencioso	/qn	Se ejecuta sin interfaz de usuario ni cuadros de diálogo. Necesario para las implementaciones desatendidas.

Nota:

Usa /qn para las instalaciones desatendidas. Los modos de IU parcial (/qb, /qr) no son compatibles con los escenarios desatendidos, porque el instalador puede seguir mostrando cuadros de diálogo de bloqueo.

Parámetros compatibles

Parámetro	Valores	Predeterminado	Descripción
FORCE_PERUSER	1	—	Fuerza una instalación por usuario incluso cuando el usuario actual es un administrador.
CHANNEL	sts	sts para UiPathPlatformSTS.msi, community para UiPathPlatform.msi	Canal de actualización que sigue la plataforma. Pasa CHANNEL=sts para instalar el canal Enterprise STS con cualquier instalador.
PLATFORM_CONFIGURATION_FILE	Ruta absoluta del archivo	—	Ruta a un archivo de configuración de productos que se aplica durante la instalación.
UPDATER_CONFIGURATION_FILE	Ruta absoluta del archivo	—	Ruta a un archivo de configuración específico del actualizador que se aplica durante la instalación.
TELEMETRY_ENABLED	1 = habilitada, 0 = deshabilitada	enabled	Controla si se envían datos de telemetría.
INSTALLER_LANGUAGE	de, en, es, es-MX, fr, ja, ko, pt-BR, pt, ro, ru, tr, zh-CN, zh-TW	Idioma del sistema	Idioma de la interfaz de usuario del asistente de instalación. Sin efecto en el modo silencioso.

Ámbito de instalación

El instalador establece de forma predeterminada una instalación por usuario. Cambia a una instalación por máquina cuando se cumple alguna de las siguientes condiciones:

• msiexec se ejecuta elevado: desde un símbolo del sistema elevado (administrador) o como SYSTEM desde una herramienta de implementación como Microsoft Intune o Configuration Manager. Esto también se aplica a las instalaciones silenciosas.
• Un administrador ejecuta la instalación en modo interactivo, donde puede elevarse a través del Control de cuentas de usuario.

Una instalación silenciosa iniciada desde una solicitud no elevada permanece por usuario, incluso para un administrador, porque no puede solicitar elevación.

Nota:

UiPath recomienda una instalación por máquina, que mantiene los clientes de escritorio disponibles para todos los usuarios y gestionados de forma centralizada.

• Para forzar el modo por usuario incluso para un administrador, pasa FORCE_PERUSER=1.
• Para una instalación silenciosa por máquina, ejecuta msiexec elevado o impleméntalo como SYSTEM.

Ejemplos

Instalación interactiva

Canal predeterminado, asistente completo:

msiexec /i UiPathPlatform.msi

Canal específico y archivo de configuración:

msiexec /i UiPathPlatform.msi CHANNEL=sts PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json"

Forzar por usuario para un Administrator:

msiexec /i UiPathPlatform.msi FORCE_PERUSER=1

Instalación silenciosa

Canal predeterminado por usuario:

msiexec /i UiPathPlatform.msi /qn

Instalación silenciosa con un canal específico, un archivo de configuración y la telemetría deshabilitados:

msiexec /i UiPathPlatform.msi CHANNEL=sts PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json" TELEMETRY_ENABLED=0 /qn

Instalación silenciosa por máquina desde una herramienta de implementación como Intune o Configuration Manager (se ejecuta SYSTEM), con un registro de instalación detallado:

msiexec /i UiPathPlatformSTS.msi PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json" /qn /l*v "C:\Windows\Temp\UiPathPlatform-install.log"

Instalación limpia detrás de un proxy corporativo (proxy proporcionado a través del archivo de configuración del actualizador):

msiexec /i UiPathPlatform.msi UPDATER_CONFIGURATION_FILE="C:\Config\updaterConfig.json" /qn

Archivos de configuración

platformConfig.json (PLATFORM_CONFIGURATION_FILE)

Selecciona qué clientes de escritorio instalar y cualquier parámetro específico del producto.

El archivo contiene una lista Packages con una entrada por producto:

Campo	Descripción
PackageName	Nombre del producto, exactamente como se indica en Productos disponibles. El nombre distingue entre mayúsculas y minúsculas. Se ignora una entrada cuyo nombre no coincida con un producto.
InstallRequested	true para instalar el producto. Los productos que faltan en el archivo o están configurados como false no se instalan.
Parameters	Configuración específica del producto, como pares clave/valor de cadena. Usa {} cuando un producto no necesite configuración. Consulta Parámetros del producto.

Productos disponibles

PackageName	Instalaciones	También enumerar (obligatorio)	Complementos opcionales
Studio	Studio, incluidos los paquetes opcionales de Studio heredado y Actividades	Robot, Runtimes	Assistant, BrowserExtensions
Robot	Robot, incluido el paquete de transmisión en vivo opcional	Runtimes	BrowserExtensions
Assistant	Assistant	Robot (y por lo tanto Runtimes)	—
BrowserExtensions	Extensiones de navegador y escritorio remoto	—	—
Runtimes	Los runtimes de los que dependen los otros clientes de escritorio. Requerido por Robot y, por lo tanto, por Studio y Assistant.	—	—

Importante:

Los productos necesarios no se añaden automáticamente. Si los productos necesarios de un producto solicitado no se establecen también en "InstallRequested": true, la instalación falla y se revierte con el código de salida 1603. Consulta Resolución de problemas.

Cada configuración que instala Studio, Robot o Assistant también debe enumerar Runtimes con "InstallRequested": true.

Los productos necesarios reflejan la versión actual de Enterprise STS y pueden cambiar entre versiones.

Ejemplo: Robot con UiPath Assistant

Instala UiPath Robot, UiPath Assistant y sus runtimes, conecta UiPath Robot a Orchestrator e implementa las extensiones de Chrome y Edge a través de la política:

{
  "Packages": [
    {
      "PackageName": "Robot",
      "InstallRequested": true,
      "Parameters": {
        "SERVICE_URL": "https://cloud.uipath.com/org/tenant/orchestrator_"
      }
    },
    {
      "PackageName": "Runtimes",
      "InstallRequested": true,
      "Parameters": {}
    },
    {
      "PackageName": "Assistant",
      "InstallRequested": true,
      "Parameters": {}
    },
    {
      "PackageName": "BrowserExtensions",
      "InstallRequested": true,
      "Parameters": {
        "INSTALL_CHROME_EXTENSION": "True",
        "INSTALL_EDGE_EXTENSION": "True",
        "CHROME_INSTALL_TYPE": "PolicyOnline",
        "EDGE_INSTALL_TYPE": "PolicyOnline"
      }
    }
  ]
}

Ejemplo: Studio

Instala Studio con el paquete de Actividades, junto con su Robot y Runtimes necesarios, además de UiPath Assistant y la extensión de Edge:

{
  "Packages": [
    {
      "PackageName": "Studio",
      "InstallRequested": true,
      "Parameters": {
        "INSTALL_ACTIVITIES": "True"
      }
    },
    {
      "PackageName": "Robot",
      "InstallRequested": true,
      "Parameters": {
        "INSTALL_ROBOTJS": "True",
        "SERVICE_URL": "https://cloud.uipath.com/org/tenant/orchestrator_"
      }
    },
    {
      "PackageName": "Runtimes",
      "InstallRequested": true,
      "Parameters": {}
    },
    {
      "PackageName": "Assistant",
      "InstallRequested": true,
      "Parameters": {}
    },
    {
      "PackageName": "BrowserExtensions",
      "InstallRequested": true,
      "Parameters": {
        "INSTALL_EDGE_EXTENSION": "True"
      }
    }
  ]
}

Parámetros del producto

Los nombres de los parámetros distinguen entre mayúsculas y minúsculas. Los parámetros booleanos aceptan True o False (en cualquier caso); otros valores, como 1 o 0, se ignoran con una advertencia y se utiliza el valor predeterminado. Los nombres de parámetros no reconocidos se ignoran. Los parámetros booleanos son False de forma predeterminada, a menos que se indique lo contrario.

La mayoría de los parámetros coinciden con los parámetros de línea de comandos MSI clásicos del mismo nombre. Dado que los paquetes de Studio y Robot se separaron, la configuración de conexión de Robot y Orchestrator pertenece a Robot, no a Studio.

Studio

Parámetro	Valores	Descripción
INSTALL_ACTIVITIES	True, False	Instala el paquete de actividades.
INSTALL_STUDIO_LEGACY	True, False	Instala Studio Legacy.
INSTALL_EXCEL_ADDIN	True, False	Instala el complemento de Excel. Requiere Microsoft Excel y Visual Studio Tools para Office Runtime 10.0.50325 o posterior.
INSTALL_SAP_SOLMAN	True, False	Instala la integración de SAP Solution Manager. Requiere el conector de SAP para Microsoft en la máquina, y SAP_SOLMAN_HOST.
SAP_SOLMAN_HOST	Nombre de host o dirección IP	Host de SAP Solution Manager. Debe resolverse en la máquina.

Robot

Parámetro	Valores	Descripción
SERVICE_URL	URL absoluta	URL de Orchestrator a la que se conecta el robot.
REGISTER_ROBOT_SERVICE	True, False	Registra el robot como servicio de Windows (desatendido).
DISABLE_SECURE_XAML	True, False	Para un robot registrado como servicio de Windows, deshabilita la protección de archivos XAML, que permite a los usuarios leer y modificar los archivos de proceso. False mantiene los archivos XAML seguros.
INSTALL_ROBOTJS	True, False	Instala el complemento de JavaScript de UiPath Robot. Siempre instalado para instalaciones por usuario y attended.
INSTALL_LIVE_STREAMING	True, False	Instala el paquete de transmisión en vivo.
ORCHESTRATOR_AUTO_SIGNIN	True, False	Para un Attended Robot instalado por usuario en un entorno que utiliza el inicio de sesión único con Microsoft Entra ID, el usuario inicia sesión automáticamente. Requiere SERVICE_URL; no se puede combinar con REGISTER_ROBOT_SERVICE=True o las credenciales de cliente.
ENFORCE_DEFAULT_SERVICE_URL	True, False	Para instalaciones por usuario, aplica SERVICE_URL como la URL predeterminada de Orchestrator. Requiere SERVICE_URL.
ORCHESTRATOR_CLIENT_ID, ORCHESTRATOR_CLIENT_SECRET	Cadenas	Credenciales de cliente para un robot desatendido. Establece ambos, junto con SERVICE_URL y REGISTER_ROBOT_SERVICE=True.
LICENSE_KEY	Cadena	Clave de licencia del robot.
NUGET_OPTIONS	EnableOnlineFeeds, DisableOnlineFeeds	DisableOnlineFeeds desactiva las fuentes en línea UiPath Official y Community para el Robot, para entornos sin conexión. Predeterminado: EnableOnlineFeeds.
CUSTOM_NUGET_FEEDS	name,url;name2,url2	Añade o actualiza fuentes de actividad personalizadas. Las fuentes pueden ser URL, rutas de carpetas o recursos compartidos de red.
ENFORCE_SIGNED_EXECUTION	True, False	Restringe el robot a la descarga, instalación y ejecución de paquetes firmados por UiPath. Se pueden confiar certificados adicionales añadiéndolos a nuget.config después de la instalación.
PACKAGES_FOLDER	Ruta de la carpeta	Ubicación de descarga para flujos de trabajo y sus dependencias. Predeterminado: %userProfile%\.nuget\packages.
INSTALL_WEBVIEW	True, False	Instala el tiempo de ejecución de Microsoft Edge WebView2, descargado de Microsoft durante la instalación (se requiere acceso a Internet). Si la descarga falla, el runtime se omite y la instalación continúa.

Assistant

Parámetro	Valores	Descripción
ASSISTANT_OPTIONS	DisableMarketplace, EnableMarketplace	Oculta o muestra el widget de Marketplace. Si se omite, se mantiene la configuración actual en la máquina.

Extensiones del navegador

Parámetro	Valores	Descripción
CHROME_INSTALL_TYPE, EDGE_INSTALL_TYPE	PolicyOnline, PolicyOffline, ManualPerMachine, ManualPerUser, NativeHostOnly, None	Cómo se implementa la extensión de Chrome o Edge. Los valores no distinguen entre mayúsculas y minúsculas.
INSTALL_CHROME_EXTENSION, INSTALL_EDGE_EXTENSION, INSTALL_FIREFOX_EXTENSION	True, False	Instala la extensión para ese navegador.
INSTALL_JAVA_EXTENSION, INSTALL_SILVERLIGHT_EXTENSION	True, False	Instala la extensión de Java o Silverlight.
INSTALL_CITRIX_CLIENT_EXTENSION, INSTALL_RDP_CLIENT_EXTENSION, INSTALL_VMWARE_CLIENT_EXTENSION, INSTALL_AWS_WORKSPACES_CLIENT_EXTENSION	True, False	Instala la extensión para ese cliente de escritorio remoto.

Los valores de tipo de instalación heredada GLOBAL (equivalente a ManualPerMachine) y STORE (equivalente a PolicyOnline) aún se aceptan. Cualquier otro valor se trata como None.

Cuando se omite un parámetro INSTALL_*_EXTENSION , la extensión mantiene su estado actual: en una instalación limpia no está instalada, y al cambiar o actualizar una instalación, una extensión instalada permanece instalada.

Tiempos de ejecución

Runtimes no tiene parámetros. Usa "Parameters": {}.

ADVERTENCIA:

El archivo de configuración se lee como texto sin formato. Si contiene secretos como ORCHESTRATOR_CLIENT_SECRET o LICENSE_KEY, restringe el acceso al archivo y elimínalo, junto con la copia que el instalador escribe en %TEMP%\UiPathConnected\, una vez finalizada la instalación.

updaterConfig.json (UPDATER_CONFIGURATION_FILE)

Configura el actualizador. Aquí es donde se proporciona la configuración de proxy. En una instalación por máquina, el proxy se conserva para su uso en todo el sistema.

Configuración mínima del proxy:

{
  "Proxy": {
    "ProxyAddress": "http://proxy.corp:8080",
    "BypassLocalAddresses": true
  }
}

Proxy con autenticación y una lista de derivación:

{
  "Proxy": {
    "ProxyAddress": "http://proxy.corp:8080",
    "BypassList": "localhost;*.corp.local",
    "BypassLocalAddresses": true,
    "UserName": "proxyuser",
    "Password": "proxypassword",
    "Domain": "CORP"
  }
}

Como alternativa, puedes utilizar un script de configuración automática del proxy (PAC) en lugar de una dirección fija:

{
  "Proxy": {
    "ScriptAddress": "http://proxy.corp/proxy.pac"
  }
}

Nota:

ProxyAddress y ScriptAddress son mutuamente excluyentes. Si se establece UserName, también debe establecerse Password.

Solución de problemas

Para investigar una instalación fallida, captura un registro de instalación detallado añadiendo /l*v "<log path>" al comando msiexec.

La instalación falla con el código de salida 1603 y se revierte

Si el registro detallado contiene Command executed with exit code: 80, la instalación de los propios clientes de escritorio ha fallado. El motivo está en el registro del instalador:

Ámbito de instalación	Registro del instalador
Por máquina	%SystemRoot%\SystemTemp\UiPath.Connected.Installer.CLI.<yyyy-MM-dd>.log (en versiones de Windows sin una carpeta SystemTemp , %SystemRoot%\Temp)
Por usuario	%TEMP%\UiPath.Connected.Installer.CLI.<yyyy-MM-dd>.log

Una causa común es un archivo de configuración que solicita un producto sin los productos que requiere. El registro del instalador contiene una línea como:

Missing required dependencies. The following products must also be installed: Runtimes (required by Robot)

Para solucionarlo:

1. Añade los productos enumerados al archivo de configuración "InstallRequested": true, como se muestra en Productos disponibles.
2. Vuelve a ejecutar la instalación.