Installer à partir de la ligne de commande

Installez les clients de bureau UiPath à partir de la ligne de commande en mode interactif ou silencieux, à l'aide des paramètres UiPathPlatform.msi et des fichiers de configuration pris en charge.

Vous pouvez installer les clients de bureau UiPath avec le programme d'installation UiPath Platform (UiPathPlatform.msi) à partir de la ligne de commande, en mode entièrement interactif ou entièrement silencieux, à l'aide des paramètres MSI pris en charge. Le mode silencieux est destiné aux déploiements non assistés. Pour l'installation interactive, consultez Installer les clients de bureau.

Syntaxe

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

Les paramètres sont transmis sous forme de paires PARAMETER=value après le chemin du package. Enfermez les valeurs qui contiennent des espaces entre guillemets doubles.

Modes d'installation

Mode	Commutateur (Switch)	Description
Interactivité complète	(omettre)	Exécute l'assistant d'installation avec l'interface utilisateur complète. L'utilisateur voit la progression et toutes les invites.
Entièrement silencieux	/qn	S'exécute sans interface utilisateur et sans boîte de dialogue. Requis pour les déploiements non assistés.

Remarque :

Utilisez /qn pour les installations non assistées. Les modes d'IU partielle (/qb, /qr) ne sont pas pris en charge pour les scénarios non assistés, car le programme d'installation peut toujours afficher les boîtes de dialogue de blocage.

Paramètres pris en charge

Paramètre	Values	Default	Description
FORCE_PERUSER	1	—	Force une installation par utilisateur même lorsque l'utilisateur actuel est un administrateur.
CHANNEL	sts	sts for UiPathPlatformSTS.msi, community for UiPathPlatform.msi	Update channel the platform follows. Pass CHANNEL=sts to install the Enterprise STS channel with either installer.
PLATFORM_CONFIGURATION_FILE	Chemin d'accès absolu du fichier	—	Chemin d'accès à un fichier de configuration des produits appliqué pendant l'installation.
UPDATER_CONFIGURATION_FILE	Chemin d'accès absolu du fichier	—	Chemin d'accès à un fichier de configuration spécifique au programme de mise à jour appliqué pendant l'installation.
TELEMETRY_ENABLED	1 = activé, 0 = désactivé	enabled	Contrôle si les données de télémétrie sont envoyées.
INSTALLER_LANGUAGE	de, en, es, es-MX, fr, ja, ko, pt-BR, pt, ro, ru, tr, zh-CN, zh-TW	Langue du système	Langue de l'interface utilisateur de l'assistant d'installation. Aucun effet en mode silencieux.

Étendue de l'installation

The installer defaults to a per-user installation. It switches to a per-machine installation when either of the following is true:

• msiexec runs elevated — from an elevated (administrator) command prompt, or as SYSTEM from a deployment tool such as Microsoft Intune or Configuration Manager. This applies to silent installations too.
• An administrator runs the installation in interactive mode, where it can elevate through User Account Control.

A silent installation started from a non-elevated prompt stays per-user, even for an administrator, because it cannot prompt for elevation.

Remarque :

UiPath recommande une installation par machine, qui maintient les clients de bureau disponibles pour tous les utilisateurs et gérés de manière centralisée.

• Pour forcer par utilisateur même pour un administrateur, transmettez FORCE_PERUSER=1.
• For a per-machine silent installation, run msiexec elevated, or deploy it as SYSTEM.

Exemples

Installation interactive

Canal par défaut, assistant complet :

msiexec /i UiPathPlatform.msi

Canal spécifique et fichier de configuration :

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

Forcer par utilisateur pour un admnistrateur :

msiexec /i UiPathPlatform.msi FORCE_PERUSER=1

Installation silencieuse

Par utilisateur, canal par défaut :

msiexec /i UiPathPlatform.msi /qn

Installation silencieuse avec un canal spécifique, un fichier de configuration et la télémétrie désactivés :

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

Per-machine silent install from a deployment tool such as Intune or Configuration Manager (runs as SYSTEM), with a verbose installation log:

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

Installation propre derrière un proxy d'entreprise (proxy fourni via le fichier de configuration du programme de mise à jour) :

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

Fichiers de configuration

platformConfig.json (PLATFORM_CONFIGURATION_FILE)

