> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/fr/reference/cli.md).

# Interface en ligne de commande

Toutes les commandes en ligne de commande, options, paramètres de démarrage, variables d'environnement, liens profonds et commutateurs de l'installateur de UniGetUI.

La commande `unigetui` contrôle une session UniGetUI en cours depuis un terminal ou un script : chercher, installer, mettre à jour et retirer des paquets, gérer les paramètres, les sources, les lots et les sauvegardes, et lire les journaux. La CLI parle à la session par l'[API d'automatisation](/unigetui/fr/reference/ipc-api.md) locale.

{% hint style="info" %}
Si `unigetui` n'est pas reconnu dans votre shell, exécutez plutôt l'exécutable de UniGetUI depuis son dossier d'installation, par exemple `UniGetUI.exe` sous Windows.
{% endhint %}

## Conditions requises

La CLI a besoin d'une session UniGetUI à laquelle se connecter :

* **Session de bureau** : UniGetUI est ouvert ou s'exécute dans la zone de notification, et ***Activer l'API en arrière-plan (Widgets et Partage UniGetUI, port 7058)*** est activé dans ***Paramètres*** – ***Paramètres expérimentaux et options pour les développeurs***.
* **Session sans interface** : UniGetUI a été démarré avec `--headless`. Voir [Sessions sans interface](#headless-sessions).

Si aucune session n'est joignable, la commande se termine avec le code `3`.

## Démarrage rapide

```powershell
unigetui status
unigetui app status
unigetui package search --manager dotnet-tool --query dotnetsay
unigetui package install --manager dotnet-tool --id dotnetsay --version 2.1.4 --scope Global
unigetui operation wait --id 123 --timeout 300
```

## Syntaxe

* Les noms acceptent le singulier ou le pluriel : `operation`/`operations`, `package`/`packages`, `manager`/`managers`, `source`/`sources`, `shortcut`/`shortcuts`, `log`/`logs`, `backup`/`backups`, `bundle`/`bundles`.
* `startmenu` est accepté pour `start-menu`, et `folders` pour `folder`.
* Les options booléennes prennent une valeur explicite : `--enabled true`, `--wait false`.
* `--detach` est un raccourci pour `--wait false` sur les opérations de paquet. La commande retourne tout de suite un identificateur d'opération.
* Alias :
  * `--id` correspond à `--package-id` ou à `--operation-id`, selon la commande.
  * `--source` correspond à `--package-source`.
  * `--source-name` et `--source-url` correspondent à `--name` et `--url` pour `source add` et `source remove`.
  * `--name` correspond à `--key` pour `backup cloud download` et `backup cloud restore`.
* `--manager` prend un identifiant de gestionnaire stable, et non le nom affiché dans l'appli : `apt`, `bun`, `cargo`, `chocolatey`, `dnf`, `dotnet-tool`, `flatpak`, `homebrew`, `npm`, `pacman`, `pip`, `pwsh`, `scoop`, `snap`, `vcpkg`, `winget`, `winps`. Seuls les gestionnaires de la plateforme actuelle fonctionnent. Voir [Gestionnaires de paquets pris en charge](/unigetui/fr/reference/package-managers.md).

## Options de connexion

Par défaut, la CLI trouve elle-même la session en cours. Utilisez ces options pour en cibler une en particulier.

<table><thead><tr><th width="250">OPTION</th><th>VARIABLE D'ENVIRONNEMENT</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transport utilisé pour atteindre la session. Valeur par défaut : <code>named-pipe</code>.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Port TCP de la session. Seulement avec <code>tcp</code>.</td></tr><tr><td><code>--pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Canal nommé de la session. Sous Windows, un nom de canal. Sous macOS et Linux, un nom relatif est résolu sous <code>/tmp</code> et un chemin absolu est utilisé comme chemin exact de la socket Unix.</td></tr></tbody></table>

## Codes de sortie

<table><thead><tr><th width="250">CODE</th><th>SIGNIFICATION</th></tr></thead><tbody><tr><td><code>0</code></td><td>Succès.</td></tr><tr><td><code>1</code></td><td>La commande a échoué.</td></tr><tr><td><code>2</code></td><td>Un paramètre n'est pas valide.</td></tr><tr><td><code>3</code></td><td>L'API d'automatisation n'est pas disponible (aucune session jointe).</td></tr><tr><td><code>4</code></td><td>Commande inconnue.</td></tr></tbody></table>

## Commandes

### Session

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>status</code></td><td></td><td></td><td>Retourne le transport, le point de terminaison et les informations de build de la session.</td></tr><tr><td><code>version</code></td><td></td><td></td><td>Retourne le numéro de build de UniGetUI.</td></tr></tbody></table>

### Application

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>app status</code></td><td></td><td></td><td>Retourne l'état de la session : sans interface ou non, page actuelle, actions d'interface prises en charge.</td></tr><tr><td><code>app show</code></td><td></td><td></td><td>Affiche la fenêtre de UniGetUI et lui donne le focus.</td></tr><tr><td><code>app navigate</code></td><td><code>--page &#x3C;page></code></td><td><code>--manager &#x3C;id></code>, <code>--help-attachment &#x3C;path></code></td><td>Ouvre une page : <code>discover</code>, <code>updates</code>, <code>installed</code>, <code>bundles</code>, <code>settings</code>, <code>managers</code>, <code>own-log</code>, <code>manager-log</code>, <code>operation-history</code>, <code>help</code>, <code>release-notes</code>, <code>about</code>.</td></tr><tr><td><code>app quit</code></td><td></td><td></td><td>Ferme la session proprement, y compris une session sans interface.</td></tr></tbody></table>

### Opérations

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>operation list</code></td><td></td><td></td><td>Énumère les opérations en cours, en file et terminées.</td></tr><tr><td><code>operation get</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Retourne tout sur une opération.</td></tr><tr><td><code>operation output</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--tail &#x3C;n></code></td><td>Retourne les lignes de sortie d'une opération.</td></tr><tr><td><code>operation wait</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--timeout &#x3C;seconds></code>, <code>--delay &#x3C;seconds></code></td><td>Attend la fin de l'opération.</td></tr><tr><td><code>operation cancel</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Annule une opération en file ou en cours.</td></tr><tr><td><code>operation retry</code></td><td><code>--id &#x3C;operation-id></code></td><td><code>--mode &#x3C;mode></code></td><td>Exécute de nouveau l'opération. Les modes offerts sont énumérés dans les informations de l'opération.</td></tr><tr><td><code>operation reorder</code></td><td><code>--id &#x3C;operation-id></code>, <code>--action &#x3C;run-now|run-next|run-last></code></td><td></td><td>Déplace une opération en file dans la file d'attente.</td></tr><tr><td><code>operation forget</code></td><td><code>--id &#x3C;operation-id></code></td><td></td><td>Retire une opération terminée de la liste.</td></tr></tbody></table>

### Gestionnaires de paquets

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>manager list</code></td><td></td><td></td><td>Énumère les gestionnaires de paquets et leurs capacités.</td></tr><tr><td><code>manager maintenance</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Retourne les informations de maintenance d'un gestionnaire.</td></tr><tr><td><code>manager reload</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Recharge un gestionnaire.</td></tr><tr><td><code>manager set-executable</code></td><td><code>--manager &#x3C;id></code>, <code>--path &#x3C;path></code></td><td></td><td>Utilise un exécutable personnalisé, puis recharge le gestionnaire.</td></tr><tr><td><code>manager clear-executable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Retire l'exécutable personnalisé, puis recharge le gestionnaire.</td></tr><tr><td><code>manager action</code></td><td><code>--manager &#x3C;id></code>, <code>--action &#x3C;action></code></td><td><code>--confirm</code></td><td>Exécute une action de maintenance propre au gestionnaire.</td></tr><tr><td><code>manager enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Active le gestionnaire.</td></tr><tr><td><code>manager disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Désactive le gestionnaire.</td></tr><tr><td><code>manager notifications enable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Active les notifications de mise à jour pour le gestionnaire.</td></tr><tr><td><code>manager notifications disable</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Désactive les notifications de mise à jour pour le gestionnaire.</td></tr></tbody></table>

### Sources

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>source list</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Énumère les sources, au choix pour un seul gestionnaire.</td></tr><tr><td><code>source add</code></td><td><code>--manager &#x3C;id></code>, <code>--name &#x3C;source-name></code></td><td><code>--url &#x3C;source-url></code></td><td>Ajoute une source.</td></tr><tr><td><code>source remove</code></td><td><code>--manager &#x3C;id></code>, <code>--name &#x3C;source-name></code></td><td><code>--url &#x3C;source-url></code></td><td>Retire une source.</td></tr></tbody></table>

### Paramètres

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>settings list</code></td><td></td><td></td><td>Énumère les paramètres ordinaires et leurs clés.</td></tr><tr><td><code>settings get</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Lit un paramètre ordinaire.</td></tr><tr><td><code>settings set</code></td><td><code>--key &#x3C;key></code></td><td><code>--enabled true|false</code>, <code>--value &#x3C;text></code></td><td>Définit un paramètre, comme booléen ou comme texte.</td></tr><tr><td><code>settings clear</code></td><td><code>--key &#x3C;key></code></td><td></td><td>Efface un paramètre texte.</td></tr><tr><td><code>settings reset</code></td><td></td><td></td><td>Réinitialise les paramètres ordinaires.</td></tr><tr><td><code>settings secure list</code></td><td></td><td><code>--user &#x3C;name></code></td><td>Énumère les paramètres sécurisés (protégés par l'administrateur) de l'utilisateur actuel ou indiqué.</td></tr><tr><td><code>settings secure get</code></td><td><code>--key &#x3C;key></code></td><td><code>--user &#x3C;name></code></td><td>Lit un paramètre sécurisé.</td></tr><tr><td><code>settings secure set</code></td><td><code>--key &#x3C;key></code>, <code>--enabled true|false</code></td><td><code>--user &#x3C;name></code></td><td>Active ou désactive un paramètre sécurisé.</td></tr></tbody></table>

{% hint style="info" %}
Exécutez `unigetui settings list` et `unigetui settings secure list` pour voir les clés offertes. Le rôle de chaque paramètre est décrit dans [Tous les paramètres](/unigetui/fr/reference/settings.md).
{% endhint %}

### Raccourcis du bureau

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>shortcut list</code></td><td></td><td></td><td>Énumère les raccourcis du bureau suivis et indique si chacun est conservé ou supprimé.</td></tr><tr><td><code>shortcut set</code></td><td><code>--path &#x3C;path></code>, <code>--status &#x3C;keep|delete></code></td><td></td><td>Marque un raccourci à conserver ou à supprimer.</td></tr><tr><td><code>shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Efface le choix enregistré pour un raccourci.</td></tr><tr><td><code>shortcut reset-all</code></td><td></td><td></td><td>Efface les choix enregistrés pour tous les raccourcis.</td></tr></tbody></table>

### Raccourcis du menu Démarrer

Réservé à Windows. Le choix est enregistré selon le chemin du raccourci et appliqué de nouveau chaque fois qu'une mise à jour recrée le raccourci. Les chemins hors d'un dossier `Programs` du menu Démarrer, et les fichiers qui ne sont pas des raccourcis `.lnk` ou `.url`, sont rejetés.

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>start-menu shortcut list</code></td><td></td><td></td><td>Énumère les raccourcis du menu Démarrer suivis et indique si chacun est conservé ou supprimé.</td></tr><tr><td><code>start-menu shortcut set</code></td><td><code>--path &#x3C;path></code>, <code>--status &#x3C;keep|delete></code></td><td></td><td>Marque un raccourci du menu Démarrer à conserver ou à supprimer.</td></tr><tr><td><code>start-menu shortcut reset</code></td><td><code>--path &#x3C;path></code></td><td></td><td>Efface le choix enregistré pour un raccourci.</td></tr><tr><td><code>start-menu shortcut reset-all</code></td><td></td><td></td><td>Efface tous les choix enregistrés. Les règles de dossier, et les raccourcis qu'elles ont déplacés, ne sont pas touchés.</td></tr></tbody></table>

### Dossiers du menu Démarrer

Réservé à Windows. Une règle de dossier définit le sous-dossier du dossier `Programs` du menu Démarrer de l'utilisateur actuel où un paquet conserve ses raccourcis. UniGetUI l'applique après chaque installation et chaque mise à jour, et supprime les raccourcis déplacés lorsque le paquet est désinstallé.

* `--package` utilise le format `manager\PackageId`, par exemple `winget\Python.Python.3.13`. La partie gestionnaire est en minuscules. La règle ignore la source, donc deux paquets avec le même gestionnaire et le même identificateur, provenant de sources différentes, partagent une seule règle.
* `--folder` doit être un sous-dossier du dossier `Programs` du menu Démarrer. Les chemins absolus, les segments `..` et le dossier du menu Démarrer de tous les utilisateurs sont rejetés.

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>start-menu folder list</code></td><td></td><td></td><td>Énumère les règles de dossier. Les paquets qui n'ont que des raccourcis en attente sont aussi énumérés, avec un dossier vide.</td></tr><tr><td><code>start-menu folder set</code></td><td><code>--package &#x3C;manager\id></code>, <code>--folder &#x3C;name></code></td><td><code>--relocate-existing</code></td><td>Crée une règle de dossier. <code>--relocate-existing</code> déplace aussi les raccourcis existants du paquet.</td></tr><tr><td><code>start-menu folder remove</code></td><td><code>--package &#x3C;manager\id></code></td><td></td><td>Retire la règle de dossier d'un paquet.</td></tr></tbody></table>

### Journaux

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>log app</code></td><td></td><td><code>--level &#x3C;n></code></td><td>Retourne le journal d'application de UniGetUI.</td></tr><tr><td><code>log operations</code></td><td></td><td></td><td>Retourne l'historique des opérations.</td></tr><tr><td><code>log manager</code></td><td></td><td><code>--manager &#x3C;id></code>, <code>--verbose</code></td><td>Retourne les journaux du gestionnaire de paquets.</td></tr></tbody></table>

### Sauvegardes

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>backup status</code></td><td></td><td></td><td>Retourne les paramètres de sauvegarde et l'état de connexion à GitHub.</td></tr><tr><td><code>backup local create</code></td><td></td><td></td><td>Crée une sauvegarde locale.</td></tr><tr><td><code>backup github login start</code></td><td></td><td><code>--launch-browser</code></td><td>Démarre la connexion à GitHub (flux d'appareil).</td></tr><tr><td><code>backup github login complete</code></td><td></td><td></td><td>Termine la connexion à GitHub en attente.</td></tr><tr><td><code>backup github logout</code></td><td></td><td></td><td>Se déconnecte de GitHub et retire le jeton enregistré.</td></tr><tr><td><code>backup cloud list</code></td><td></td><td></td><td>Énumère les sauvegardes infonuagiques.</td></tr><tr><td><code>backup cloud create</code></td><td></td><td></td><td>Téléverse une sauvegarde dans le nuage.</td></tr><tr><td><code>backup cloud download</code></td><td><code>--key &#x3C;name></code></td><td></td><td>Télécharge une sauvegarde infonuagique comme contenu de lot.</td></tr><tr><td><code>backup cloud restore</code></td><td><code>--key &#x3C;name></code></td><td><code>--append</code></td><td>Importe une sauvegarde infonuagique dans le lot actuel.</td></tr></tbody></table>

