Options globales

Options globales acceptées par chaque invocation `uip`, couvrant le format de sortie, le filtre de sortie, le niveau de journalisation et le fichier journal.

Chaque uip invocation est pré-analysée pour un ensemble fixe d'options globales avant qu'un outil ou une sous-commande ne voie ses arguments — elles peuvent apparaître n'importe où sur la ligne de commande, fonctionner de manière identique dans chaque outil et sont supprimés avant l'analyse des indicateurs par commande s'exécute.

Option	Short	Valeur (Value)	Default	Objectif
--output	—	table, json, yaml, plain, markdown	json	Format de la sortie principale écrite sur stdout.
--output-filter	—	Expression JMESPath	—	Filter applied to the Data field of the response envelope before formatting.
--log-level	—	debug, info, warn, error	info	Verbosity of log messages written to stderr (or to --log-file if set).
--log-file	—	Chemin d'accès	—	If set, logs are written to this file instead of stderr.
--profile	—	name	—	Sélectionne un profil de connexion nommé et enregistré au lieu de l'emplacement des informations d'identification par défaut. mutuellement exclusif avec le propre -f, --file <folder> d'une commande (par exemple sur uip login, uip login tenant list/set, uip logout) — la transmission des deux est un ValidationError. Voir Sessions et informations d’identification.
--interactive / --no-interactive	—	Drapeau	auto (invite uniquement sur un service TType)	Forcer l’activation ou la désactivation de l’invite, remplaçant l’invite « UiPath » par défaut uniquement en cas de connexion à un « TType » comportement. Non spécifique à une seule commande - elle régit chaque endroit où une commande uip poserait autrement une question (par exemple la sélection du locataire pendant uip login, ou le sélecteur d'agent/de cible lors de uip skills install).

--version (-v) et --help (-h) sont également reconnus sur uip et chaque sous-commande, mais il s'agit de conventions CLI standard plutôt que d'indicateurs globaux au sens ci-dessus.

--sortie

Choisissez le format de sortie. --output json et --output=json fonctionnent; les valeurs sont sensibles à la casse.

uip or folders list                     # default: json
uip or folders list --output table      # human-friendly table
uip or folders list --output yaml       # yaml
uip or folders list --output plain      # key=value lines, no structure
uip or folders list --output markdown   # GitHub-flavored markdown, for agents/chat surfaces

• json (par défaut) — un document JSON sur stdout. Analysable par jq, --output-filter et tout consommateur JSON. Il s'agit de la valeur par défaut pour chaque invocation, que le terminal soit un Tty.
• table — tableau colorée à bordures adapté à la lecture dans un terminal. Non stable entre les versions, ne l’analysez pas.
• yaml — Sérialisation YAML de la même structure que json
• plain — lignes plates key=value . Utile pour les pipelines dans le shell read, grep et cut sans installer jq
• markdown — a GFM table for a list, or **key:** value lines for a single record. Meant for an agent or chat surface reading uip output, not a terminal session. Refer to Output formats — markdown for the full behavior.

Only the five format names above are read as the global option. Several commands own a -o, --output <path> option of their own; a value that is not a format name, such as --output ./report.pdf, is left for the command. You can therefore combine a format and a command's output path in one invocation, for example --output json -o ./report.pdf.

Remarque :

La valeur par défaut est json, et non table. Lorsqu'un humain exécute uip or folders list dans un terminal, un document JSON s'affiche sur stdout. Transmettez --output table explicitement (ou ajoutez-le à un alias shell) pour améliorer la vue. Ce choix conserve la même forme stdout dans un terminal et dans un pipeline - les scripts n'ont pas besoin de se soucier s'ils s'exécutent de manière interactive.

-- profil

Sélectionnez un profil de connexion nommé et enregistré au lieu de l’emplacement des informations d’identification par défaut:

uip login --profile ci-runner --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant Production
uip or folders list --profile ci-runner

--profile <name> et le -f, --file <folder> d'une commande sont mutuellement exclusifs; la transmission des deux échoue avec ValidationError: option '--profile' cannot be used with option '--file'. Les noms de profil sont normalisés (des règles de casse et de séparation s'appliquent); un nom non valide est rejeté avant tout appel réseau. Voir Sessions et informations d’identification — Profils nommés.

