> 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/cli/fr/reference/commands/workspaces-vaults-variables.md).

# Commandes d’espace de travail, de coffre et de variable

Chaque commande devo workspace, devo vault et devo variable, avec chaque option, sa valeur par défaut, ses valeurs permises et les types d’espace de travail qui l’acceptent.

Cette page décrit chaque commande `devo workspace`, `devo vault` et `devo variable`, et chaque option que vous pouvez saisir avec elle. Pour la liste courte de toutes les commandes, consultez [Commandes](/cli/fr/reference/commands.md). Pour une aide étape par étape, consultez [Gérer les coffres et les entrées](/cli/fr/pour-le-devops-et-les-administrateurs/manage/vaults-and-entries.md) et [Utiliser des variables personnalisées](/cli/fr/pour-le-devops-et-les-administrateurs/manage/custom-variables.md). Les options que chaque commande accepte, comme `--context`, `--output json` ou `--non-interactive`, sont décrites dans [Options globales](/cli/fr/reference/global-options.md) et ne sont pas répétées ici. Pour les commandes d’entrée, consultez [Commandes d’entrée](/cli/fr/reference/commands/entries.md).

{% hint style="info" %}
Pour voir l’aide d’une commande, avec son libellé exact, exécutez `devo <command> --help`, par exemple `devo vault list --help`.
{% endhint %}

## Fonctionnement de ces commandes

* **Sélection d’un espace de travail ou d’un coffre** : les commandes prennent son **nom** par défaut, comparé exactement, sans tenir compte de la casse. Pour passer un ID à la place, écrivez `id:<value>` ou ajoutez `--id`. `name:<value>` force un nom. Les exceptions sont indiquées sous chaque commande, comme `devo workspace delete`, qui exige l’ID exact de l’espace de travail.
* **Espace de travail actuel et coffre actuel** : la plupart des commandes travaillent dans l’espace de travail actuel et le coffre actuel. Définissez-les avec `devo workspace use` et `devo vault use`. Pour utiliser un autre contexte pour une commande, ajoutez `--context <name>`. Consultez [Basculer entre les espaces de travail](/cli/fr/guides/connect/switch-workspaces.md).
* **Confirmation d’une modification** : chaque commande qui crée, modifie ou supprime quelque chose refuse de s’exécuter sans `--yes` (alias `-y` et `--confirmed`) et s’arrête avec `confirmationRequired`. Rien n’est modifié.
* **Types d’espaces de travail** : une commande que l’espace de travail sélectionné ne prend pas en charge s’arrête avec `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) ou avec un code qui indique que le profil local ne peut pas le faire. Consultez [Une commande indique que l’espace de travail ne la prend pas en charge](/cli/fr/aide/troubleshooting/not-supported.md).

## Groupes de commandes

<table><thead><tr><th width="300">GROUPE</th><th>COMMANDES</th></tr></thead><tbody><tr><td><code>devo workspace</code></td><td><code>list</code> (<code>ls</code>), <code>current</code>, <code>use</code>, <code>create</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo workspace variable</code></td><td><code>list</code> (<code>ls</code>), <code>set</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo vault</code></td><td><code>list</code> (<code>ls</code>), <code>get</code>, <code>current</code>, <code>use</code>, <code>create</code>, <code>create-many</code>, <code>update</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo vault settings</code></td><td><code>get</code></td></tr><tr><td><code>devo vault template</code></td><td><code>list</code> (<code>ls</code>)</td></tr><tr><td><code>devo vault access</code></td><td><code>list</code> (<code>ls</code>), <code>grant</code>, <code>revoke</code> (<code>rm</code>)</td></tr><tr><td><code>devo vault variable</code></td><td><code>list</code> (<code>ls</code>), <code>set</code>, <code>delete</code> (<code>rm</code>)</td></tr><tr><td><code>devo variable</code></td><td><code>export</code></td></tr></tbody></table>

## devo workspace list

Liste les espaces de travail que vous pouvez utiliser, avec leur nom, leur ID, leur type, et si chacun est disponible, s’il est l’actuel et s’il est celui par défaut. L’espace de travail actuel est marqué avec `*`. Un nouveau profil local sans aucun espace de travail retourne une liste vide. Alias : `devo workspace ls`.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo workspace list
```

