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 pour UiPathPlatformSTS.msi, community pour UiPathPlatform.msi	Mettez à jour le canal suivi de la plate-forme. Transmettez CHANNEL=sts pour installer le canal Enterprise STS avec l'un ou l'autre programme d'installation.
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

Le programme d'installation est défini par défaut sur une installation par utilisateur. Il bascule vers une installation par machine lorsque l'un des éléments suivants est vrai:

• msiexec s'exécute élevé — à partir d'une invite de commande élevée (administrateur), ou en tant que SYSTEM à partir d'un outil de déploiement tel que Microsoft Intune ou Configuration Manager. Cela s'applique également aux installations silencieuses.
• Un administrateur exécute l'installation en mode interactif, où elle peut être élevée grâce au contrôle de compte d'utilisateur.

Une installation silencieuse démarrée à partir d'une invite non élevée est conservée par utilisateur, même pour un administrateur, car elle ne peut pas inviter à l'élévation.

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.
• Pour une installation silencieuse par machine, exécutez msiexec élevé ou déployez-le en tant que 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

Installation silencieuse par machine à partir d'un outil de déploiement tel qu'Intune ou Configuration Manager (s'exécute en tant que SYSTEM), avec un journal d'installation détaillé:

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.

Le fichier contient une liste Packages avec une entrée par produit:

Champ	Description
PackageName	Nom du produit, exactement comme indiqué dans Produits disponibles. Le nom est sensible à la casse. Une entrée dont le nom ne correspond pas à un produit est ignorée.
InstallRequested	true pour installer le produit. Les produits manquants dans le fichier ou définis sur false ne sont pas installés.
Parameters	Paramètres spécifiques au produit, sous la forme de paires clé/valeur de chaîne. Utilisez {} lorsqu'un produit ne nécessite aucun paramètre. Voir Paramètres du produit.

Produits disponibles

PackageName	Installations	Liste Amazon (obligatoire)	Compléments facultatifs
Studio	Studio, y compris les packages facultatifs Studio Legacy et Activities	Robot, Runtimes	Assistant, BrowserExtensions
Robot	Robot, y compris le package facultatif de flux en direct	Runtimes	BrowserExtensions
Assistant	Assistant	Robot (et donc Runtimes)	—
BrowserExtensions	Extensions de navigateur et de bureau à distance	—	—
Runtimes	Les runtimes dont dépendent les autres clients de bureau. Requis par Robot, et donc par Studio et Assistant.	—	—

Important :

Les produits requis ne sont pas ajoutés automatiquement. Si les produits requis d'un produit demandé ne sont pas également définis sur "InstallRequested": true, l'installation échoue et se termine avec le code de sortie 1603. Voir Résolution des problèmes.

Chaque configuration qui installe Studio, Robot ou Assistant doit également répertorier Runtimes avec "InstallRequested": true.

Les produits requis reflètent la version actuelle d’Enterprise STS et peuvent changer d’une version à l’autre.

Exemple: Robot avec Assistant

Installe Robot, Assistant et leurs runtimes, connecte le Robot à Orchestrator et déploie les extensions Chrome et Edge via la politique:

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

Exemple: Studio

Installe Studio avec le package Activities, ainsi que le Robot et les Runtimes requis, ainsi que l'Assistant et l'extension 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"
      }
    }
  ]
}

Paramètres du produit

Les noms de paramètres sont sensibles à la casse. Les paramètres booléens acceptent True ou False (dans n’importe quelle casse); les autres valeurs, telles que 1 ou 0, sont ignorées avec un avertissement et la valeur par défaut est utilisée. Les noms de paramètres non reconnus sont ignorés. Les paramètres booléens sont définis par défaut sur False sauf indication contraire.

La plupart des paramètres correspondent aux paramètres classiques de la ligne de commande MSI du même nom. Étant donné que les packages Studio et Robot ont été séparés, les paramètres de connexion Robot et Orchestrator appartiennent à Robot, et non Studio.

Studio

Paramètre	Values	Description
INSTALL_ACTIVITIES	True, False	Installe le package Activités.
INSTALL_STUDIO_LEGACY	True, False	Installe Studio Legacy.
INSTALL_EXCEL_ADDIN	True, False	Installe le complément Excel. Nécessite Microsoft Excel et les outils Visual Studio pour Office Runtime 10.0.50325 ou une version ultérieure.
INSTALL_SAP_SOLMAN	True, False	Installe l'intégration du gestionnaire de solution SAP. Nécessite le connecteur SAP pour Microsoft sur la machine et SAP_SOLMAN_HOST.
SAP_SOLMAN_HOST	Nom d'hôte ou adresse IP	Hôte du gestionnaire de solution SAP. Doit se résoudre sur la machine.

Robot