### Lots

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>bundle get</code></td><td></td><td></td><td>Retourne le lot actuel.</td></tr><tr><td><code>bundle reset</code></td><td></td><td></td><td>Vide le lot actuel.</td></tr><tr><td><code>bundle import</code></td><td></td><td><code>--path &#x3C;path></code>, <code>--content &#x3C;text></code>, <code>--format &#x3C;ubundle|json|yaml|xml></code>, <code>--append</code></td><td>Importe un lot depuis un fichier ou un contenu brut.</td></tr><tr><td><code>bundle export</code></td><td></td><td><code>--path &#x3C;path></code></td><td>Exporte le lot actuel, au choix vers un fichier.</td></tr><tr><td><code>bundle add</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--selection &#x3C;search|installed|updates|auto></code></td><td>Trouve un paquet et l'ajoute au lot.</td></tr><tr><td><code>bundle remove</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--selection &#x3C;mode></code></td><td>Retire les paquets correspondants du lot.</td></tr><tr><td><code>bundle install</code></td><td></td><td><code>--include-installed true|false</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--skip-hash true|false</code></td><td>Installe les paquets du lot.</td></tr></tbody></table>

### Paquets

<table><thead><tr><th width="250">COMMANDE</th><th>OBLIGATOIRE</th><th>FACULTATIF</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>package search</code></td><td><code>--query &#x3C;text></code></td><td><code>--manager &#x3C;id></code>, <code>--max-results &#x3C;n></code></td><td>Recherche des paquets.</td></tr><tr><td><code>package details</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code></td><td>Retourne les détails d'un paquet.</td></tr><tr><td><code>package versions</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code></td><td>Retourne les versions installables, lorsque le gestionnaire le prend en charge.</td></tr><tr><td><code>package installed</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Énumère les paquets installés.</td></tr><tr><td><code>package updates</code></td><td></td><td><code>--manager &#x3C;id></code></td><td>Énumère les mises à jour offertes.</td></tr><tr><td><code>package install</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--pre-release</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--skip-hash true|false</code>, <code>--architecture &#x3C;value></code>, <code>--location &#x3C;path></code>, <code>--wait true|false</code>, <code>--detach</code></td><td>Installe un paquet. Le mode asynchrone retourne tout de suite un identificateur d'opération.</td></tr><tr><td><code>package download</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--version &#x3C;version></code>, <code>--scope &#x3C;scope></code>, <code>--wait true|false</code>, <code>--detach</code>, <code>--output &#x3C;path></code></td><td>Télécharge l'installateur d'un paquet.</td></tr><tr><td><code>package reinstall</code></td><td><code>--id &#x3C;package-id></code></td><td>Identique à <code>package install</code></td><td>Installe de nouveau un paquet déjà installé.</td></tr><tr><td><code>package repair</code></td><td><code>--id &#x3C;package-id></code></td><td>Identique à <code>package install</code>, plus <code>--remove-data true|false</code></td><td>Désinstalle, puis réinstalle le paquet.</td></tr><tr><td><code>package update</code></td><td><code>--id &#x3C;package-id></code></td><td>Identique à <code>package install</code></td><td>Met à jour un paquet.</td></tr><tr><td><code>package uninstall</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--source &#x3C;source></code>, <code>--scope &#x3C;scope></code>, <code>--remove-data true|false</code>, <code>--elevated true|false</code>, <code>--interactive true|false</code>, <code>--wait true|false</code>, <code>--detach</code></td><td>Désinstalle un paquet.</td></tr><tr><td><code>package show</code></td><td><code>--id &#x3C;package-id></code>, <code>--source &#x3C;source></code></td><td></td><td>Ouvre les détails du paquet dans la fenêtre de UniGetUI.</td></tr><tr><td><code>package ignored list</code></td><td></td><td></td><td>Énumère les mises à jour ignorées.</td></tr><tr><td><code>package ignored add</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--version &#x3C;version></code>, <code>--source &#x3C;source></code></td><td>Ignore les mises à jour d'un paquet.</td></tr><tr><td><code>package ignored remove</code></td><td><code>--id &#x3C;package-id></code></td><td><code>--manager &#x3C;id></code>, <code>--version &#x3C;version></code>, <code>--source &#x3C;source></code></td><td>Cesse d'ignorer les mises à jour d'un paquet.</td></tr><tr><td><code>package update-all</code></td><td></td><td></td><td>Met en file les mises à jour de chaque paquet qui peut être mis à jour.</td></tr><tr><td><code>package update-manager</code></td><td><code>--manager &#x3C;id></code></td><td></td><td>Met en file les mises à jour de chaque paquet d'un gestionnaire.</td></tr></tbody></table>