Sélectionne les clients de bureau à installer et les paramètres spécifiques au produit.

The file contains a Packages list with one entry per product:

Champ	Description
PackageName	Product name, exactly as listed in Available products. The name is case-sensitive. An entry whose name does not match a product is ignored.
InstallRequested	true to install the product. Products that are missing from the file, or set to false, are not installed.
Parameters	Product-specific settings, as string key/value pairs. Use {} when a product needs no settings. See Product parameters.

Available products

PackageName	Installs	Also list (required)	Optional companions
Studio	Studio, including the optional Studio Legacy and Activities packages	Robot, Runtimes	Assistant, BrowserExtensions
Robot	Robot, including the optional Live Streaming package	Runtimes	BrowserExtensions
Assistant	Assistant	Robot (and therefore Runtimes)	—
BrowserExtensions	Browser and remote-desktop extensions	—	—
Runtimes	The runtimes the other desktop clients depend on. Required by Robot, and therefore by Studio and Assistant.	—	—

Important :

Required products are not added automatically. If a requested product's required products are not also set to "InstallRequested": true, the installation fails and rolls back with exit code 1603. See Troubleshooting.

Every configuration that installs Studio, Robot, or Assistant must also list Runtimes with "InstallRequested": true.

The required products reflect the current Enterprise STS release and may change between releases.

Example: Robot with Assistant

Installs Robot, Assistant, and their runtimes, connects the Robot to Orchestrator, and deploys the Chrome and Edge extensions through policy:

{
  "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"
      }
    }
  ]
}

Example: Studio

Installs Studio with the Activities package, together with its required Robot and Runtimes, plus Assistant and the Edge extension:

{
  "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"
      }
    }
  ]
}

Product parameters

Parameter names are case-sensitive. Boolean parameters accept True or False (in any letter case); other values, such as 1 or 0, are ignored with a warning and the default is used. Unrecognized parameter names are ignored. Boolean parameters default to False unless noted otherwise.

Most parameters match the classic MSI command-line parameters of the same name. Since the Studio and Robot packages were separated, Robot and Orchestrator connection settings belong to Robot, not Studio.

Studio

Paramètre	Values	Description
INSTALL_ACTIVITIES	True, False	Installs the Activities package.
INSTALL_STUDIO_LEGACY	True, False	Installs Studio Legacy.
INSTALL_EXCEL_ADDIN	True, False	Installs the Excel add-in. Requires Microsoft Excel and the Visual Studio Tools for Office Runtime 10.0.50325 or later.
INSTALL_SAP_SOLMAN	True, False	Installs the SAP Solution Manager integration. Requires the SAP Connector for Microsoft on the machine, and SAP_SOLMAN_HOST.
SAP_SOLMAN_HOST	Host name or IP address	SAP Solution Manager host. Must resolve on the machine.

Robot

Paramètre	Values	Description
SERVICE_URL	Absolute URL	Orchestrator URL the Robot connects to.
REGISTER_ROBOT_SERVICE	True, False	Registers the Robot as a Windows service (unattended).
DISABLE_SECURE_XAML	True, False	For a Robot registered as a Windows service, disables the protection of XAML files, which lets users read and modify the process files. False keeps XAML files secured.
INSTALL_ROBOTJS	True, False	Installs the Robot JavaScript add-on. Always installed for per-user and attended installations.
INSTALL_LIVE_STREAMING	True, False	Installs the Live Streaming package.
ORCHESTRATOR_AUTO_SIGNIN	True, False	For an attended Robot installed per-user in an environment that uses single sign-on with Microsoft Entra ID, signs the user in automatically. Requires SERVICE_URL; cannot be combined with REGISTER_ROBOT_SERVICE=True or client credentials.
ENFORCE_DEFAULT_SERVICE_URL	True, False	For per-user installations, enforces SERVICE_URL as the default Orchestrator URL. Requires SERVICE_URL.
ORCHESTRATOR_CLIENT_ID, ORCHESTRATOR_CLIENT_SECRET	Strings	Client credentials for an unattended Robot. Set both, together with SERVICE_URL and REGISTER_ROBOT_SERVICE=True.
LICENSE_KEY	Chaîne de caractères (string)	Robot license key.
NUGET_OPTIONS	EnableOnlineFeeds, DisableOnlineFeeds	DisableOnlineFeeds turns off the UiPath Official and Community online feeds for the Robot, for offline environments. Default: EnableOnlineFeeds.
CUSTOM_NUGET_FEEDS	name,url;name2,url2	Adds or updates custom activity feeds. Feeds can be URLs, folder paths, or network shares.
ENFORCE_SIGNED_EXECUTION	True, False	Restricts the Robot to downloading, installing, and running packages signed by UiPath. Additional certificates can be trusted by adding them to nuget.config after the installation.
PACKAGES_FOLDER	Chemin d'accès au dossier	Download location for workflows and their dependencies. Default: %userProfile%\.nuget\packages.
INSTALL_WEBVIEW	True, False	Installs the Microsoft Edge WebView2 runtime, downloaded from Microsoft during the installation (internet access required). If the download fails, the runtime is skipped and the installation continues.

