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

La liste suivante affiche tous les paramètres de ligne de commande disponibles.

• /q - Installe silencieusement les fonctionnalités UiPath spécifiées sans afficher l'interface utilisateur.
• /l*vx <LogFile> - Génère un fichier journal du programme d'installation au chemin spécifié.Vous pouvez envoyer le fichier à notre équipe de support si, pour une raison quelconque, vous rencontrez des difficultés pendant le processus d'installation.
• ADDLOCAL - Permet de sélectionner les fonctionnalités à installer.Sans ce paramètre, les fonctionnalités suivantes sont installées par défaut : Robot en mode service, packages d'activités par défaut et module complémentaire JavaScript.

  Prend en charge les options suivantes :

  • DesktopFeature— Indique que vous souhaitez installer la fonctionnalité Robot.
  • Studio (exclusivement pour UiPathStudio.msi) — Installe Studio.Doit être utilisé conjointement au paramètre DesktopFeature.
  • ExcelAddin (exclusivement pour UiPathStudio.msi) — Installe le complément StudioX Excel. Doit être utilisé conjointement au paramètre Studio.
  • Robot — Installe le robot en mode utilisateur ou en mode service ainsi que l'Assistant.Doit être utilisé conjointement avec le DesktopFeatureparamètre.
  • RegisterService — Requis pour les installations en mode Service. Ne l'ajoutez pas pour les installations en mode utilisateur.
  • StartupLauncher — Exécute le robot au démarrage de Windows. Doit être utilisé conjointement au paramètre DesktopFeature.
  • Packages (exclusivement pour UiPathStudio.msi) — Installe les packages d'activité par défaut. Doit être utilisé conjointement au paramètre Robot.
  • JavaBridge — Installe UiPath Java Bridge pour une meilleure intégration et une meilleure automatisation avec les applications Java.L'ajout de cela peut augmenter le temps d'installation. Doit être utilisé conjointement au paramètre Robot.
  • ChromeExtension — Installe l'extension Google Chrome.Doit être utilisé conjointement au paramètre Robot.
  • FirefoxExtension — Installe l'extension Firefox.Doit être utilisé conjointement au paramètre Robot.
  • EdgeExtension — Installe l'extension Microsoft Edge basée sur Chromium. Doit être utilisé conjointement au paramètre Robot.
  • CitrixClient — Installe l'extension Citrix UiPath Client. Doit être utilisé conjointement avec le paramètreRobot. Non disponible pour les installations par utilisateur.
  • JavaScriptAddOn — Installe le module complémentaire Intégration de navigateur. Doit être utilisé conjointement avec le paramètreRobot. Ne peut pas être utilisé avec des droits élevés.
  • SapPlugin (exclusivement pour UiPathStudio.msi) — Installe le plug-in SAP Solution Manager. Nécessite l'installation du connecteur SAP pour Microsoft sur votre ordinateur. Sur les nouvelles installations, vous devez également fournir une adresse pour l'instance à l'aide du paramètre SAP_SOL_MAN_HOST. Doit être utilisé conjointement avec le paramètreStudio. Non disponible pour les installations par utilisateur.
  • VMwareExtension — Installe l'extension UiPath pour VMware Horizon. Doit être utilisé conjointement avec le paramètreRobot. Non disponible pour les installations par utilisateur.
  • WindowsRdpExtension — Installe l'extension UiPath pour Windows Remote Desktop. Doit être utilisé conjointement au paramètre Robot.
• MSIINSTALLPERUSER - Vous permet d'installer uniquement pour l'utilisateur actuel.
  • Pour installer par utilisateur, ajoutez MSIINSTALLPERUSER=1. Les options suivantes ne sont pas disponibles dans les installations par utilisateur : RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
  • Pour une installation par machine, excluez ce paramètre.
• SAP_SOL_MAN_HOST (exclusivement pour UiPathStudio.msi) - Le nom d'hôte ou l'adresse IP de votre instance SAP Solution Manager. SAP Requis pour les nouvelles installations là où le paramètre SapPlugin a été ajouté à l'option ADDLOCAL.
• APPLICATIONFOLDER - Vous permet d'installer le robot dans un emplacement personnalisé.
• NUGET_OPTIONS - Pour les environnements hors ligne. S'il est défini sur DisableOnlineFeeds, ce paramètre désactive les flux UiPath officiel et Community en ligne pour le robot et utilise exclusivement les flux Orchestrator et local.
  Remarque : Les flux URL restent dans les fichiers de configuration, mais sont ignorés.