## Sessions sans interface

Démarrez UniGetUI avec `--headless` pour exécuter l'API d'automatisation sans fenêtre, par exemple sur un agent de build ou dans un script.

```powershell
UniGetUI.exe --headless
```

<table><thead><tr><th width="250">PARAMÈTRE</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td>Transport de l'API. Valeur par défaut : <code>named-pipe</code>.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td>Port TCP, avec le transport <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td>Nom du canal, ou chemin de la socket Unix sous macOS et Linux.</td></tr></tbody></table>

Certaines commandes dépendent de la fenêtre et se comportent autrement sans interface :

<table><thead><tr><th width="250">COMMANDE</th><th>DANS UNE SESSION SANS INTERFACE</th></tr></thead><tbody><tr><td><code>status</code>, <code>app status</code>, <code>app quit</code></td><td>Entièrement pris en charge.</td></tr><tr><td><code>app show</code>, <code>app navigate</code></td><td>Échec : il n'y a aucune fenêtre.</td></tr><tr><td><code>package show</code></td><td>Ouvre un flux d'interface, donc cela peut échouer ou ne rien faire.</td></tr><tr><td><code>package update-all</code>, <code>package update-manager</code></td><td>Peuvent échouer : elles comptent sur la fenêtre pour démarrer les mises à jour.</td></tr></tbody></table>