Assistant

Paramètre	Values	Description
ASSISTANT_OPTIONS	DisableMarketplace, EnableMarketplace	Hides or shows the Marketplace widget. If omitted, the current setting on the machine is kept.

BrowserExtensions

Paramètre	Values	Description
CHROME_INSTALL_TYPE, EDGE_INSTALL_TYPE	PolicyOnline, PolicyOffline, ManualPerMachine, ManualPerUser, NativeHostOnly, None	How the Chrome or Edge extension is deployed. Values are not case-sensitive.
INSTALL_CHROME_EXTENSION, INSTALL_EDGE_EXTENSION, INSTALL_FIREFOX_EXTENSION	True, False	Installs the extension for that browser.
INSTALL_JAVA_EXTENSION, INSTALL_SILVERLIGHT_EXTENSION	True, False	Installs the Java or Silverlight extension.
INSTALL_CITRIX_CLIENT_EXTENSION, INSTALL_RDP_CLIENT_EXTENSION, INSTALL_VMWARE_CLIENT_EXTENSION, INSTALL_AWS_WORKSPACES_CLIENT_EXTENSION	True, False	Installs the extension for that remote-desktop client.

The legacy install type values GLOBAL (equivalent to ManualPerMachine) and STORE (equivalent to PolicyOnline) are still accepted. Any other value is treated as None.

When an INSTALL_*_EXTENSION parameter is omitted, the extension keeps its current state: on a clean installation it is not installed, and when changing or upgrading an installation, an installed extension stays installed.

Runtimes

Runtimes takes no parameters. Use "Parameters": {}.

Avertissement :

The configuration file is read as plain text. If it contains secrets such as ORCHESTRATOR_CLIENT_SECRET or LICENSE_KEY, restrict access to the file, and delete it, along with the copy the installer writes under %TEMP%\UiPathConnected\, after the installation completes.

updaterConfig.json (UPDATER_CONFIGURATION_FILE)

Configure le programme de mise à jour. C'est ici que les paramètres du proxy sont fournis. Sur une installation par machine, le proxy est conservé pour une utilisation à l'échelle du système.

Configuration minimale du proxy :

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

Proxy avec l'authentification et une liste de contournement :

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

Vous pouvez également utiliser un script d'auto-configuration du proxy (PAC) au lieu d'une adresse fixe :

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

Remarque :

ProxyAddress et ScriptAddress s'excluent mutuellement. Si UserName est défini, Password doit également être défini.

Résolution des problèmes

To investigate a failed installation, capture a verbose installation log by adding /l*v "<log path>" to the msiexec command.

The installation fails with exit code 1603 and rolls back

If the verbose log contains Command executed with exit code: 80, the installation of the desktop clients themselves failed. The reason is in the installer log:

Étendue de l'installation	Installer log
Per-machine	%SystemRoot%\SystemTemp\UiPath.Connected.Installer.CLI.<yyyy-MM-dd>.log (on Windows versions without a SystemTemp folder, %SystemRoot%\Temp)
Per-user	%TEMP%\UiPath.Connected.Installer.CLI.<yyyy-MM-dd>.log

A common cause is a configuration file that requests a product without the products it requires. The installer log then contains a line such as:

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

Pour résoudre ce problème:

1. Add the listed products to the configuration file with "InstallRequested": true, as shown in Available products.
2. Run the installation again.