Cette commande n’a pas d’option qui lui soit propre.

## devo workspace current

Affiche l’espace de travail actuel.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo workspace current
```

Cette commande n’a pas d’option qui lui soit propre.

## devo workspace use

Fait d’un espace de travail l’espace actuel.

**Espace de travail :** Profil local

```bash
devo workspace use <workspace> [--id] [--password-env <variable>]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Obligatoire. Nom de l’espace de travail, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>. Un espace de travail inconnu s’arrête avec <code>workspaceNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;workspace></code> comme un ID.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Variable d’environnement qui contient le mot de passe de l’espace de travail. Quand vous la passez, la variable doit exister, sinon la commande s’arrête avec <code>invalidParameterValue</code>. Un profil local n’a pas besoin d’un mot de passe pour sélectionner un espace de travail.</td></tr></tbody></table>

Sur Devolutions Cloud et Devolutions Server, la commande s’arrête avec `operationNotSupportedBySource` : sélectionnez un autre espace de travail avec `--context` ou `devo context use`.

## devo workspace create

Crée un espace de travail SQLite dans le dossier du profil local et, sauf si vous ajoutez `--no-set-current`, le rend actuel. La phrase de passe que vous donnez protège le nouvel espace de travail.

**Espace de travail :** Profil local

```bash
devo workspace create <name> (--passphrase-file <file> | --passphrase-env <variable>) [--path <file-name>] [--no-set-current] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatoire. Nom de l’espace de travail. Sans <code>--path</code>, c’est aussi le nom du fichier de base de données.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td><code>sqlite</code></td><td>Type d’espace de travail. Un profil local ne crée que des espaces de travail <code>sqlite</code> ; tout autre type s’arrête avec <code>operationNotSupportedBySource</code>.</td></tr><tr><td><code>--path &#x3C;file-name></code></td><td><code>&#x3C;name>.db</code></td><td>Nom de fichier de la base de données, créé dans le dossier de profil. Passez un nom de fichier, pas un chemin avec des dossiers : un chemin s’arrête avec <code>invalidParameterValue</code>. <code>.db</code> est ajouté si le nom ne se termine pas par lui.</td></tr><tr><td><code>--passphrase-file &#x3C;file></code></td><td></td><td>Fichier privé qui contient la phrase de passe qui protège le nouvel espace de travail. Devolutions Cloud et Devolutions Server refusent cette option.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Variable d’environnement qui contient la phrase de passe qui protège le nouvel espace de travail. Devolutions Cloud et Devolutions Server refusent cette option.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Variable d’environnement qui contient le matériel de mot de passe de l’espace de travail. Un profil local la refuse : utilisez <code>--passphrase-file</code> ou <code>--passphrase-env</code>.</td></tr><tr><td><code>--no-set-current</code></td><td>Désactivé</td><td>Crée l’espace de travail sans en faire l’espace actuel.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la création. Obligatoire.</td></tr></tbody></table>

Sur un profil local, passez exactement un de `--passphrase-file` et `--passphrase-env`. Sans aucun des deux, ou avec les deux, la commande s’arrête avec `invalidParameterValue`. Sur Devolutions Cloud et Devolutions Server, la commande s’arrête avec `operationNotSupportedBySource`, avec ou sans `--password-env`.

## devo workspace delete

Supprime un espace de travail SQLite du profil local : son fichier de base de données et ses fichiers temporaires sont supprimés du dossier de profil. Cela ne peut pas être annulé. Alias : `devo workspace rm`.

Disponible sur Windows seulement. Sur macOS et Linux, la commande s’arrête avec `sqliteWorkspaceDeleteUnsupported` (code de sortie `3`).

**Espace de travail :** Profil local

```bash
devo workspace delete <workspace-id> --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Obligatoire. L’ID exact d’espace de travail que <code>devo workspace list</code> affiche, comme <code>sqlite:Connections.db</code>, avec ou sans le préfixe <code>id:</code>. Un nom d’espace de travail n’est pas accepté.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;workspace></code> comme un ID. Inutile quand vous passez l’ID <code>sqlite:</code>.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la suppression. Obligatoire.</td></tr></tbody></table>

