> 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 Devolutions UniGetUI.

La commande `uniget` contrôle une session Devolutions 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](https://docs.devolutions.net/unigetui/fr/reference/ipc-api.md) locale.

Pour gérer les applis de façon interactive dans un terminal, utilisez plutôt l'[interface de terminal](https://github.com/Devolutions/RDM/tree/master/docs-products/translations/fr/unigetui/reference/terminal-ui.md) (`uniget tui`).

{% hint style="info" %}
Sous Windows, sélectionnez ***Add the uniget command to PATH (reopen terminals after installation)*** pendant l’installation pour exécuter `uniget` depuis n’importe quel dossier, puis ouvrez un nouveau terminal. Sinon, exécutez `.\uniget.exe` depuis le dossier d’installation de Devolutions UniGetUI. Sous macOS, exécutez `/Applications/UniGetUI.app/Contents/MacOS/uniget`. Sous Linux, les paquets `.deb` et `.rpm` ajoutent `uniget` au `PATH` ; depuis une archive extraite, exécutez `./uniget`.
{% endhint %}

## Conditions requises

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

* **Session de bureau** : Devolutions 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** : Devolutions UniGetUI a été démarré avec `--headless`. Dans ce mode, `package show`, `package update-all` et `package update-manager` ne sont pas disponibles.

Si aucune session n’est joignable, la commande se termine avec le code `3`. `uniget status` est l’exception : elle retourne `"running": false` à la place.

Chaque commande écrit son résultat en JSON sur la sortie standard. Une commande en échec écrit `{"status": "error", "message": "..."}`.

## Démarrage rapide

```powershell
uniget status
uniget app status
uniget package search --manager dotnet-tool --query dotnetsay
uniget package install --manager dotnet-tool --id dotnetsay --version 2.1.4 --scope Global
uniget 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`, `folders` pour `folder`, et `log operation` pour `log operations`.
* Une commande qui n’est pas listée sur cette page n’est pas traitée comme une commande de la CLI : Devolutions UniGetUI démarre normalement à la place.
* Les options booléennes prennent une valeur explicite : `--enabled true`, `--wait false`. Ces options sont des indicateurs sans valeur : `--detach`, `--pre-release`, `--confirm`, `--verbose`, `--append`, `--launch-browser`, `--relocate-existing`.
* `--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](https://docs.devolutions.net/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> (<code>pipe</code> et <code>namedpipe</code> fonctionnent aussi).</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, de 1 à 65535. 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, jusqu’à 104 caractères.</td></tr></tbody></table>

Les paramètres du serveur `--ipc-api-transport`, `--ipc-api-port` et `--ipc-api-pipe-name` sont aussi acceptés ici. Avec l’une de ces options ou variables d’environnement, la CLI attend jusqu’à 5 secondes une session correspondante.

## 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>

Une option obligatoire manquante, une valeur non valide ou un délai d’attente de `operation wait` se termine avec le code `2`.

## 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 Devolutions 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 Devolutions 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>, et, avec le Catalogue de logiciels activé, <code>catalog</code> et <code>catalog-editor</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 jusqu’à ce que l’opération réussisse, échoue ou soit annulée. <code>--timeout</code> : 300 secondes par défaut, de 1 à 3600. <code>--delay</code> entre deux vérifications : 1 seconde par défaut, jusqu’à 10.</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. Modes : <code>retry</code> (par défaut), <code>retry-as-admin</code>, <code>retry-interactive</code>, <code>retry-no-hash-check</code>, <code>retry-close-running-app</code>. Les modes disponibles pour une opération sont énumérés dans ses informations.</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. Fonctionne seulement lorsque le paramètre sécurisé <code>AllowCustomManagerPaths</code> est activé.</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, et nécessite <code>--confirm</code> : <code>repair-winget</code> (WinGet), <code>install-scoop</code>, <code>uninstall-scoop</code> et <code>cleanup-scoop</code> (Scoop). <code>manager maintenance</code> énumère les actions d’un 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. Indiquez exactement l’un de <code>--enabled</code> (booléen) ou de <code>--value</code> (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é. Sous Windows, le modifier pour l’utilisateur actuel affiche une invite UAC ; le modifier pour un autre utilisateur nécessite une session qui s’exécute en tant qu’administrateur.</td></tr></tbody></table>

{% hint style="info" %}
Exécutez `uniget settings list` et `uniget settings secure list` pour voir les clés offertes. Chaque clé, sa valeur par défaut et ce qu’elle fait sont décrits dans [Tous les paramètres](https://docs.devolutions.net/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é. Seuls les raccourcis <code>.lnk</code> de Windows sont suivis.</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. Devolutions 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 Devolutions UniGetUI. <code>--level</code> : <code>1</code> erreurs seulement, <code>2</code> ajoute des avertissements, <code>3</code> ajoute des réussites, <code>4</code> ajoute des informations (par défaut), <code>5</code> ajoute des entrées de débogage.</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. <code>--max-results</code> : 50 par défaut, jusqu’à 500.</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. Par défaut, la commande attend la fin de l’opération ; avec <code>--wait false</code> ou <code>--detach</code>, elle 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. Sans <code>--output</code>, il est enregistré dans le dossier défini dans <em><strong>Default location for downloaded installers</strong></em>, ou dans votre dossier <code>Downloads</code>.</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 Devolutions 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 Devolutions UniGetUI avec `--headless` pour exécuter l’API d’automatisation sans fenêtre, par exemple sur un agent de build ou dans un script. La session charge les gestionnaires de paquets et s’exécute jusqu’à `uniget app quit` ou <kbd>Ctrl</kbd>+<kbd>C</kbd>. Parmi les tâches de [maintenance planifiée](https://docs.devolutions.net/unigetui/fr/reference/settings.md#scheduled-maintenance), elle n’exécute que la vérification des mises à jour.

```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>, <code>package update-all</code>, <code>package update-manager</code></td><td>Échec : elles dépendent de la fenêtre. Pour mettre à jour des paquets sans interface, exécutez <code>package update</code> pour chaque paquet.</td></tr></tbody></table>

## Paramètres de démarrage

L'exécutable de Devolutions 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 Devolutions UniGetUI réduit dans la zone de notification. Un fichier de lot passé avec lui est ignoré.</td></tr><tr><td><code>--updateapps</code></td><td>Installe chaque mise à jour offerte dès que la vérification des mises à jour les trouve, indépendamment des paramètres.</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, puis quitte. Les paramètres existants sont d’abord supprimé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, puis quitte.</td></tr><tr><td><code>--enable-setting &#x3C;key></code>, <code>--disable-setting &#x3C;key></code></td><td>Définit une clé de paramètre sur <code>true</code> ou <code>false</code>, puis quitte. Tenez compte des clés marquées <em>(inversé)</em> dans <a href="https://docs.devolutions.net/unigetui/fr/reference/settings.md">Tous les paramètres</a>.</td></tr><tr><td><code>--set-setting-value &#x3C;key> &#x3C;value></code></td><td>Définit un paramètre texte, puis quitte.</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, puis quitte. Sous Windows, affiche une invite UAC.</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é, puis quitte. Prend le nom enregistré du paramètre tel que l’énumère <code>uniget settings secure list</code>, par exemple <code>AllowPrePostInstallCommands</code> plutôt que <code>AllowPrePostOpCommand</code>. Sous Windows, nécessite des droits d’administrateur.</td></tr><tr><td><code>--no-corrupt-dialog</code></td><td>Réservé à Windows. Lorsque des fichiers de l’installation manquent, affiche le rapport de plantage 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>, <code>--uninstall-unigetui</code></td><td>Quitte immédiatement sans ouvrir Devolutions UniGetUI. Conservé pour les désinstallateurs des versions antérieures.</td></tr><tr><td><code>&#x3C;bundle-file></code></td><td>Ouvre un lot dans <em><strong>Lots de paquets</strong></em>. Extensions prises en charge : <code>.ubundle</code>, <code>.json</code>, <code>.yaml</code> et <code>.xml</code>. Si plusieurs lots sont indiqués, seul le premier s’ouvre.</td></tr></tbody></table>

Les paramètres qui règlent un paramètre attendent la clé avec sa casse exacte. Ils retournent ces codes de sortie, que `uniget` transmet :

<table><thead><tr><th width="250">RÉSULTAT</th><th>WINDOWS</th><th>MACOS, LINUX ET INTERFACE DE TERMINAL</th></tr></thead><tbody><tr><td>Succès</td><td><code>0</code></td><td><code>0</code></td></tr><tr><td>Échec</td><td><code>-1</code></td><td><code>1</code></td></tr><tr><td>Valeur de paramètre manquante</td><td><code>-1073741811</code></td><td><code>2</code></td></tr><tr><td>Fichier non trouvé (<code>--import-settings</code>)</td><td><code>-1073741809</code></td><td><code>3</code></td></tr><tr><td>Clé de paramètre inconnue</td><td><code>-2</code></td><td><code>4</code></td></tr></tbody></table>

## Variables d'environnement

Lues par Devolutions 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>Famille de polices ajoutée au début de la liste des polices de l’interface, sur toutes les plateformes. Ignorée sous Windows et Linux lorsque le paramètre de police système de <em><strong>Paramètres de l'interface utilisateur</strong></em> est activé.</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 Devolutions UniGetUI sur un même ordinateur puissent utiliser des comptes GitHub différents.</td></tr><tr><td><code>UNIGETUI_TUI_FAKE_DATA</code></td><td><code>1</code> ou <code>true</code> démarre l’<a href="https://github.com/Devolutions/RDM/tree/master/docs-products/translations/fr/unigetui/reference/terminal-ui.md">interface de terminal</a> en mode de démonstration, comme <code>--fake-data</code>.</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, et macOS et Linux n’ont pas de protocole `unigetui://`. Les actions de notification utilisent ces liens pour atteindre l’appli en cours d’exécution.

<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 Devolutions UniGetUI.</td></tr><tr><td><code>unigetui://openUniGetUIOnUpdatesTab</code></td><td>Affiche Devolutions 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 Devolutions UniGetUI en attente se poursuivre.</td></tr></tbody></table>

{% hint style="warning" %}
Un lien profond n'agit que lorsque Devolutions UniGetUI est déjà en cours d'exécution. Si le lien démarre Devolutions UniGetUI, l'appli s'ouvre normalement et l'action est ignorée. Pour automatiser Devolutions UniGetUI, utilisez les commandes ci-dessus ou l'[API d'automatisation](https://docs.devolutions.net/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 Devolutions UniGetUI](https://docs.devolutions.net/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.
