Paramètres de la ligne de commande UiPathRobot.msi

Vous pouvez installer le Robot en exécutant le programme d'installation UiPathRobot.msi à partir de la ligne de commande.

Consultez les sections suivantes pour obtenir des descriptions des paramètres disponibles et quelques exemples d’utilisation.

Remarque :

• Vous devez disposer de droits d'administrateur pour exécuter ces commandes.
• L'utilisation de l'option /passive de msiexec.exe pour exécuter une installation Unattended n'est pas prise en charge.

Descriptions des arguments de ligne de commande

Le tableau suivant répertorie tous les paramètres de ligne de commande disponibles.

Lors de la saisie des chemins d'accès, tenez compte des points suivants :

• Il est possible d'utiliser des variables d'environnement, telles que %USERNAME% ou %USERPROFILE%. Vous devez échapper le caractère spécial %, comme suit :
  • Lorsque la configuration est invoquée depuis l'invite de commande, utilisez ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Dans les scripts de commandes, utilisez ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Dans la console ou les scripts PowerShell : aucun échappement n'est nécessaire.
  • Si votre utilisateur est un compte de domaine Active Directory, il est recommandé de spécifier également le nom de domaine dans la structure de dossiers, tel que C:\packages\^%UserDomain^%.^%Username^%
• Si vous devez utiliser des chemins contenant des espaces, ils doivent être encapsulés comme suit :
  • Dans l'invite de commande, entourez de guillemets doubles (" "). Par exemple, UiPathRobot.msi APPLICATIONFOLDER="C:\folder name".
  • Dans PowerShell, entourez de guillemets simples et doubles ('" "'). Par exemple, ./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'.