## devo workspace variable list

Énumère les variables personnalisées de l’espace de travail actuel, avec leur nom, leur valeur, leur portée, leur source et leur description. Les valeurs sont affichées en texte clair, sauf pour les variables dont le nom, ou l’un des champs stockés, contient `password`, `secret`, `token`, `encrypt`, `protected` ou `safevalue` : leur valeur revient vide et elles sont marquées `redacted`. Alias : `devo workspace variable ls`.

**Espace de travail :** Profil local

```bash
devo workspace variable list [<name>]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Toutes les variables</td><td>Filtre de nom facultatif, sans tenir compte de la casse. <code>*</code> correspond à n’importe quel texte et <code>?</code> à un caractère. Sans caractère générique, le nom doit correspondre exactement. Les délimiteurs <code>$</code> sont facultatifs.</td></tr></tbody></table>

## devo workspace variable set

Crée une variable personnalisée de l’espace de travail actuel, ou la met à jour si elle existe. La valeur vient d’une variable d’environnement ou d’un fichier, jamais de la ligne de commande.

**Espace de travail :** Profil local

```bash
devo workspace variable set <name> (--value-env <variable> | --value-file <file>) [--description <text>] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatoire. Nom de variable : lettres, chiffres et traits de soulignement seulement. Les délimiteurs <code>$</code> sont facultatifs ; le nom est enregistré en majuscules, entre des signes <code>$</code>.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Variable d’environnement qui contient la valeur. La variable doit exister.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>Fichier qui contient la valeur. Tout le contenu est utilisé tel quel, y compris un saut de ligne final.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Inchangé</td><td>Description de la variable. Sans elle, une description existante est conservée.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la modification. Obligatoire.</td></tr></tbody></table>

Passez exactement un de `--value-env` et `--value-file` : les deux arrêtent la commande avec `conflictingOptions`, aucun des deux avec `missingParameter`. Définir de nouveau la même valeur et la même description arrête la commande avec `sqliteVariableUpdateNoChanges`. Les modifications exigent une base de données locale non chiffrée.

## devo workspace variable delete

Supprime les variables personnalisées de l’espace de travail actuel. Alias : `devo workspace variable rm`.

**Espace de travail :** Profil local

```bash
devo workspace variable delete <name> [<name>…] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obligatoire. Un ou plusieurs noms de variable. Si un nom n’existe pas, ou apparaît deux fois, la commande échoue et ne supprime rien.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la suppression. Obligatoire.</td></tr></tbody></table>

## devo vault list

Liste les coffres de l’espace de travail actuel, avec leur nom, leur ID et leur type. Le coffre actuel est marqué. Alias : `devo vault ls`.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo vault list [<vault>] [--id]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Tous les coffres</td><td>Facultatif. Ne garde que le coffre de ce nom, ou de cet ID avec <code>id:&#x3C;value></code> ou <code>--id</code>. Le nom est comparé exactement, sans tenir compte de la casse, sur chaque type d’espace de travail. Sur Devolutions Cloud et Devolutions Server, les coffres sont triés par nom.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr></tbody></table>

## devo vault get

Affiche un coffre.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo vault get <vault> [--id]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>. Le nom est comparé exactement, sans tenir compte de la casse, sur chaque type d’espace de travail. Quand aucun coffre ne correspond, la commande s’arrête avec <code>vaultNotFound</code> ; quand plusieurs coffres portent le même nom, avec <code>vaultSelectorAmbiguous</code> : utilisez l’ID.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr></tbody></table>

## devo vault current

Affiche le coffre actuel.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo vault current
```