## Paramètres de démarrage

L'exécutable de UniGetUI accepte aussi ces paramètres.

<table><thead><tr><th width="250">PARAMÈTRE</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>--daemon</code></td><td>Démarre UniGetUI réduit dans la zone de notification.</td></tr><tr><td><code>--updateapps</code></td><td>Force l'installation des mises à jour offertes. Conservé pour la compatibilité.</td></tr><tr><td><code>--help</code>, <code>-h</code></td><td>Affiche l'aide de la CLI.</td></tr><tr><td><code>--import-settings &#x3C;file></code></td><td>Importe les paramètres depuis un fichier JSON. Les paramètres existants sont remplacés.</td></tr><tr><td><code>--export-settings &#x3C;file></code></td><td>Exporte les paramètres vers un fichier JSON, en le créant ou en l'écrasant.</td></tr><tr><td><code>--enable-setting &#x3C;key></code>, <code>--disable-setting &#x3C;key></code></td><td>Active ou désactive un paramètre booléen.</td></tr><tr><td><code>--set-setting-value &#x3C;key> &#x3C;value></code></td><td>Définit un paramètre texte.</td></tr><tr><td><code>--enable-secure-setting &#x3C;key></code>, <code>--disable-secure-setting &#x3C;key></code></td><td>Active ou désactive un paramètre sécurisé pour l'utilisateur actuel. Peut exiger des droits d'administrateur.</td></tr><tr><td><code>--enable-secure-setting-for-user &#x3C;user> &#x3C;key></code>, <code>--disable-secure-setting-for-user &#x3C;user> &#x3C;key></code></td><td>Active ou désactive un paramètre sécurisé pour l'utilisateur indiqué. Peut exiger des droits d'administrateur.</td></tr><tr><td><code>--no-corrupt-dialog</code></td><td>Affiche le rapport d'incident détaillé au lieu de la boîte de dialogue simplifiée.</td></tr><tr><td><code>--delete-shortcuts &#x3C;path> [&#x3C;path>...]</code></td><td>Supprime des raccourcis du bureau ou du menu Démarrer, puis quitte. Utilisé en interne pour retirer des raccourcis que l'utilisateur actuel ne peut pas supprimer. Seuls les fichiers <code>.lnk</code> et <code>.url</code> d'un dossier du bureau ou du menu Démarrer sont acceptés.</td></tr><tr><td><code>--migrate-wingetui-to-unigetui</code></td><td>Migre les données et les raccourcis d'une installation WingetUI héritée, puis quitte.</td></tr><tr><td><code>--uninstall-wingetui</code></td><td>Retire l'ancien WingetUI du panneau de notification, puis quitte. Utilisé par le désinstallateur de WingetUI.</td></tr><tr><td><code>&#x3C;bundle-file></code></td><td>Ouvre un lot dans <em><strong>Lots de paquets</strong></em>. Les extensions prises en charge comprennent <code>.ubundle</code>, <code>.json</code>, <code>.yaml</code> et <code>.xml</code>.</td></tr></tbody></table>