Commande	Description
/q	Permet d’installer les fonctionnalités spécifiées d’UiPath® en mode silencieux, sans afficher l’interface utilisateur.
/l*vx <LogFile>	Génère un fichier journal d'installation au chemin d'accès spécifié. À partir de la version v2018.4.2, ce fichier peut également inclure des informations de licence si vous utilisez sous licence Studio ou Robot au moment de l'installation. Vous pouvez envoyer le fichier ensuite à notre équipe d'assistance si, pour une raison quelconque, vous rencontrez des difficultés lors du processus d'installation.
ADDLOCAL	Permet de sélectionner les fonctionnalités à installer. Si ADDLOCAL est utilisé, seules les fonctionnalités qui y sont spécifiées sont installées. Si ADDLOCAL n'est pas utilisé, les fonctionnalités suivantes sont installées : le Robot en mode service, les packages d'activités et le module complémentaire JavaScript. Prend en charge les options suivantes : DesktopFeature : indique que vous désirez installer la fonctionnalité Robot. Robot - Installe le Robot en mode utilisateur ou en mode service, ainsi que l'Assistant. Vous ne pouvez pas l'utiliser sans DesktopFeature. Pour installer le Robot en mode service, ajoutez également l'option RegisterService. C'est le choix recommandé pour les Unattended Robots. Pour installer le Robot en mode utilisateur, n’ajoutez pas l’option RegisterService. C’est le choix recommandé pour les Robots Attended et de développement. Remarque : si vous convertissez le Robot du mode service au mode utilisateur, il se peut que le Robot ne puisse pas accéder aux fichiers .xaml du dossier des packages NuGet original. Pour plus de détails sur la façon de résoudre ce problème, consultez l'article de dépannage Packages NuGet non accessibles après la migration (NuGet packages not accessible after migration). StartupLauncher : exécute le Robot au démarrage de Windows. Il ne peut pas être utilisé sans l'argument Robot. JavaBridge - Installe le UiPath® Java Bridge pour une meilleure intégration et automatisation des applications Java. Veuillez noter que l’installation de Java Bridge peut entraîner une installation plus longue que d’habitude. Ne peut être utilisé sans l’argument Robot. ChromeExtension : installe l’extension Google Chrome UiPath®. Ne peut être utilisé sans l’argument Robot. FirefoxExtension - par exemple  : UiPathRobot.msi ADDLOCAL=Robot,ChromeExtension,FirefoxExtension /Q EdgeExtension – installe l'extension UiPath basée sur Microsoft Edge Chromium. Elle ne peut pas être utilisée sans l'argument Robot. CitrixClient : installe l’extension client UiPath® Citrix. Ne peut être utilisé sans l’argument Robot. JavaScriptAddOn - Installe l'extension Browser Embedding pour robot. VMwareExtension : installe l’extension UiPath® pour VMware Horizon. Ne peut être utilisé sans l’argument Robot. WindowsRdpExtension : installe l’extension UiPath® pour le bureau à distance Microsoft. Ne peut être utilisé sans l’argument Robot.
MSIINSTALLPERUSER	Vous permet d'effectuer l'installation uniquement pour l'utilisateur actuel. Pour installer par utilisateur, ajoutez MSIINSTALLPERUSER=1. Pour installer par machine, n'incluez pas ce paramètre. Les options suivantes ne sont pas disponibles dans les installations par utilisateur : RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
APPLICATIONFOLDER	Cette commande vous permet d'installer le Robot dans un emplacement personnalisé.
NUGET_OPTIONS	Ce paramètre est recommandé si vous travaillez dans un environnement hors ligne. S’il est défini sur DisableOnlineFeeds, ce paramètre permet de désactiver les flux communautaires et UiPath® officiels en ligne pour le Robot. Seuls les flux Orchestrator et locaux sont pris en compte. Notez que les flux d'URL ne sont pas supprimés des fichiers de configuration; uniquement ignorés. Vous pouvez utiliser ce paramètre pour les installations et pour les mises à niveau.
PACKAGES_FOLDER	Vous permet de modifier l'emplacement de téléchargement de vos workflows et leurs dépendances pour Studio et/ou Robot. Ce dossier peut être spécifique à l'utilisateur ou accessible par tous les utilisateurs à partir d'une machine. Ce paramètre peut être utilisé à la fois pour les robots en mode service ou en mode utilisateur. Si vous n'indiquez pas ce paramètre, le dossier par défaut est %userProfile%\.nuget\packages. Remarque : lorsque vous modifiez le dossier des packages, assurez-vous que tous les utilisateurs qui doivent exécuter des processus ont un accès en lecture à ce dossier. Remarque : lors de l'utilisation du paramètre PACKAGES_FOLDER, il existe certaines limitations. Pour en savoir plus, consultez la documentation sur les dossiers de packages personnalisés et les chemins d'accès réseau. Pour les installations sur des machines Windows Server (qui permettent des exécutions simultanées - Robots HD), vous devez fournir des chemins d'accès spécifiques à chaque utilisateur. En savoir plus sur l'utilisation du même chemin d'accès pour plusieurs robots. Pour plus d’informations sur la façon de modifier le dossier de téléchargement pour les packages après l’installation, consultez Gérer les packages d’activités.
CUSTOM_NUGET_FEEDS	Permet d'ajouter des activités NuGet personnalisées pour Studio et/ou pour Robot. Cette commande ajoute ou met à jour uniquement la liste existante de flux. Il doit être renseigné avec des paires clé-valeur de type chaîne. Les emplacements valides incluent les flux en ligne, les chemins de dossiers et les lecteurs réseau partagés. Assurez-vous que les flux fournis sont accessibles à tous les utilisateurs d'une machine donnée. Séparez les flux par des points-virgules (;). Exemple :CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\".
ENFORCE_SIGNED_EXECUTION	Facultatif. Permet de demander à vos Robots de n'exécuter que des paquets signés. Vous pouvez utiliser ce paramètre pour les nouvelles installations et les mises à jour de vos instances. Si ce paramètre n'est pas spécifié au moment du déploiement, la signature des paquets n'est pas activée. Prend en charge les options suivantes : 1 : le Robot est capable de télécharger, d’installer ou d’exécuter uniquement l’auteur ou le référentiel de packages signé par UiPath® . Si vous souhaitez ajouter votre propre certificat en tant que source de confiance, vous devez le faire en modifiant le fichier nuget.config. Pour savoir comment procéder, veuillez consulter cette page. 0 : aucune règle de signature de paquets n'est appliquée sur votre déploiement de Robot. Pour plus d’informations sur la façon d’appliquer l’exécution signée après l’installation, voir Signer les packages.
CODE	Permet d'activer la licence de votre instance de Robot.
CLIENT_ID et CLIENT_SECRET	Connecte automatiquement le Robot à Orchestrator utilisant les informations d’identification du client tout en l'installant. Exemple : UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
CHROME_INSTALL_TYPE	Permet de choisir la méthode d'installation de l'extension Chrome. Ce paramètre nécessite que le programme d'installation s'exécute avec des droits d'administrateur. S'il est omis, la méthode d'installation la plus appropriée est sélectionnée automatiquement. Prend en charge les options suivantes : POLICYOFFLINE : l'extension Chrome est automatiquement installée par système via la méthode de stratégie de groupe hors ligne (Group Policy Offline), ce qui revient à appeler la commande /Chrome-Policy-Offline à l'aide de l'outil ConfigurationExtensions (SetupExtensions). POLICYONLINE : l'extension Chrome est automatiquement installée par système via la méthode de stratégie de groupe en ligne (Group Policy Online), ce qui revient à appeler la commande /ChromePolicyGlobal à l'aide de l'outil ConfigurationExtensions (SetupExtensions). MANUALPERMACHINE : l'extension Chrome est installée pour tous les utilisateurs, l'équivalent d'appeler la commande /ChromeGlobal à l'aide de l'outil ConfigurationExtensions(SetupExtenstions). NATIVEHOSTONLY : seul le composant Hôte de messagerie natif (ChromeNativeMessaging.exe) est installé, l'équivalent d'appeler la commande /ChromeNativeHostGlobal à l'aide de l'outil ConfigurationExtensions(SetupExtenstions). Remarque : les anciens noms des méthodes d'installation (STORE, GLOBAL) sont conservés à des fins de rétrocompatibilité.
EDGE_INSTALL_TYPE	Permet de choisir la méthode d'installation de l'extension Edge. Ce paramètre nécessite que le programme d'installation s'exécute avec des droits d'administrateur. S'il est omis, la méthode d'installation la plus appropriée est sélectionnée automatiquement. Prend en charge les options suivantes : POLICYOFFLINE : l'extension Edge est automatiquement installée par système via la méthode de Stratégie de groupe hors ligne (Group Policy Offline), ce qui revient à appeler la commande /Edge-Policy-Offline à l'aide de l'outil ConfigurationExtensions (SetupExtensions). POLICYONLINE : l'extension Edge est automatiquement installée par système via la méthode de stratégie de groupe en ligne (Group Policy Online), ce qui revient à appeler la commande /Edge-Chromium-PolicyGlobal à l'aide de l'outil ConfigurationExtensions (SetupExtensions). MANUALPERMACHINE : l'extension Chrome est installée pour tous les utilisateurs, l'équivalent d'appeler la commande /Edge-Chromium-Global à l'aide de l'outil ConfigurationExtensions(SetupExtenstions). NATIVEHOSTONLY : seul le composant Hôte de messagerie natif (ChromeNativeMessaging.exe) est installé, l'équivalent d'appeler la commande /Edge-Chromium-NativeHostGlobal à l'aide de l'outil ConfigurationExtensions(SetupExtenstions). Remarque : les anciens noms des méthodes d'installation (STORE, GLOBAL) sont conservés à des fins de rétrocompatibilité.
DISABLE_SECURE_XAML	Permet de désactiver la sécurité des fichiers XAML pour les Robots installés en tant que service Windows. Les fichiers XAML non sécurisés permettent de lire et de modifier les fichiers et la logique de processus. Prend en charge les options suivantes : 0 : Option par défaut. Lorsqu'elle est utilisée, elle active la sécurité des fichiers XAML pour les Robots du service Windows. 1 : Désactive la sécurité des fichiers XAML des Robots du service Windows. Remarque : vous ne pouvez utiliser ce paramètre que lors d'une nouvelle installation ou d'une mise à jour.
SERVICE_URL	Permet de définir l'URL de l'instance Orchestrator à laquelle les utilisateurs se connecteront en utilisant la connexion interactive. L’URL fournie est enregistrée dans le fichier uipath.config, et elle n’est enregistrée que pour les Robots en mode utilisateur. Pour les installations en mode service, l’argument est ignoré. Lorsque vous exécutez l’installateur pour mettre à jour depuis une ancienne version ou modifier votre installation existante, ce paramètre est pris en charge si vous faites basculer le Robot du mode de service au mode utilisateur (l’option RegisterService n’est pas incluse).
ORCHESTRATOR_URL	Dans une nouvelle installation, vous pouvez spécifier l'URL principale d'Orchestrator, utilisée pour récupérer les informations de mise à jour automatique (par exemple https://orchestrator.local/organizationName/tenantName).
TELEMETRY_ENABLED	Permet de désactiver la collecte des données d'utilisation et peut être effectuée au moment de l'installation pour le Robot. La télémétrie est activée par défaut pour Studio et Robot. Pour la désactiver, utilisez la valeur suivante pour le paramètre chaque fois que vous effectuez une nouvelle installation ou une mise à jour : TELEMETRY_ENABLED=0 Si vous souhaitez activer la télémétrie, n'incluez pas le paramètre ou incluez-le avec la valeur suivante : TELEMETRY_ENABLED=1 Pour plus d’informations sur la collecte de données d’utilisation et la façon de modifier les paramètres de télémétrie, consultez le document Refus de la télémétrie.
ENABLE_PIP	Permet d’activer la fonctionnalité Incrustation d’image de la machine lors de l’installation de la ligne de commande UiPath®. Pour l’activer, utilisez le paramètre suivant : ENABLE_PIP=1 Exemple : UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	Permet de sélectionner la langue d'affichage du programme d'installation. S'ils ne sont pas spécifiés, les paramètres de langue de Windows déterminent la langue du programme d'installation. Pour spécifier la langue, saisissez le paramètre INSTALLER_LANGUAGE=<language_code>. Les options suivantes sont disponibles : Chinois (simplifié) : INSTALLER_LANGUAGE=2052 Français : INSTALLER_LANGUAGE=12 Allemand : INSTALLER_LANGUAGE=7 Japonais : INSTALLER_LANGUAGE=17 Coréen : INSTALLER_LANGUAGE=1 Portugais (Portugal) : INSTALLER_LANGUAGE=22 Portugais (Brésil) : INSTALLER_LANGUAGE=1046 Russe : INSTALLER_LANGUAGE=25 Espagnol (Espagne) : INSTALLER_LANGUAGE=10 Espagnol (Mexique) : INSTALLER_LANGUAGE=2058 Turc : INSTALLER_LANGUAGE=31
ASSISTANT_OPTIONS	Vous permet de spécifier s'il faut activer ou désactiver le widget de Marketplace pour UiPath Assistant. Pour activer le widget, utilisez ASSISTANT_OPTIONS=EnableMarketplace ou n'incluez pas le paramètre. Pour désactiver le widget, utilisez ASSISTANT_OPTIONS=DisableMarketplace.
ORCHESTRATOR_AUTO_SIGNIN	Si vous installez l'Attended Robot en mode utilisateur et que votre environnement est configuré pour utiliser l'authentification unique avec Azure Active Directory, cela active la connexion automatique à votre compte. Ce paramètre doit être utilisé avec ORCHESTRATOR_URL. Pour activer cette option, utilisez ORCHESTRATOR_AUTO_SIGNIN=1

Exécution d'une installation synchrone

Si vous souhaitez effectuer des configurations supplémentaires une fois l'installation terminée, vous pouvez exécuter le programme d'installation de manière synchrone. Cela vous permet d'ajouter d'autres commandes à exécuter une fois le programme d'installation terminé. Par exemple, vous pouvez installer et également configurer une connexion robot ou configurer des flux.

Les scripts suivants effectuent l'installation et vous permettent d'ajouter d'autres commandes à exécuter si l'installation réussit.

:: Runnning the MSI synchronously
start /wait /b UiPathRobot.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"
)

Exemples

Ces exemples supposent que vous soyez déjà dans le répertoire dans lequel le programme d'installation UiPathRobot.msi se trouve. Vous pouvez procéder à l'aide de la commande suivante, par exemple : cd D:\UiPathInstaller.

• Installez le Robot en mode utilisateur uniquement pour l'utilisateur actuel : UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Robot
• Installez le Robot en mode silencieux : UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Installez en mode silencieux le Robot et l'extension Chrome via une stratégie : UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q

• Installez le Robot en tant que service Windows en mode silencieux et connectez-le à Orchestrator :

  UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q

• Installez le Robot en tant que service Windows en mode silencieux et ajouter deux flux d'activités personnalisés : UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• Installez et activez la licence en mode silencieux pour un Robot en tant que service Windows et un flux local d'activité : UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,CODE=1234567890 /Q
• Installe Robot en tant que service Windows et désactive les flux en ligne officiels : UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Désinstaller l'extension Chrome : UiPathRobot.msi REMOVE=ChromeExtension /Q

• Configurer la connexion de mise à jour automatique lors de l'installation du Robot assisté (Attended Robot) -

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

• Configurer la connexion de mise à jour automatique lors de l'installation du Unattended Robot -

  UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"