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

The following list displays all available command line parameters.

• /q - Installs the specified UiPath features silently, without displaying the user interface.
• /l*vx <LogFile> - Generates an installer log file at the specified path. You can send the file further to our support team if, for any reason, you encounter difficulties during the installation process.
• ADDLOCAL - Allows selecting the features to install. Without this parameter, the following features are installed by default: Robot in Service Mode, Default activity packages, and JavaScript Add-on.

  Prend en charge les options suivantes :

  • DesktopFeature— Indicates that you want to install the Robot feature.
  • Studio (exclusively for UiPathStudio.msi) — Installs Studio. Must be used together with the DesktopFeature parameter.
  • ExcelAddin (exclusively for UiPathStudio.msi) — Installs the StudioX Excel Add-in. Must be used together with the Studio parameter.
  • Robot — Installs the Robot in User Mode or Service Mode, as well as the Assistant. Must be used together with the DesktopFeatureparameter.
  • RegisterService — Required for Service Mode installations. Do not add it for User Mode installations.
  • StartupLauncher — Runs the Robot at Windows startup. Must be used together with the DesktopFeature parameter.
  • Packages (exclusively for UiPathStudio.msi) — Installs the default activity packages. Must be used together with the Robot parameter.
  • JavaBridge — Installs the UiPath Java Bridge for better integration and automation with Java applications. Adding this may increase installation time. Must be used together with the Robot parameter.
  • ChromeExtension — Installs the Google Chrome Extension. Must be used together with the Robot parameter.
  • FirefoxExtension — Installs the Firefox extension. Must be used together with the Robot parameter.
  • EdgeExtension — Installs the Microsoft Edge Chromium-based Extension. Must be used together with the Robot parameter.
  • CitrixClient — Installs the UiPath Citrix Client Extension. Must be used together with the Robot parameter. Not available for per-user installations.
  • JavaScriptAddOn — Installs the Browser Embedding add-on. Must be used together with the Robot parameter. Cannot be used with elevated rights.
  • SapPlugin (exclusively for UiPathStudio.msi) — Installs the SAP Solution Manager plugin. Requires the SAP Connector for Microsoft to be installed on your machine. On clean installs, you must also provide an address for the instance using the SAP_SOL_MAN_HOST parameter. Must be used together with the Studio parameter. Not available for per-user installations.
  • VMwareExtension — Installs the UiPath extension for VMware Horizon. Must be used together with the Robot parameter. Not available for per-user installations.
  • WindowsRdpExtension — Installs the UiPath extension for Windows Remote Desktop. Must be used together with the Robot parameter.
• MSIINSTALLPERUSER - Enables you to install only for the current user.
  • To install per user, add MSIINSTALLPERUSER=1. The following options are not available in per-user installations: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
  • Pour une installation par machine, excluez ce paramètre.
• SAP_SOL_MAN_HOST (exclusively for UiPathStudio.msi) - The hostname or IP address of your SAP Solution Manager instance. Required for clean installations where the SapPlugin parameter was added in the ADDLOCAL option.
• APPLICATIONFOLDER - Enables you to install the Robot in a custom location.
• NUGET_OPTIONS - For offline environments. If set to DisableOnlineFeeds, this parameter disables the online UiPath official and Community feeds for the Robot, and uses Orchestrator and local feeds exclusively.
  Note: The URL feeds remain in the configuration files, but are ignored.

• 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.
  • Find out how to set up .
  • For installations on Windows Server machines that enable concurrent execution, you must provide paths that are specific to each user. Read more about .
  • Découvrez comment modifier le dossier de téléchargement des packages après l'installation.
• CUSTOM_NUGET_FEEDS - Enables you to add custom NuGet activities feeds for Studio and/or Robot. This command only adds or updates the existing list of feeds. It must be populated with key-value pairs of type string:
  • 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 - Optional. Enables you to enforce your Robots to execute only signed packages. Without this parameter, package signing is not enabled. It has the following options:
  • 1 - The Robot only handles packages signed by UiPath-verified authors or repositories. To add your own certificate as a trusted source, modify the nuget.config file.
  • 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 - Licenses your Robot instance. Not available for per-user installations.
• CLIENT_ID and CLIENT_SECRET - Automatically connects the Robot to Orchestrator using client credentials, while also installing it. For example:

  UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k

• CHROME_INSTALL_TYPE - Allows you to choose the installation method for the Chrome extension. Needs admin rights. Without this parameter, the most appropriate method is selected automatically. It has the following options:
  • 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 - Allows you to choose the installation method for the Edge extension. Needs admin rights. Without this parameter, the most appropriate method is selected automatically. It has the following options:
  • 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 - Allows you to disable security of XAML files for Robots installed as a Windows service. Unsecured XAML files allow users to read and modify the process files and logic. It has the following options:
  • 0 - The default option. Enables security for XAML files for Windows service Robots.
  • 1 : Désactive la sécurité des fichiers XAML des Robots du service Windows.
• SERVICE_URL - Allows you to define the URL of the Orchestrator instance to connect to using Interactive Sign-In. This value is saved in the uipath.config file. Required by User Mode installations. Service Mode installations ignore this parameter.
• ORCHESTRATOR_URL - In clean installations, you can specify the main Orchestrator URL, used for retrieving auto-update information. For example: https://orchestrator.local/organizationName/tenantName.
• TELEMETRY_ENABLED - Allows you to disable the usage data collection. It has the following options:
  • 0 - Disables the telemetry for Studio and Robot.
  • 1 - Default option. Enables the telemetry for Studio and Robot.
  Découvrez comment refuser la télémétrie.
• ENABLE_PIP - Allows you to enable the Robot session (Picture in Picture) functionality of the machine. It has the following options:
  • 0 - Default option. The Robot session capability is disabled.
  • 1 - Enables the Robot session capability.
• INSTALLER_LANGUAGE - Enables you to select the display language of the installer. Without this parameter, the installer uses the language settings in Windows. It has the following options:
  • 2052 - Chinese (Simplified)
  • 12 - French
  • 7 - German
  • 17 - Japanese
  • 1 - Korean
  • 22 - Portuguese (Portugal)
  • 1046 - Portuguese (Brazil)
  • 25 - Russian
  • 10 - Spanish (Spain)
  • 2058 - Spanish (Mexico)
  • 31 - Turkish
• ASSISTANT_OPTIONS - Enables or disables the Marketplace widget for Assistant. It has the following options:
  • Absent or EnableMarketplace - The default option. Enables the widget.
  • DisableMarketplace - Disables the widget.
• ORCHESTRATOR_AUTO_SIGNIN - Enables automatic sign-in to your account. For User Mode installations and environments configured to use the SSO with Azure Active Directory. Must be used together with the ORCHESTRATOR_URL parameter. It has the following options:
  • 0 - Disables the automatic sign-in.
  • 1 - Enables the automatic sign-in.

Using paths in command line

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