Cette commande n’a pas d’option qui lui soit propre.

## devo vault use

Fait d’un coffre le coffre actuel. Les commandes d’entrée travaillent ensuite dans ce coffre, sauf si vous passez `--vault-name` ou `--vault-id`.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo vault use <vault> [--id]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>. Le nom est comparé exactement, sans tenir compte de la casse, sur chaque type d’espace de travail. Quand plusieurs coffres portent le même nom, le premier trouvé devient le coffre actuel : utilisez l’ID pour être certain. Un coffre inconnu arrête la commande avec <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr></tbody></table>

## devo vault create

Crée un coffre.

**Espace de travail :** Devolutions Cloud, Devolutions Server

```bash
devo vault create <name> [--description <text>] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatoire. Nom du nouveau coffre. Un nom vide s’arrête avec <code>missingParameter</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Description du nouveau coffre.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la création. Obligatoire.</td></tr></tbody></table>

## devo vault create-many

Crée plusieurs coffres en une seule commande, l’un après l’autre, et indique pour chaque nom s’il a été créé ou s’il a échoué.

**Espace de travail :** Devolutions Cloud, Devolutions Server

```bash
devo vault create-many <name> [<name>…] [--description <text>] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obligatoire. Un ou plusieurs noms de coffre.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Description donnée à chaque coffre créé.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la création. Obligatoire.</td></tr></tbody></table>

Un échec n’arrête pas les autres. Quand certains coffres ont été créés et d’autres non, le résultat dit `partialFailure` ; quand aucun n’a été créé, `vaultCreateFailed`.

## devo vault update

Renomme un coffre ou change sa description.

**Espace de travail :** Devolutions Cloud, Devolutions Server

```bash
devo vault update <vault> [--new-name <name>] [--description <text>] [--id] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr><tr><td><code>--new-name &#x3C;name></code></td><td>Inchangé</td><td>Nouveau nom de coffre.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Inchangé</td><td>Nouvelle description du coffre. Une valeur vide est ignorée, donc cette commande ne peut pas effacer une description.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la modification. Obligatoire.</td></tr></tbody></table>

Passez au moins l’un de `--new-name` et `--description`, sinon la commande s’arrête avec `missingParameter`.

## devo vault delete

Supprime un coffre. Alias : `devo vault rm`.

**Espace de travail :** Devolutions Cloud, Devolutions Server

```bash
devo vault delete id:<vault-id> [--permanently] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>. Sur Devolutions Cloud, seul l’ID est accepté : un nom s’arrête avec <code>cloudVaultCanonicalIdRequired</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr><tr><td><code>--permanently</code></td><td>Désactivé</td><td>Devolutions Cloud : supprime le coffre de façon permanente au lieu de le déplacer vers la corbeille. Ignoré par Devolutions Server.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la suppression. Obligatoire.</td></tr></tbody></table>

## devo vault settings get

Affiche les paramètres racine du coffre actuel, ou du coffre que vous nommez : description, entrée racine et mode de configuration des étiquettes. Le résultat est en lecture seule.

**Espace de travail :** Profil local

