Paramètres de la ligne de commande

Descriptions des arguments de ligne de commande

Il est possible d'installer ou de mettre à jour Studio ou Robot à l'aide de la ligne de commande, à condition de disposer du programme d'installation UiPathStudio.msi. Le tableau ci-dessous répertorie tous les paramètres disponibles que vous pouvez utiliser, ainsi que quelques exemples.

Remarque :

Les modifications de votre instance existante de la plateforme UiPath ne peuvent pas être effectuées depuis l'invite de commandes, en mode silencieux. En revanche, les modifications apportées aux éléments installés lors d'une mise à jour sont entièrement prises en charge.

Les arguments de ligne de commande de l'installation ne fonctionnent pas sur UiPathPlatformInstaller.exe.

Vous devez disposer de droits d'administrateur pour exécuter ces commandes.

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	Vous permet de sélectionner les fonctionnalités à installer. Si ADDLOCAL est utilisé, seules les fonctionnalités 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 packages d’activités et le module JavaScript add-on. Prend en charge les options suivantes : DesktopFeature : indique que vous désirez installer les fonctionnalités Robot et Studio. Studio : installe Studio. Cette commande doit être utilisée avec DesktopFeature. ExcelAddin : installe le complément Excel pour StudioX Cette commande doit être utilisée avec Studio. Robot - Installe le Robot en mode utilisateur ou en mode service. 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. UseLegacyTray – installe le panneau du robot hérité au lieu de l'assistant UiPath. Remarque : pour passer à l'assistant après l'installation, exécutez REMOVE=UseLegacyTray. Packages - installe les paquets d'activité, mais seulement à condition d'utiliser les arguments DesktopFeature et Robot. StartupLauncher : permet d'exécuter le Robot au démarrage de Windows, mais seulement si les arguments DesktopFeature et Robot sont utilisés. JavaBridge : Installe UiPath Java Bridge pour améliorer l'intégration et l'automatisation concernant les applications Java. Notez que l'installation de Java Bridge peut s'avérer plus longue. Vous ne pouvez pas l'utiliser sans les arguments DesktopFeature et Robot. ChromeExtension : installe l'Extension UiPath Google Chrome. Vous ne pouvez pas l'utiliser sans les arguments DesktopFeature et Robot. 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 de client UiPath Citrix. Vous ne pouvez pas l'utiliser sans les arguments DesktopFeature et Robot. JavaScriptAddOn - Installe l'extension Browser Embedding pour robot.
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. Vous pouvez utiliser ce paramètre pour les installations et pour les mises à niveau.
PACKAGES_FOLDER	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 d'une machine. Ce paramètre peut être utilisé si le robot est installé en tant que service ou en mode utilisateur. Pour le Robot en mode de service, les paquets sont installés simultanément sur tous les utilisateurs. Veuillez noter que, pour plusieurs Robots en Mode Utilisateur installés sur une machine, le dossier des packages ne peut pas être le même (tel que C:\Packages). En effet, le premier Robot en Mode Utilisateur qui télécharge et installe un package restreint l'accès au fichier .XAML uniquement à cet utilisateur, ce qui rend les autres Robots en Mode Utilisateur sur cette machine incapables d'utiliser le dossier ou package correspondant en raison de privilèges insuffisants. Si vous n'indiquez pas ce paramètre, le dossier par défaut est %userProfile%\.nuget\packages. 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 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^%. Pour plus d’informations sur la façon de modifier le dossier de téléchargement pour les packages après l’installation, voir Gérer les packages d’activités dans le Guide Studio.
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 seulement l'auteur ou le référentiel de paquets 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 Studio.
CONNECTIONSTRING	Connecte automatiquement le Robot à l'instance locale d'Orchestrator à l'aide de la chaîne de connexion tout en l'installant. Veuillez noter que les éléments suivants sont requis : 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. le Robot en mode de service une configuration de machine standard doit être en place. Remarque : l'inscription automatique avec des machines standard à l'aide du connectionstring ne peut être utilisée qu'avec Orchestrator v2020.10.
CHROME_INSTALL_TYPE	Installe automatiquement l'extension Chrome via une stratégie. Prend en charge les options suivantes : GLOBAL : l'extension Chrome est automatiquement installée par système, l'équivalent de l'appel de la commande /ChromeGlobal à l'aide de l'outil SetupExtenstions. STORE : l'extension Chrome est automatiquement installée par système via une stratégie, l'équivalent de l'appel de la commande /ChromePolicyGlobal à l'aide de l'outil SetupExtenstions.
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 mise à niveau.
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).
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. La télémétrie est activée par défaut pour Studio et Robot, pour la désactiver lors de l’installation, utiliser la valeur suivante pour le paramètre : TELEMETRY_ENABLED=0 Remarque: Cela désactive la télémétrie pour Studio et Robot. Si vous souhaitez ré-activer la télémétrie, utilisez 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 Abandon de la télémétrie.
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,Packages ENABLE_PIP=1

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=DesktopFeature,Studio,Robot,RegisterService,Packages
• Installer Studio et un Robot en mode utilisateur : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot
• Installez l'ensemble de la gamme Bureau (Desktop) en mode silencieux : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,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,Packages,ChromeExtension CHROME_INSTALL_TYPE=STORE /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=DesktopFeature,Studio,Robot,RegisterService,Packages 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, installez et activez la licence pour Studio, un Robot en tant que service Windows et un flux local d'activité : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages 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