## Variables d'environnement

Lues par UniGetUI au démarrage.

<table><thead><tr><th width="250">VARIABLE</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>UNIGETUI_WINGET_CLI</code></td><td>Outil utilisé par le gestionnaire WinGet : <code>default</code>, <code>winget</code> ou <code>pinget</code>. Remplace le paramètre <em><strong>Outil en ligne de commande WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_WINGET_COM</code></td><td>Utilisation de l'API COM WinGet : <code>default</code>, <code>enabled</code> ou <code>disabled</code> (<code>on</code>/<code>off</code>, <code>true</code>/<code>false</code> et <code>1</code>/<code>0</code> fonctionnent aussi). Remplace le paramètre <em><strong>API COM de WinGet</strong></em>.</td></tr><tr><td><code>UNIGETUI_FONT_FAMILY</code></td><td>Réservé à Windows. Famille de polices ajoutée au début de la liste des polices de l'interface. Ignorée lorsque UniGetUI utilise la police système de Windows.</td></tr><tr><td><code>UNIGETUI_FORCE_NATIVE_LINUX_DECORATIONS</code></td><td>Réservé à Linux. Force l'activation (<code>1</code>, <code>true</code>, <code>on</code>, <code>yes</code>, <code>enabled</code>) ou la désactivation (<code>0</code>, <code>false</code>, <code>off</code>, <code>no</code>, <code>disabled</code>) de la barre de titre du gestionnaire de fenêtres, au lieu de la détecter.</td></tr><tr><td><code>UNIGETUI_GITHUB_TOKEN_NAMESPACE</code></td><td>Suffixe ajouté à l'entrée d'identifiants du jeton de sauvegarde GitHub, afin que plusieurs instances de UniGetUI sur un même ordinateur puissent utiliser des comptes GitHub différents.</td></tr><tr><td><code>WEBVIEW2_BROWSER_EXECUTABLE_FOLDER</code></td><td>Réservé à Windows. Dossier d'un runtime WebView2 à version fixe, à utiliser à la place de celui qui est installé.</td></tr><tr><td><code>UNIGETUI_IPC_API_TRANSPORT</code>, <code>UNIGETUI_IPC_API_PORT</code>, <code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Voir <a href="#connection-options">Options de connexion</a>.</td></tr></tbody></table>