```bash
devo vault settings get [<vault>] [--id]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Coffre actuel</td><td>Facultatif. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr></tbody></table>

Cette commande ne fonctionne que lorsque le profil l’autorise.

## devo vault template list

Liste les modèles de coffre du profil, avec leur nom et leur ID. Alias : `devo vault template ls`.

**Espace de travail :** Profil local

```bash
devo vault template list [--vault-name <template-name> | --vault-id <template-id>]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>--vault-id &#x3C;id></code></td><td>Tous les modèles</td><td>Conserve le modèle de coffre qui a cet ID. La valeur est comparée aux modèles, pas à vos coffres.</td></tr><tr><td><code>--vault-name &#x3C;name></code></td><td>Tous les modèles</td><td>Conserve le modèle de coffre de ce nom, sans tenir compte de la casse. Ignoré quand <code>--vault-id</code> est donné.</td></tr></tbody></table>

## devo vault access list

Liste les utilisateurs et les groupes qui ont accès à un coffre, avec leur rôle. Alias : `devo vault access ls`.

**Espace de travail :** Devolutions Cloud

```bash
devo vault access list <vault> [--id] [--user <user> | --group <group>] [--case-sensitive]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td>Tout le monde</td><td>Ne conserve qu’un utilisateur : nom par défaut, ou <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> ou <code>email:&#x3C;value></code>. Un GUID seul est lu comme un ID.</td></tr><tr><td><code>--group &#x3C;group></code></td><td>Tout le monde</td><td>Conserve un groupe d’utilisateurs : le nom par défaut, ou <code>id:&#x3C;value></code> ou <code>name:&#x3C;value></code>. Un GUID seul est lu comme un ID.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Conserve une identité d’application. Devolutions Cloud la refuse avec <code>cloudVaultAccessApplicationUnsupported</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Désactivé</td><td>Compare les noms et les courriels en tenant compte de la casse. Par défaut, la casse n’a pas d’importance. Un nom d’utilisateur correspond au nom d’utilisateur ou au nom affiché ; un courriel correspond au courriel ou au courriel de connexion ; un nom de groupe correspond au nom du groupe.</td></tr></tbody></table>

Utilisez au plus l’un de `--user`, `--group` et `--application`, sinon la commande s’arrête avec `conflictingOptions`.

## devo vault access grant

Donne à un utilisateur ou à un groupe un rôle sur un coffre.

**Espace de travail :** Devolutions Cloud

```bash
devo vault access grant <vault> (--user <user> | --group <group>) --role <role> [--id] [--case-sensitive] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Utilisateur qui reçoit le rôle : nom par défaut, ou <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> ou <code>email:&#x3C;value></code>. Un GUID seul est lu comme un ID.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Groupe d’utilisateurs qui reçoit le rôle : le nom par défaut, ou <code>id:&#x3C;value></code> ou <code>name:&#x3C;value></code>. Un GUID seul est lu comme un ID.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Identité d’application qui reçoit le rôle. Devolutions Cloud la refuse avec <code>cloudVaultAccessPrincipalUnsupported</code>.</td></tr><tr><td><code>--role &#x3C;role></code></td><td></td><td>Rôle de coffre, par nom ou par ID, sans tenir compte de la casse : <code>Restricted</code>, <code>Readers</code>, <code>PrivilegedReaders</code>, <code>Operators</code>, <code>PrivilegedOperators</code>, <code>Contributors</code> ou <code>VaultOwners</code>. Un rôle inconnu arrête la commande avec <code>cloudVaultRoleNotFound</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Désactivé</td><td>Compare les noms et les courriels en tenant compte de la casse. Par défaut, la casse n’a pas d’importance. Un nom d’utilisateur correspond au nom d’utilisateur ou au nom affiché ; un courriel correspond au courriel ou au courriel de connexion ; un nom de groupe correspond au nom du groupe.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la modification. Obligatoire.</td></tr></tbody></table>

Passez exactement l’un de `--user` et `--group` : aucun s’arrête avec `missingParameter`, plusieurs avec `conflictingOptions`. Quand le nom correspond à plusieurs utilisateurs ou groupes, la commande s’arrête avec `principalAmbiguous` : utilisez l’ID.

## devo vault access revoke

Retire l’accès d’un utilisateur ou d’un groupe à un coffre. Alias : `devo vault access rm`.

