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 :

• Vous devez disposer de droits d'administrateur pour exécuter ces commandes.
• Le changement d'une installation existante via l'exécution de l’installateur à partir de la ligne de commande en mode silencieux n’est pas pris en charge. Toutefois, vous pouvez exécuter l’installateur en mode silencieux pour mettre à jour à partir d’une ancienne version.
• 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.

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 :

• Activer / désactiver les fonctionnalités à l’aide de ADDLOCAL. Veuillez noter que le Robot ne peut pas être désactivé.

• 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 - ne sont pas disponibles pour la modification des installations existantes.

  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 : Studio, le Robot en mode service, les extensions pour Chrome et Edge (si les navigateurs sont installés sur la machine), et le module complémentaire JavaScript. Prend en charge les options suivantes : DesktopFeature : indique que vous désirez installer les fonctionnalités Robot et Studio. Studio : installe Studio. ExcelAddin : installe le complément Excel pour StudioX Vous ne pouvez pas l'utiliser sans Studio. Robot - Installe le Robot en mode utilisateur ou en mode service, ainsi que l'Assistant. 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. 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 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. Il ne peut pas être utilisé sans l'argument Robot. ChromeExtension : installe l'extension Google Chrome UiPath. Il ne peut pas être utilisé sans l'argument Robot. FirefoxExtension - par exemple  : UiPathStudio.msi ADDLOCAL=Studio,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. Il ne peut pas être utilisé sans l'argument Robot. JavaScriptAddOn - Installe le module complémentaire Robot JavaScript pour prendre en charge le Robot JavaScript SDK. SapPlugin - 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. 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 le bureau à distance Microsoft. Il ne peut pas être utilisé sans l'argument 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. Les paramètres ne sont utilisables que lors de l’exécution d’une nouvelle installation. 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 pour votre instance SAP Solution Manager. Nécessaire pour les nouvelles installations si l’argument SapPlugin a été fourni pour l’option ADDLOCAL. Par exemple UiPathStudio.msi ADDLOCAL=DesktopFeature,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 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. It can be used for both installations and upgrades. The NUGET_OPTIONS parameter does not disable the online UiPath official and Community feeds for 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 à 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. 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. 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^% For installations on Windows Server machines (that enable concurrent execution - HD Robots), you must provide paths that are specific to each user. Read more about using the same path for multiple robots.. When using the PACKAGES_FOLDER parameter, there are some limitations. Find out more in the custom package folders and network paths documentation. For information on how to change the download folder for packages after installation, see Managing Activities Packages.
  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 - The Robot is able to download, install, or execute only packages author or repository signed by UiPath. If you want to add your own certificate as a trusted source, you have to do so by modifying the nuget.config file. To learn how to do this, please see this page. 0 : aucune règle de signature de paquets n'est appliquée sur votre déploiement de Robot. For information on how to enforce signed execution after installation, see Signing Packages .
  CODE	Permet d'activer la licence de votre Studio.
  CONNECTIONSTRING	Automatically connects the Robot to Orchestrator on-premises using the connection string while also installing it. Please note that the following are required: Le paramètre WindowsAuth.Enabled du fichier UiPath.Orchestrator.dll.config doit être configuré sur true. Le paramètre WindowsAuth.Domain doit être configuré sur un domaine valide. the Service Mode Robot a Standard Machine configuration has to be in place. Automatic enrollment with standard machines using the CONNECTIONSTRING can only be used with Orchestrator v2020.10.
  CHROME_INSTALL_TYPE	Installe automatiquement l'extension Chrome via une stratégie. Prend en charge les options suivantes : GLOBAL - The Chrome Extension is automatically installed per system, the equivalent of calling the /ChromeGlobal command using the SetupExtenstions tool. STORE - The Chrome Extension is automatically installed per system via policy, the equivalent of calling the /ChromePolicyGlobal command using the SetupExtenstions tool.
  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. 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	Permet de désactiver la collecte des données d'utilisation et peut être effectuée au moment de l'installation pour Studio et Robot. Ce paramètre ne peut être utilisé que pendant une nouvelle installation ou une mise à jour. 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 Cela désactive la télémétrie à la fois pour Studio et Robot. 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 For more information about usage data collection and how to change telemetry settings, see the Opting Out of Telemetry document.
  ENABLE_PIP	Vous 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 : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,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 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
  ORCHESTRATOR_AUTO_SIGNIN	If you install the attended robot in user mode and your environment is configured to use SSO with Azure Active Directory, this enables automatic sign-in to your account. This parameter must be used together with 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 de service par défaut. Pour activer cette option, utilisez ENFORCE_DEFAULT_SERVICE_URL=1. ORCHESTRATOR_URL doit également être activée.

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.

• Installer Studio et Robot en tant que service Windows : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService

• Installer Studio et Robot en mode utilisateur uniquement pour l'utilisateur actuel : UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Studio,Robot

• Installez l'ensemble de la gamme Bureau (Desktop) en mode silencieux : UiPathStudio.msi ADDLOCAL=DesktopFeature,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=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=STORE /Q

• En mode silencieux, installer Studio, ainsi que Robot en tant que service Windows, le tout dans le dossier D:\UiPath : UiPathStudio.msi ADDLOCAL=DesktopFeature,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=DesktopFeature,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=DesktopFeature,Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1, https://my.custom.nuget.feed; FeedName2, D:\RPA\Activities\Packages\" /Q

• En mode silencieux, installer et activer la licence pour Studio, et installer Robot en tant que service Windows : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService CODE=1234567890 /Q

• Installe Robot en tant que service Windows et désactive les flux en ligne officiels : UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds

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

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

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

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