## Liens profonds

Sous Windows, une installation ordinaire inscrit le protocole `unigetui://`. Les installations portables ne le font pas.

<table><thead><tr><th width="250">LIEN</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>unigetui://openUniGetUI</code></td><td>Affiche la fenêtre de UniGetUI.</td></tr><tr><td><code>unigetui://openUniGetUIOnUpdatesTab</code></td><td>Affiche UniGetUI dans <em><strong>Mises à jour</strong></em>.</td></tr><tr><td><code>unigetui://updateAll</code></td><td>Met à jour chaque paquet qui a une mise à jour.</td></tr><tr><td><code>unigetui://releaseSelfUpdateLock</code></td><td>Laisse une mise à jour de UniGetUI en attente se poursuivre.</td></tr></tbody></table>

{% hint style="warning" %}
Un lien profond n'agit que lorsque UniGetUI est déjà en cours d'exécution. Si le lien démarre UniGetUI, l'appli s'ouvre normalement et l'action est ignorée. Pour automatiser UniGetUI, utilisez les commandes ci-dessus ou l'[API d'automatisation](/unigetui/fr/reference/ipc-api.md).
{% endhint %}

## Commutateurs de l'installateur

Les commutateurs de l'installateur Windows (installation silencieuse, tous les utilisateurs, portable, omission des dépendances) sont énumérés dans [Installer UniGetUI](/unigetui/fr/reference/installation.md#installer-switches).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/fr/reference/cli.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.