Paramètres de la ligne de commande

Vous pouvez installer et mettre à jour Studio et le Robot, ou changer une installation existante en exécutant le programme d’installation UiPathStudio.msi ou UiPathStudioCloud.msi depuis la ligne de commande.

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

Remarque :

• Les droits d'Administrator sont requis pour exécuter ces commandes. * La modification d'une installation existante en exécutant le programme d'installation depuis la ligne de commande en mode silencieux n'est pas prise en charge. Cependant, vous pouvez exécuter le programme d'installation en mode silencieux pour mettre à jour à partir d'une version plus ancienne. * L'utilisation de l'option /passive de msiexec.exe pour exécuter une installation non assistée 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.

Tous les paramètres peuvent être utilisés pour des nouvelles installations, mais seuls les paramètres suivants sont pris en charge lors de la mise à jour à partir d’une ancienne version ou de la modification d’une installation existante :

• Activez les fonctionnalités à l'aide de ADDLOCAL.
• Désactivez les fonctionnalités à l'aide de REMOVE. Notez que le Robot ne peut pas être désactivé.
• Activez ou désactivez les options de l'Assistant à l'aide de ASSISTANT_OPTIONS.
• SERVICE_URL - disponible lors de la commutation du Robot du mode de service en mode utilisateur lorsque l'argument RegisterService n'est pas inclus.
• NUGET_OPTIONS, ENFORCE_SIGNED_EXECUTION, DISABLE_SECURE_XAML, et TELEMETRY_ENABLED : disponibles lors de la mise à jour à partir d'une version antérieure, non disponible lors de la modification d'une installation existante.
• Consultez l’adresse du serveur proxy, soit une adresse IP, soit un nom de domaine en utilisant PROXY_ADDRESS.

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 ^ - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Dans les scripts de commandes, utilisez ^ - UiPathStudio.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, UiPathStudio.msi APPLICATIONFOLDER="C:\folder name".
  • Dans PowerShell, entourez de guillemets simples et doubles ('" "'). Par exemple, ./UiPathStudio.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	Pour installer le robot en mode service, ajoutez 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. Si vous convertissez le robot du mode service au mode utilisateur, le robot pourrait ne pas être en mesure d'accéder aux fichiers .xaml du dossier Packages NuGet d'origine.Pour plus de détails sur la façon de résoudre ce problème, consultez l'article sur les packages NuGet non accessibles après la migration. StartupLauncher – Exécute le robot au démarrage de Windows. Il ne peut pas être utilisé sans l'argument Robot. JavaBridge – Installe UiPath Java Bridge pour une intégration et une automatisation améliorées des applications Java. L'installation de Java Bridge peut prendre plus de temps que d'habitude. Il ne peut pas être utilisé sans l'argument Robot. ChromeExtension – Installe l'extension UiPath Google Chrome. Il ne peut pas être utilisé sans l'argument Robot. FirefoxExtension : installe l' Extension UiPath Mozilla Firefox. Ne peut être utilisé sans l’argument Robot . Exemple : UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension. EdgeExtension – Installe l'extension UiPath Microsoft Edge (basée sur Chromium). Il ne peut pas être utilisé sans l'argument Robot. CitrixClient – Installe l'extension du client UiPath Citrix. Il ne peut pas être utilisé sans l'argument Robot. JavaScriptAddOn - Installe le module complémentaire Robot JavaScript requis pour le SDK Robot JavaScript. SapPlugin - Installe le plug-in SAP solution Manager. Nécessite le connecteur SAP pour Microsoft. Pour les installations propres, vous devez également fournir l'adresse de l'instance à l'aide deSAP_SOL_MAN_HOST.Il ne peut pas être utilisé sans Studio. VMwareExtension – Installe l'extension UiPath pour VMware Horizon. Il ne peut pas être utilisé sans l'argument Robot. WindowsRdpExtension - Installe l'extension UiPath pour Microsoft Remote Desktop.Il ne peut pas être utilisé sans l'argument Robot. AmazonWorkSpacesClient – Installe l'extension UiPath pour Amazon WorkSpaces. Il ne peut pas être utilisé sans l'argument Robot. LiveStreaming – Installe le logiciel de diffusion en direct (RealVNC) nécessaire au débogage à distance. Consultez la fonctionnalité de diffusion en direct dans le guide du robot.