--interactive / --no-interactive

Remplacer l’invite « UiPath » par défaut uniquement lorsque stdout est un « TType »; Comportement:

uip login --interactive        # force the tenant-selection prompt even when not on a TTY
uip skills install --no-interactive --agent claude   # never prompt, fail instead if a required choice is missing

--interactive définit l'invite sur Toujours activée; --no-interactive l'empêche. Aucun indicateur n'est spécifique à uip login - bien qu'apparaissant dans les exemples de connexion tout au long de cet ensemble de documentation, l'interactivité est une option globale croisée sans forme courte spécifique à la commande (il n'y a pas --it ou d'alias similaire n'importe où dans la CLI).

Séparation des flux

--output contrôle uniquement le stdout. Les journaux, les indicateurs de progression et les erreurs liées à un humain sont transmis à stderr, quel que soit leur format. Cela signifie qu'un pipeline peut capturer un fichier JSON propre avec:

uip or folders list > folders.json 2> uip.log

…et toujours consulter la sortie du journal séparément.

--filtre-sortie

Apply a JMESPath expression to the Data field of the response envelope before formatting. The expression starts at Data, not at the envelope, so [*].Name picks names out of a Data array and length(@) returns a count. The result replaces Data; Result, Code, and the other envelope fields stay in place.

# folder names only
uip or folders list --limit 50 --output-filter "[*].Name"

# count
uip or folders list --limit 50 --output-filter "length(@)"

# first folder's key and name
uip or folders list --limit 50 --output-filter "[0].{Key: Key, Name: Name}"

Keys in the filtered result are normalized to PascalCase, the same as unfiltered Data. A projection that returns plain values, such as [*].Name, is rendered as one record per value, keyed by the last field name in the expression.

Combinaison avec --output:

# names as YAML
uip or folders list --limit 50 --output-filter "[*].Name" --output yaml

# names as one-per-line plain text
uip or folders list --limit 50 --output-filter "[*].Name" --output plain

Une expression de filtre mal formée échoue rapidement avec un ValidationError et quitte le code 3 avant que la commande sous-jacente ne s'exécute - pour qu'une faute de frappe ne consomme pas d'appel d'API.

The filter runs on the client, over the records the command fetched. On a command whose --limit has a default value, --output-filter requires an explicit --limit; without one, the command fails instead of filtering only the first page of records.

When the filter returns nothing, or only null values, from records that were there, the envelope carries a Warning field that names the fields the expression read that do not exist, and lists the available fields. The same note is written to stderr.

On failure, the filter is applied to the failure envelope's Data the same way. Message, Instructions, ErrorCode, Retry, and Context are never filtered. If the filter cannot be evaluated against a failure's Data, Data is shown in full and Warning explains why.

Astuce :

--output-filter est la version pour la CLI de --query pour la CLI Azure, --query pour la CLI AWS et de --filter/--format pour gcloud. Si vous connaissez déjà JMESPath de ces outils, la syntaxe est identique.

--niveau-Journalisation

Set the verbosity of log messages (written to stderr, or to --log-file if provided).

uip or folders list --log-level debug   # verbose — HTTP calls, auth refresh, tool loading
uip or folders list --log-level info    # default
uip or folders list --log-level warn
uip or folders list --log-level error   # only failures

Les valeurs ne sont pas sensibles à la casse. Les valeurs inconnues sont ignorées en mode silencieux (la valeur par défaut est conservée) plutôt que de générer des erreurs — intentionnellement, de sorte qu'une faute de frappe dans un script de wrapper n'interrompt pas un pipeline.

La variable d’environnement UIPATH_LOG_LEVEL n’est pas respectée; transmettez l'indicateur ou définissez-le dans un script de profil.

--log-file