**Espace de travail :** Devolutions Cloud

```bash
devo vault access revoke <vault> (--user <user> | --group <group>) [--id] [--case-sensitive] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Obligatoire. Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>&#x3C;vault></code> comme un ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Utilisateur dont l’accès est retiré : nom par défaut, ou <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> ou <code>email:&#x3C;value></code>.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Groupe d’utilisateurs dont l’accès est retiré : le nom par défaut, ou <code>id:&#x3C;value></code> ou <code>name:&#x3C;value></code>.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Identité d’application dont l’accès est retiré. Devolutions Cloud la refuse avec <code>cloudVaultAccessPrincipalUnsupported</code>.</td></tr><tr><td><code>--all</code></td><td>Désactivé</td><td>Retire chaque attribution d’accès du coffre. Ne peut pas être combinée avec <code>--user</code>, <code>--group</code> ou <code>--application</code>. Devolutions Cloud la refuse avec <code>cloudVaultAccessPrincipalUnsupported</code> : révoquez un utilisateur ou un groupe à la fois.</td></tr><tr><td><code>--case-sensitive</code></td><td>Désactivé</td><td>Compare les noms et les courriels en tenant compte de la casse. Par défaut, la casse n’a pas d’importance. Un nom d’utilisateur correspond au nom d’utilisateur ou au nom affiché ; un courriel correspond au courriel ou au courriel de connexion ; un nom de groupe correspond au nom du groupe.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme le retrait. Obligatoire.</td></tr></tbody></table>

## devo vault variable list

Énumère les variables personnalisées du coffre actuel, ou du coffre que vous nommez, avec leur nom, leur valeur, leur portée, leur source et leur description. Les valeurs sont affichées en texte clair, sauf pour les variables dont le nom, ou l’un des champs stockés, contient `password`, `secret`, `token`, `encrypt`, `protected` ou `safevalue` : leur valeur revient vide et elles sont marquées `redacted`. Alias : `devo vault variable ls`.

**Espace de travail :** Profil local

```bash
devo vault variable list [<name>] [--vault <vault>] [--id]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Toutes les variables</td><td>Filtre de nom facultatif, sans tenir compte de la casse. <code>*</code> correspond à n’importe quel texte et <code>?</code> à un caractère. Sans caractère générique, le nom doit correspondre exactement. Les délimiteurs <code>$</code> sont facultatifs.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Coffre actuel</td><td>Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>. Un coffre inconnu s’arrête avec <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>--vault</code> comme un ID.</td></tr></tbody></table>

## devo vault variable set

Crée une variable personnalisée du coffre actuel, ou du coffre que vous nommez, ou la met à jour si elle existe. La valeur vient d’une variable d’environnement ou d’un fichier, jamais de la ligne de commande.

**Espace de travail :** Profil local

```bash
devo vault variable set <name> (--value-env <variable> | --value-file <file>) [--description <text>] [--vault <vault>] [--id] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Obligatoire. Nom de variable : lettres, chiffres et traits de soulignement seulement. Les délimiteurs <code>$</code> sont facultatifs ; le nom est enregistré en majuscules, entre des signes <code>$</code>.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Variable d’environnement qui contient la valeur. La variable doit exister.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>Fichier qui contient la valeur. Tout le contenu est utilisé tel quel, y compris un saut de ligne final.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Inchangé</td><td>Description de la variable. Sans elle, une description existante est conservée.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Coffre actuel</td><td>Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>--vault</code> comme un ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la modification. Obligatoire.</td></tr></tbody></table>

Passez exactement un de `--value-env` et `--value-file` : les deux arrêtent la commande avec `conflictingOptions`, aucun des deux avec `missingParameter`. Définir de nouveau la même valeur et la même description arrête la commande avec `sqliteVariableUpdateNoChanges`. Les modifications exigent une base de données locale non chiffrée.

## devo vault variable delete

Supprime les variables personnalisées du coffre actuel, ou du coffre que vous nommez. Alias : `devo vault variable rm`.

**Espace de travail :** Profil local

```bash
devo vault variable delete <name> [<name>…] [--vault <vault>] [--id] --yes
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Obligatoire. Un ou plusieurs noms de variable. Si un nom n’existe pas, ou apparaît deux fois, la commande échoue et ne supprime rien.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Coffre actuel</td><td>Nom du coffre, ou son ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>--vault</code> comme un ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la suppression. Obligatoire.</td></tr></tbody></table>