MSIINSTALLPERUSER	Ce paramètre vous permet d’installer Studio et Robot par utilisateur ou par machine. Si le paramètre n’est pas inclus, l’installation est effectuée par machine. Si vous ajoutez MSIINSTALLPERUSER=1, l’installation est effectuée par utilisateur. Le paramètre est utilisable uniquement lors de l'exécution d'une installation propre. Les options suivantes ne sont pas disponibles dans les installations par utilisateur : RegisterService, CitrixExtension, VMwareExtension, SapPlugin, PACKAGES_FOLDER, CODE.
SAP_SOL_MAN_HOST	Nom d'hôte ou adresse IP de votre instance de gestionnaire de solutions SAP. Obligatoire pour les nouvelles installations si l'argument SapPlugin été fourni pour l'option ADDLOCAL. Par exemple, UiPathStudio.msi ADDLOCAL=Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address.
APPLICATIONFOLDER	Cette commande vous permet d'installer Studio et Robot dans le répertoire de votre choix.
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 vous aide à désactiver les flux UiPath officiels et Community en ligne pour le robot : seuls les flux Orchestrator et locaux sont pris en compte. Veuillez noter que les flux d'URL ne sont pas supprimés des fichiers de configuration, mais simplement ignorés. Il peut être utilisé à la fois pour les installations et les mises à niveau. Lors de la mise à niveau, vous pouvez définir le paramètre sur EnableOnlineFeeds pour activer les flux en ligne. Remarque : le paramètre NUGET_OPTIONS ne désactive pas les flux UiPath en ligne officiels et Community pour Studio.
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 depuis une machine. Ce paramètre peut être utilisé à la fois pour les robots en mode de service et en mode utilisateur. Si vous n'indiquez pas ce paramètre, le dossier par défaut est %userProfile%\\.nuget\\packages. Lors de la modification du dossier Packages, assurez-vous que tous les utilisateurs qui doivent exécuter des Processes disposent d'un accès en lecture à ce dossier.L'utilisation du paramètre PACKAGES_FOLDER présente certaines limitations.Pour en savoir plus, consultez la documentation Dossiers de package et chemins d'accès réseau personnalisés. Pour les installations sur les machines Windows Server (qui activent l'exécution simultanée – HD Robots), vous devez fournir des chemins d'accès spécifiques à chaque utilisateur. En savoir plus sur l'utilisation du même chemin 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	1 : le Robot peut télécharger, installer ou exécuter uniquement l'auteur ou le référentiel des paquets signé par UiPath. Pour ajouter votre propre certificat en tant que source approuvée, vous devez le faire en modifiant le fichier nuget.config. Pour apprendre à le faire, consultez 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 Studio.
CLIENT_ID et CLIENT_SECRET	Connecte automatiquement le robot à Orchestrator à l'aide des informations d'identification du client tout en l'installant. Exemple : UiPathStudio.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
CHROME_INSTALL_TYPE	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). Les anciens noms des méthodes d'installation (STORE, GLOBAL ) sont conservés à des fins de rétrocompatibilité.
EDGE_INSTALL_TYPE	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). Les anciens noms des méthodes d'installation (STORE, GLOBAL ) sont conservés à des fins de rétrocompatibilité.
DISABLE_SECURE_XAML	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. Ce paramètre ne peut être utilisé que pendant une nouvelle installation ou une mise à jour.
SERVICE_URL	Vous permet de définir l’URL de l’instance Orchestrator à laquelle les utilisateurs se connecteront à l’aide de 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	TELEMETRY_ENABLED=0 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	ENABLE_PIP=1 Exemple : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	Chinois (simplifié) : INSTALLER_LANGUAGE=2052 Anglais : INSTALLER_LANGUAGE=9 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	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 Attended Robot en mode utilisateur et que votre environnement est configuré pour utiliser l'authentification unique (SSO) avec Azure Active Directory, cela active la connexion automatique à votre compte. Ce paramètre doit être utilisé conjointement avec ORCHESTRATOR_URL. Pour activer cette option, utilisez ORCHESTRATOR_AUTO_SIGNIN=1 .
ENFORCE_DEFAULT_SERVICE_URL	Pour les installations en mode utilisateur, ce paramètre applique l'URL du service par défaut. Pour activer cette option, utilisezENFORCE_DEFAULT_SERVICE_URL=1.ORCHESTRATOR_URLdoit également être activé.
PROXY_SCRIPT_ADDRESS	Si vous utilisez ce paramètre, n'utilisez pas d'autres paramètres spécifiques au proxy. Lorsque tous les paramètres sont présents dans le fichier UiPath.config, seule la clé ScriptAddress est utilisée.
PROXY_BYPASS_LOCAL_ADDRESS PROXY_BYPASS_LIST PROXY_USER_NAME PROXY_PASSWORD PROXY_DOMAIN	Adresse du serveur proxy (soit IP, soit nom de domaine). Par exemple : http://my.proxy.net:8008.
PROXY_ADDRESS PROXY_BYPASS_LIST	Permet une connexion directe pour les adresses locales, sans passer par le serveur proxy. Définissez-la sur 1 pour contourner l'adresse locale ; sinon, définissez-la sur 0.
PROXY_ADDRESS PROXY_BYPASS_LOCAL_ADDRESS	La liste des adresses qui se connectent directement à Internet, en contournant le serveur proxy. Doit contenir des chaînes RegExr incluant les URL des serveurs à contourner. Par exemple : « server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3} ».
PROXY_USER_NAME(nécessitePROXY_PASSWORD.)	Les informations d'identification du nom d'utilisateur pour l'authentification du serveur proxy.
PROXY_PASSWORD	Le mot de passe associé au nom d'utilisateur pour l'authentification du serveur proxy.
PROXY_DOMAIN	Domaine où réside le serveur proxy (requis pour l'authentification).

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 UiPathStudio.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 UiPathStudio.msi se trouve. Vous pouvez procéder à l'aide de la commande suivante, par exemple : cd D:\UiPathInstaller.

• Installez Studio, ainsi qu'un Robot en tant que service Windows et les paquets d'activités : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService
• Installer Studio et un Robot en mode utilisateur uniquement pour l'utilisateur actuel - UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot
• Installez la fonctionnalité de flux en direct pour les versions de Robot 2024.10 et ultérieures : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,LiveStreaming
• Installez l'ensemble de la gamme Bureau (Desktop) en mode silencieux : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Installez en mode silencieux l'ensemble de la suite Desktop et l'extension Chrome via la politique - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
• En mode silencieux, installez Studio, ainsi qu'un Robot en tant que service Windows et les paquets d'activités, le tout dans le dossier D:\UiPath : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService APPLICATIONFOLDER=D:\UiPath /Q
• Installez le Robot en tant que service Windows en mode silencieux et connectez-le à Orchestrator :

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

• Installe Studio en mode silencieux, le Robot en tant que service Windows et ajoute deux flux d'activités personnalisés : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• En mode silencieux, installez et activez la licence pour Studio, un Robot en tant que service Windows et un flux local d'activité : UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CODE=1234567890 /Q
• Installe Robot en tant que service Windows et désactive les flux en ligne officiels : UiPathStudio.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Désinstaller l'extension Chrome : UiPathStudio.msi REMOVE=ChromeExtension /Q
• Configuration de la connexion à mise à jour automatique lors de l’installation du robot Attended - UiPathStudio.msi ADDLOCAL=Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"
• Configuration de la connexion à mise à jour automatique lors de l’installation de l’Unattended Robot. - UiPathStudio.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"