Write the log stream to the specified file instead of stderr. The file is created if it does not exist, including missing parent directories, and is truncated at the start of each run — use a build-specific path if you need to keep logs from several runs.

uip or folders list --log-file ./uip.log
uip or folders list --log-file /var/log/uip/$(date +%F).log --log-level debug

Each line in the file is the log message prefixed with an ISO 8601 timestamp:

2026-04-24T18:42:00.123Z [DEBUG] <message>

Debug, warning, and error lines carry a [DEBUG], [WARN], or [ERROR] tag; info lines carry none. When --log-file is set, every envelope includes a Log field with the file path.

Lorsque les options globales s'appliquent

Les options globales sont supprimées de la ligne de commande avant que les indicateurs par commande ne soient analysés, de sorte qu'ils peuvent apparaître n'importe où sur la ligne de commande:

uip --output table or folders list
uip or --output table folders list
uip or folders list --output table
uip or folders list --output=table

Les quatre invocations sont équivalentes.

Tool subcommands do not define their own --log-level. Commands that take an output path define -o, --output <path>; the CLI reads --output as the global option only when its value is one of the format names, so the two do not collide.

Codes de sortie

Sortie de contrôle des options globales et journalisation uniquement; elles n'affectent pas les codes de sortie. Voir Codes de sortie.

Remplacements des variables d'environnement

These environment variables change global-option behavior without a flag:

Variable	Effet
UIP_DEFAULT_OUTPUT	Remplace la valeur par défaut json intégrée pour --output lorsque l'indicateur n'est pas transmis. Accepte table, json, yaml, plain ou markdown; les valeurs non valides sont ignorées. Un --output explicite sur la ligne de commande l'emporte toujours.
UIP_TIMINGS	Set to 1 or true to print a per-invocation timing line on every uip command. Refer to Command timings below.
UIP_TIMINGS_FILE	Path of a file to append the timing line to, instead of writing it to stderr. Read only when UIP_TIMINGS is on.

Horodatages des commandes

Set UIP_TIMINGS=1 (or true) and every invocation prints one line to stderr (or to the --log-file file, when one is set):

[timing] 'uip or assets list' exit=0 total=1250ms startup=380ms command=863ms http=691ms httpCalls=3 flush=7ms

Champ	Signification
(la commande entre guillemets)	La commande telle qu'elle est saisie.
exit	Le code de sortie renvoyé par l’invocation.
total	Heures totales, mesurées à partir du début du processus.
startup	Tout avant l’exécution du gestionnaire de commandes: démarrage du processus, configuration, chargement de l’outil.
command	Le gestionnaire de commandes lui-même.
http	Durée additionnée des appels HTTP sortants de l'exécution — une somme, pas une horloge. Elle chevauche command plutôt que de s’ajouter à celle-ci, de sorte que les appels parallèles peuvent la rendre supérieure à command.
httpCalls	Combien d'appels HTTP sortants cette somme couvre.
flush	Tout après le retour du gestionnaire - la comptabilité de la télémétrie et le nettoyage final.

startup + command + flush est toujours égal à total. Les champs sont omis lorsqu'ils ne s'appliquent pas: une exécution qui n'atteint jamais un gestionnaire (uip --version, une commande inconnue) imprime uniquement total et exit; une commande qui n'effectue aucun appel HTTP n'a ni http ni httpCalls.

Le rapport a son propre commutateur, — il ne dépend pas de --log-level, vous obtenez donc des durées sans activer la sortie de débogage, et stdout n'est jamais modifié.

To keep the report off stderr without moving the rest of the log stream, set UIP_TIMINGS_FILE to a file path. Each invocation appends its line to that file, so several runs can share one file. Only the values 1 and true turn the report on; any other UIP_TIMINGS value leaves it off.

Voir également

• Formats de sortie (table, JSON, YAML) — couverture plus approfondie avec des exemples complets de chaque format.
• Modèles de script — codes de sortie, séparation des flux, nouvelles tentatives, interrogation.
• référence de connexion uip et d'autres pages de commande - documentent leurs indicateurs par commande en plus de ces globales.