## devo variable export

Écrit les variables personnalisées d’une portée dans un fichier JSON. Chaque variable est écrite avec son nom, sa valeur, sa description, sa portée et sa source. Comme avec `list`, une variable dont le nom, ou l’un des champs stockés, contient `password`, `secret`, `token`, `encrypt`, `protected` ou `safevalue` est écrite avec une valeur vide. L’exportation ne fait que lire les variables : elle n’a pas besoin de `--yes`, et elle fonctionne pour chaque portée, y compris celles que vous ne pouvez pas modifier depuis Devolutions CLI. `variable export` est la seule commande `devo variable`.

**Espace de travail :** Profil local

```bash
devo variable export --scope <scope> --out-file <file> [--vault <vault>] [--id] [--name <filter>] [--force]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>--scope &#x3C;scope></code></td><td></td><td>Obligatoire. Quelles variables exporter, sans tenir compte de la casse : <code>workspace</code> (les variables de l’espace de travail actuel), <code>vault</code> (les variables d’un coffre), <code>option</code> (aussi écrit <code>options</code> : les variables enregistrées dans le fichier d’options Devolutions Remote Desktop Manager du profil ; une valeur enregistrée sous forme obscurcie revient vide et est marquée <code>unavailable</code>), ou <code>user-vault</code> (aussi écrit <code>uservault</code> : accepté, mais un profil local n’a pas de variables de coffre utilisateur, le fichier contient donc une liste vide). Toute autre valeur arrête la commande avec <code>invalidVariableScope</code>.</td></tr><tr><td><code>--out-file &#x3C;file></code></td><td></td><td>Obligatoire. Fichier JSON à écrire. Son dossier doit exister (<code>directoryNotFound</code> sinon), et le chemin ne peut pas être un dossier.</td></tr><tr><td><code>--force</code></td><td>Désactivé</td><td>Remplace le fichier s’il existe. Sans cela, un fichier existant arrête la commande avec <code>fileExists</code>.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Coffre actuel</td><td>Pour les portées <code>vault</code> et <code>user-vault</code>, le coffre à exporter : nom, ou ID avec <code>id:&#x3C;value></code> ou <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Désactivé</td><td>Traite <code>--vault</code> comme un ID.</td></tr><tr><td><code>--name &#x3C;filter></code></td><td>Toutes les variables</td><td>Ne conserve que les variables dont le nom correspond, sans tenir compte de la casse. <code>*</code> correspond à n’importe quel texte et <code>?</code> à un caractère.</td></tr></tbody></table>

{% hint style="warning" %}
Le fichier exporté contient les valeurs en texte clair, et Devolutions CLI ne le rend pas privé. Ne le commitez pas, et supprimez-le quand vous n’en avez plus besoin.
{% endhint %}

## Pages connexes

* [Manage vaults and entries](/cli/fr/pour-le-devops-et-les-administrateurs/manage/vaults-and-entries.md)
* [Use custom variables](/cli/fr/pour-le-devops-et-les-administrateurs/manage/custom-variables.md)
* [Manage users, groups, and access](/cli/fr/pour-le-devops-et-les-administrateurs/manage/users-and-access.md)
* [Entry commands](/cli/fr/reference/commands/entries.md)


---

# 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/cli/fr/reference/commands/workspaces-vaults-variables.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.