robot

2023.10

false

Important :

La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Guide de l'utilisateur du Robot

Dernière mise à jour 22 nov. 2025

Interface de ligne de commande

L'Interface de ligne de commande du Robot (Robot Command Line Interface) (UiRobot.exe) est une application de console qui peut demander le démarrage des tâches et attendre leur sortie. Il s'agit d'un client direct du service Robot, et la communication s'effectue via un canal WCF.

Afin de pouvoir utiliser les arguments de ligne de commande pris en charge par les Robots, veuillez vérifier que le service du Robot UiPath^® est bien en cours d’exécution. Si ce n’est pas le cas, exécutez-le à partir du composant enfichable dans Services Microsoft Management Console.

Pour faciliter l'emploi des arguments de ligne de commande, utilisez la commande CD (Change Directory) pour accéder au dossier d'installation du Robot. Par exemple, si vous n'avez pas modifié le répertoire par défaut du robot, le chemin sera : cd C:\Program Files\UiPath\Studio.

All the examples displayed in the chapter are constructed from the assumption that you performed this action.

Commandes UiRobot.exe courantes

Exécuter

Utilisez cette commande pour démarrer l’exécution d’un fichier de projet s’il appartient aux types suivants :

JSON
XAML
NUPKG

Remarque :

À partir de la version 2023.4 de Robot, UiPath actualise la liste des processus en même temps qu’un processus s’exécute. Si une mise à jour de processus est disponible au moment du démarrage de la tâche, celle-ci utilise l’ancienne version du processus. Les exécutions suivantes appliqueront le processus mis à jour.

La commande d’exécution utilise les arguments suivants :

UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]

-p--process <Package_ID> (obligatoire) : démarre l’exécution d’un processus local ou d’un processus Orchestrator.

Exemples :

UiRobot.exe execute --process UiPathDemoProcessUiRobot.exe execute --process UiPathDemoProcess

UiRobot.exe execute -p UiPathDemoProcessUiRobot.exe execute -p UiPathDemoProcess

-f--file <File_Path> (obligatoire) : démarre l’exécution d’un fichier projet local. Le fichier cible peut être en JSON, XAML ou NUPKG.

Exemples :

UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"

UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"

UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"

--folder <Orchestrator_Folder_ID> (facultatif) : permet de spécifier le dossier Orchestrator à partir duquel installer et exécuter le processus cible. Il ne peut être utilisé qu’avec l’argument --process.

Exemple :
```
UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1
```

--input <Input_Parameters> (facultatif) : permet de spécifier des arguments d’entrée pour l’exécution. Il peut être utilisé avec les arguments --process ou --file.

Exemples :

UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}"

UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}"

UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}"

--entry <entrypoint> (facultatif) : permet de sélectionner le point d’entrée d’un processus lorsque vous le démarrez via la ligne de commande.

Exemple :

UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"

Important :

Les commandes suivantes ne sont pas disponibles pour les projets Windows ou multiplateformes :

UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml"

UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"

Vous ne pouvez pas utiliser simultanément les arguments --process (-p) et --file (-f) dans la commande d’exécution.

Installer un processus

Utilisez cette commande pour installer un processus. Si le robot est connecté à Orchestrator, il va rechercher le processus dans le flux Orchestrator. En l’absence de connexion à Orchestrator, le Robot utilise le flux local.

La commande d’installation de processus utilise les arguments suivants :

UiRobot.exe installprocess [--process-name <process_name>] [--folder <orchestrator_folder>]UiRobot.exe installprocess [--process-name <process_name>] [--folder <orchestrator_folder>]

--process-name <process_name> (obligatoire) : le nom du processus que vous souhaitez installer.

Exemple :
```
UiRobot installprocess --process-name MyProcessUiRobot installprocess --process-name MyProcess
```
--folder <orchestrator_folder> (facultatif) : le nom du dossier Orchestrator contenant le processus que vous souhaitez installer. Cet argument s’applique uniquement lorsque la connexion à Orchestrator est active. Si le processus d’installation est contenu dans un seul dossier, vous pouvez ignorer ce paramètre.

Exemple :
```
UiRobot installprocess -p MyProcess --folder MyOrchestratorFolderUiRobot installprocess -p MyProcess --folder MyOrchestratorFolder
```

Se connecter (Connect)