Paramètre	Values	Description
SERVICE_URL	URL absolue	URL Orchestrator à laquelle le Robot se connecte.
REGISTER_ROBOT_SERVICE	True, False	Enregistre le Robot en tant que service Windows (non assisté).
DISABLE_SECURE_XAML	True, False	Pour un robot enregistré en tant que service Windows, désactive la protection des fichiers XAML, ce qui permet aux utilisateurs de lire et modifier les fichiers de processus. False maintient la sécurité des fichiers XAML.
INSTALL_ROBOTJS	True, False	Installe le module complémentaire Robot JavaScript. Toujours installé pour les installations par utilisateur et Attended.
INSTALL_LIVE_STREAMING	True, False	Installe le package de diffusion en direct.
ORCHESTRATOR_AUTO_SIGNIN	True, False	Pour un Attended Robot installé par utilisateur dans un environnement qui utilise l’authentification unique avec Microsoft Entra ID, connecte automatiquement l’utilisateur. Nécessite SERVICE_URL; ne peut pas être combiné avec REGISTER_ROBOT_SERVICE=True ou les informations d'identification du client.
ENFORCE_DEFAULT_SERVICE_URL	True, False	Pour les installations par utilisateur, applique SERVICE_URL comme URL Orchestrator par défaut. Nécessite SERVICE_URL.
ORCHESTRATOR_CLIENT_ID, ORCHESTRATOR_CLIENT_SECRET	Chaînes	Informations d’identification du client pour un Unattended Robot. Définissez les deux, avec SERVICE_URL et REGISTER_ROBOT_SERVICE=True.
LICENSE_KEY	Chaîne de caractères (string)	Clé de licence du robot.
NUGET_OPTIONS	EnableOnlineFeeds, DisableOnlineFeeds	DisableOnlineFeeds désactive les flux en ligne officiels et communautaires UiPath pour le Robot, pour les environnements hors ligne. Par défaut: EnableOnlineFeeds.
CUSTOM_NUGET_FEEDS	name,url;name2,url2	Ajoute ou met à jour des flux d’activités personnalisés. Les flux peuvent être des URL, des chemins d'accès aux dossiers ou des partages réseau.
ENFORCE_SIGNED_EXECUTION	True, False	Limite le Robot au téléchargement, à l’installation et à l’exécution des packages signés par UiPath. Des certificats supplémentaires peuvent être approuvés en les ajoutant à nuget.config après l'installation.
PACKAGES_FOLDER	Chemin d'accès au dossier	Emplacement de téléchargement des workflows et de leurs dépendances. Par défaut: %userProfile%\.nuget\packages.
INSTALL_WEBVIEW	True, False	Installe le runtime Microsoft Edge WebView2, téléchargé à partir de Microsoft lors de l'installation (accès Internet requis). Si le téléchargement échoue, le runtime est ignoré et l’installation se poursuit.

Assistant

Paramètre	Values	Description
ASSISTANT_OPTIONS	DisableMarketplace, EnableMarketplace	Masquez ou affichez le widget Marketplace. Si ce champ est omis, le paramètre actuel sur la machine est conservé.

Extensions de navigateur

Paramètre	Values	Description
CHROME_INSTALL_TYPE, EDGE_INSTALL_TYPE	PolicyOnline, PolicyOffline, ManualPerMachine, ManualPerUser, NativeHostOnly, None	Comment l'extension Chrome ou Edge est déployée. Les valeurs ne sont pas sensibles à la casse.
INSTALL_CHROME_EXTENSION, INSTALL_EDGE_EXTENSION, INSTALL_FIREFOX_EXTENSION	True, False	Installe l'extension pour ce navigateur.
INSTALL_JAVA_EXTENSION, INSTALL_SILVERLIGHT_EXTENSION	True, False	Installe l'extension Java ou Silverlight.
INSTALL_CITRIX_CLIENT_EXTENSION, INSTALL_RDP_CLIENT_EXTENSION, INSTALL_VMWARE_CLIENT_EXTENSION, INSTALL_AWS_WORKSPACES_CLIENT_EXTENSION	True, False	Installe l'extension pour ce client de bureau à distance.

Les valeurs de type d’installation héritées GLOBAL (équivalent à ManualPerMachine) et STORE (équivalent à PolicyOnline) sont toujours acceptées. Toute autre valeur est traitée comme None.

Lorsqu'un paramètre INSTALL_*_EXTENSION est omis, l'extension conserve son état actuel: sur une nouvelle installation, elle n'est pas installée, et lors de la modification ou de la mise à niveau d'une installation, une extension installée reste installée.

Runtimes

Runtimes ne prend aucun paramètre. Utilisez "Parameters": {}.

Avertissement :

Le fichier de configuration est lu en tant que Text brut. S'il contient des secrets tels que ORCHESTRATOR_CLIENT_SECRET ou LICENSE_KEY, restreignez l'accès au fichier et supprimez-le, avec la copie que le programme d'installation écrit sous %TEMP%\UiPathConnected\, une fois l'installation terminée.

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

Pour enquêter sur une installation ayant échoué, capturez un journal d'installation détaillé en ajoutant /l*v "<log path>" à la commande msiexec.

L'installation échoue avec le code de sortie 1603 et revient en arrière

Si le journal détaillé contient Command executed with exit code: 80, l'installation des clients de bureau a échoué. La raison se trouve dans le journal du programme d'installation:

Étendue de l'installation	Journal du programme d'installation
Par machine	%SystemRoot%\SystemTemp\UiPath.Connected.Installer.CLI.<yyyy-MM-dd>.log (sur les versions Windows sans dossier SystemTemp , %SystemRoot%\Temp)
Par utilisateur	%TEMP%\UiPath.Connected.Installer.CLI.<yyyy-MM-dd>.log

Une cause fréquente est un fichier de configuration qui demande un produit sans les produits dont il a besoin. Le journal du programme d'installation contient alors une ligne telle que:

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

Pour résoudre ce problème:

1. Ajoutez les produits répertoriés au fichier de configuration avec "InstallRequested": true, comme indiqué dans la section Produits disponibles.
2. Exécutez à nouveau l'installation.