• PACKAGES_FOLDER

  • Vous permet de modifier l'emplacement de téléchargement de vos workflows et de leurs dépendances. Le dossier choisi peut être spécifique à un utilisateur ou accessible à tous les utilisateurs d'une machine.
  • Sans ce paramètre, l'emplacement de téléchargement par défaut est %userProfile%\.nuget\packages.

  • Non disponible pour les installations par utilisateur.

    Remarque : vérifiez que tous les utilisateurs qui doivent exécuter des processus ont un accès au nouveau dossier en lecture seule.
  • Découvrez comment configurer .
  • Pour les installations sur des machines Windows Server qui permettent l'exécution simultanée, vous devez fournir des chemins d'accès spécifiques à chaque utilisateur. Apprenez-en davantage à propos des rôles.
  • Découvrez comment modifier le dossier de téléchargement des packages après l'installation.
• CUSTOM_NUGET_FEEDS - Vous permet d'ajouter des flux d'activités NuGet personnalisés pour Studio et/ou Robot. Cette commande ne fait qu'ajouter ou mettre à jour la liste de flux existante. Elle doit être remplie avec des paires clé-valeur de chaîne de caractères :
  • Les emplacements valides incluent les flux en ligne, les chemins d'accès aux 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 (;).

    Par exemple :

    CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"

• ENFORCE_SIGNED_EXECUTION : Facultatif. Vous permet de forcer vos Robots à exécuter uniquement les packages signés. Sans ce paramètre, la signature des packages n'est pas activée.Il propose les options suivantes :
  • 1 - Le robot gère uniquement les packages signés par les auteurs ou les référentiels vérifiés par UiPath. Pour ajouter votre propre certificat en tant que source approuvée, modifiez le fichier nuget.config.
  • 0 : aucune règle de signature de paquets n'est appliquée sur votre déploiement de Robot.
  Pour de plus amples informations, consultez la section Signature des packages.
• CODE - Concède une licence à votre instance de robot. Non disponible pour les installations par utilisateur.
• CLIENT_ID et CLIENT_SECRET - Connecte automatiquement le robot à Orchestrator à l'aide des informations d'identifiant du client tout en l'installant également.Par 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 - Vous permet de choisir la méthode d'installation de l'extension Chrome. Nécessite des droits d'administrateur. Sans ce paramètre, la méthode la plus appropriée est sélectionnée automatiquement. Il propose 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 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 /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 - Vous permet de choisir la méthode d'installation de l'extension Edge. Nécessite des droits d'administrateur. Sans ce paramètre, la méthode la plus appropriée est sélectionnée automatiquement. Il propose 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 - Vous permet de désactiver la sécurité des XAML fichiers pour les robots installés en tant que service Windows. Les fichiers non sécurisés XAMLpermettent aux utilisateurs de lire et de modifier les fichiers et la logique du processus. Il propose les options suivantes :
  • 0 - L'option par défaut.Active la sécurité des fichiers XAML pour les robots de service Windows.
  • 1 : Désactive la sécurité des fichiers XAML des Robots du service Windows.
• SERVICE_URL - Vous permet de définir l'URL de l'instance d'Orchestrator à laquelle vous connecter à l'aide de la connexion interactive. Cette valeur est enregistrée dans le uipath.configfichier. Requis par les installations en mode utilisateur. Les installations en mode Service ignorent ce paramètre.
• ORCHESTRATOR_URL - Dans les installations propres, 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 - Vous permet de désactiver la collecte des données d'utilisation. Il propose les options suivantes :
  • 0 - Désactive la télémétrie pour Studio et Robot.
  • 1 - Option par défaut. Active la télémétrie pour Studio et Robot.
  Découvrez comment refuser la télémétrie.
• ENABLE_PIP - Vous permet d'activer la fonctionnalité Session Robot (Picture in Picture) de la machine. Il propose les options suivantes :
  • 0 - Option par défaut. La fonctionnalité de session Robot est désactivée.
  • 1 - Active la fonctionnalité de session de robot.
• INSTALLER_LANGUAGE - Vous permet de sélectionner la langue d'affichage du programme d'installation. Sans ce paramètre, le programme d'installation utilise les paramètres de langue dans Windows. Il propose les options suivantes :
  • 2052 - Chinois (simplifié)
  • 12 - Français
  • 7 - Allemand -
  • 17 - Japonais
  • 1 - Coréen
  • 22 - Portugais (Portugal)
  • 1046 - Portugais (Brésil)
  • 25 - Russe
  • 10 - Espagnol (Espagne)
  • 2058 - Espagnol (Mexique)
  • 31 - Turc
• ASSISTANT_OPTIONS - Active ou désactive le widget Marketplace pour Assistant.Il propose les options suivantes :
  • Absent ou EnableMarketplace - L'option par défaut.Active le widget.
  • DisableMarketplace - Désactive le widget.
• ORCHESTRATOR_AUTO_SIGNIN - Active la connexion automatique à votre compte. Pour les installations en mode utilisateur et les environnements configurés pour utiliser l’ authentification unique avec Azure Active Directory Doit être utilisé avec le paramètre ORCHESTRATOR_URL . Il propose les options suivantes :
  • 0 - Désactive la connexion automatique.
  • 1 - Active la connexion automatique.

Utilisation des chemins dans la ligne de commande

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"'.

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_"