Utilisez cette commande pour connecter votre Robot à une instance d’Orchestrator. Si votre robot est déjà connecté à Orchestrator et que vous exécutez cette commande, il renverra le message « Orchestrator déjà connecté ».

La commande de connexion utilise les arguments suivants :

UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]

connect : établit la connexion à Orchestrator. Doit être utilisé avec les arguments --url, --key ou --clientID --clientSecret. Si ces arguments ne sont pas spécifiés, la commande utilisera la configuration Paramètres d’Orchestrator .

Exemples :

// no arguments

UiRobot.exe connect// no arguments

UiRobot.exe connect

//using the machine key

UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-ABCD-1234-7788GG99HH00//using the machine key

UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-ABCD-1234-7788GG99HH00

//using the client ID and secret

UiRobot.exe connect --url https://demo.uipath.com/ --clientID 696CCA0C-1234-ABCD-1234-F65BBC2F15DE --clientSecret QJX!jv12345A4q4N//using the client ID and secret

UiRobot.exe connect --url https://demo.uipath.com/ --clientID 696CCA0C-1234-ABCD-1234-F65BBC2F15DE --clientSecret QJX!jv12345A4q4N

Se déconnecter (Disconnect)

Utilisez cette commande pour déconnecter le Robot de l’instance d’Orchestrator actuelle.

La commande de déconnexion utilise les arguments suivants :

UiRobot.exe disconnect --force | --waitUiRobot.exe disconnect --force | --wait

disconnect : déconnecte le Robot d’Orchestrator uniquement lorsqu’il n’y a pas de tâche en cours d’exécution sur la machine robot.

Exemple :
```
UiRobot.exe disconnectUiRobot.exe disconnect
```
--force : interrompt toutes les tâches en cours d’exécution sur la machine, puis déconnecte le Robot d’Orchestrator.

Exemple :
```
UiRobot.exe disconnect --forceUiRobot.exe disconnect --force
```
--wait : attend la fin des tâches en cours d’exécution avant de déconnecter le Robot d’Orchestrator.

Exemple :
```
UiRobot.exe disconnect --waitUiRobot.exe disconnect --wait
```

Traçage (Trace)

Utilisez cette commande pour activer ou désactiver le traçage de niveau inférieur pour le Robot.

La commande de traçage utilise les arguments suivants :

UiRobot.exe trace --enableLowLevel | --disableLowLevelUiRobot.exe trace --enableLowLevel | --disableLowLevel

--enableLowLevel : active le traçage détaillé pour l’exécuteur et le service Robot dans l’Observateur d’événements. Un fichier ETL est généré, que vous pouvez ouvrir avec l’Observateur d’événements pour obtenir de l’aide sur la résolution des incidents et des erreurs.

Exemple :
```
UiRobot.exe trace --enableLowLevelUiRobot.exe trace --enableLowLevel
```
--disableLowLevel : désactive le traçage détaillé pour l’exécuteur Robot et le service de robot UiPath. Un fichier ETL est généré, que vous pouvez ouvrir avec l’Observateur d’événements pour obtenir de l’aide sur la résolution des incidents et des erreurs.

Exemple :
```
UiRobot.exe trace --disableLowLevelUiRobot.exe trace --disableLowLevel
```

PiP

Utilisez cette commande pour activer ou désactiver la session Robot ou la fonctionnalité d’incrustation d’image sur la machine. Ce paramètre modifie les installations existantes et s’applique à tous les utilisateurs de la machine locale. Il nécessite des privilèges administrateurs.

La commande PiP utilise les arguments suivants :

UiRobot.exe pip --enable | --disableUiRobot.exe pip --enable | --disable

--enable : active la session Robot (fonctionnalité PiP) de la machine.

Exemple :
```
UiRobot.exe pip --enableUiRobot.exe pip --enable
```
--disable : désactive la session Robot (fonctionnalité PiP) de la machine.

Exemple :
```
UiRobot.exe pip --disableUiRobot.exe pip --disable
```

Autres arguments

Les arguments suivants sont purement informatifs et n’ont aucun impact sur vos projets d’automatisation :

--version : affiche des informations concernant la version du Robot.
--help : affiche la liste des commandes prises en charge, ainsi que des informations et des exemples correspondants.
flushlogs [--timeout <timeout_in_seconds>] : envoie tous les journaux en attente à Orchestrator.