> 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/pour-le-devops-et-les-administrateurs/manage/vaults-and-entries.md).

# Gérer les coffres et les entrées

Sélectionner des espaces de travail et des coffres, trouver des entrées, lire leurs détails, puis créer, mettre à jour, organiser et supprimer des coffres et des entrées avec Devolutions CLI.

Utilisez `devo vault` et `devo entry` pour parcourir votre espace de travail et le garder organisé depuis un terminal ou un script : choisissez le coffre dans lequel vous travaillez, trouvez une entrée, créez-en une, mettez-la à jour, déplacez-la ou supprimez-la. Les commandes sont les mêmes pour chaque type d’espace de travail, mais chaque type permet des modifications différentes. Le tableau à la fin de cette page les résume.

Ces commandes travaillent sur le contexte actuel. Pour vérifier de quel espace de travail il s’agit, exécutez `devo status`. Pour en utiliser un autre pour une seule commande, ajoutez `--context <context-name>`. Consultez [Basculer entre les espaces de travail](/cli/fr/guides/connect/switch-workspaces.md).

## Voir et sélectionner des espaces de travail

`devo workspace list` affiche les espaces de travail que vous pouvez utiliser, avec leur nom, leur ID, leur genre et s’ils sont disponibles. L’espace actuel est marqué avec `*`. `devo workspace current` n’affiche que l’espace actuel.

Sur un profil local Devolutions Remote Desktop Manager, vous pouvez aussi sélectionner, créer et supprimer des espaces de travail :

<table><thead><tr><th width="240">TO</th><th>EXÉCUTION</th></tr></thead><tbody><tr><td>Sélectionner l’espace de travail dans lequel vous travaillez</td><td><code>devo workspace use "&#x3C;workspace-name>"</code><br><br>Utilisez <code>id:&#x3C;workspace-id></code> pour le sélectionner par ID.</td></tr><tr><td>Créer un espace de travail SQLite</td><td><code>devo workspace create "&#x3C;workspace-name>" --passphrase-file &#x3C;passphrase-file> --yes</code><br><br>Le fichier de base de données est <code>&#x3C;workspace-name>.db</code> dans le dossier du profil, à moins que vous ne donniez un autre nom de fichier avec <code>--path</code>. La phrase de passe protège le nouvel espace de travail ; elle peut aussi venir d’une variable d’environnement avec <code>--passphrase-env</code>. Le nouvel espace de travail devient l’espace actuel, à moins que vous n’ajoutiez <code>--no-set-current</code>.</td></tr><tr><td>Supprimer un espace de travail</td><td><code>devo workspace delete id:&#x3C;workspace-id> --yes</code><br><br>Utilisez l’ID exact que <code>devo workspace list</code> affiche. Cela supprime le fichier de base de données de l’espace de travail, et ses fichiers temporaires, du dossier du profil : cela ne peut pas être annulé. Offert sur Windows seulement ; sur macOS et Linux, la commande s’arrête avec <code>sqliteWorkspaceDeleteUnsupported</code>.</td></tr></tbody></table>

## Sélectionner le coffre dans lequel vous travaillez

La plupart des commandes d’entrée utilisent le **coffre actuel**. Sur Devolutions Cloud et Devolutions Server, une commande qui lit des entrées en a besoin d’un : soit un coffre actuel, soit `--vault-name` ou `--vault-id` sur la commande.

1. Listez les coffres que vous pouvez voir :

   ```bash
   devo vault list
   ```
2. Faites de l’un d’eux le coffre actuel :

   ```bash
   devo vault use "<vault-name>"
   ```
3. Vérifiez quel coffre est actuel :

   ```bash
   devo vault current
   ```

Pour travailler dans un autre coffre pour une seule commande sans changer le coffre actuel, ajoutez `--vault-name "<vault-name>"` ou `--vault-id <vault-id>` à cette commande.

Pour voir les détails d’un coffre, exécutez `devo vault get "<vault-name>"`. Sur un profil local, `devo vault settings get` affiche les paramètres racine du coffre actuel (ou du coffre que vous nommez), et `devo vault template list` liste les modèles de coffre.

{% hint style="info" %}
Les commandes sélectionnent un coffre, une entrée, un utilisateur ou un groupe par **nom** par défaut. Quand deux éléments portent le même nom, ou qu’un nom est difficile à saisir, sélectionnez par ID : écrivez `id:<value>` ou ajoutez `--id`. Par exemple, `devo vault use id:<vault-id>`.
{% endhint %}

## Trouver des entrées

Cherchez dans le coffre actuel, ou dans un autre, par texte, type ou dossier :

```bash
devo entry list "<search-text>" --vault-name "<vault-name>"
```

<table><thead><tr><th width="240">OPTION</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>--type</code></td><td>Ne garde qu’un type d’entrée. <code>devo entry types</code> énumère les identifiants de type.</td></tr><tr><td><code>--group</code></td><td>Ne conserve que les entrées sous un chemin de dossier.</td></tr><tr><td><code>--limit</code></td><td>Nombre maximal d’entrées retournées. La valeur par défaut est <code>100</code>.</td></tr><tr><td><code>--smart-folder</code></td><td>Destiné à énumérer les entrées d’un dossier intelligent, mais aucun type d’espace de travail n’évalue les dossiers intelligents : la commande s’arrête avec <code>smartFolderUnavailable</code>. Filtrez plutôt avec <code>--group</code> ou <code>--type</code>.</td></tr></tbody></table>

Pour voir une entrée, utilisez `devo entry get "<entry-name>"`. Aucune des deux commandes n’affiche de valeurs secrètes. Pour utiliser un secret, trouvez sa référence avec `devo entry references` et consultez [Trouver la référence d’un secret](/cli/fr/guides/secrets/find-a-reference.md).

Sur un profil local, `devo entry sealed list` énumère les entrées scellées, avec le même genre de filtres (`--name`, `--type`, `--group`, `--limit`), et `devo entry template list` énumère les modèles d’entrée.

## Lire et modifier les détails d’une entrée

Outre ses secrets, une entrée contient des détails qui ne sont pas secrets : son hôte, son nom d’utilisateur ou son domaine, ses pièces jointes, ses pages de documentation ou ses paramètres de commande. Ces commandes les lisent et les modifient. Aucune d’elles n’affiche une valeur secrète.

**Lire ou modifier un champ.** `devo entry field get` renvoie une seule valeur, ce qui est pratique dans un script :

```bash
devo entry field get "<entry-name>" host
```

Il lit `name`, `type`, `group`, `host`, `username`, `domain`, `port` ou une autre propriété de l’entrée, comme une propriété de métadonnées. Sur Devolutions Server, seuls l’ID, le nom, le type, le dossier et le coffre reviennent : `host` et `username` sont vides. Consultez [Commandes d’entrée](/cli/fr/reference/commands/entries.md#devo-entry-field-get). Pour modifier un champ, utilisez `devo entry field set` avec la nouvelle valeur dans `--value`, ou depuis `--value-env` ou `--value-file` :

```bash
devo entry field set "<entry-name>" host --value <new-host> --yes
```

`devo entry field set` modifie les mêmes champs que `devo entry update` : `host`, `username` et `domain` sur Devolutions Server et un profil local, et `name` sur un profil local seulement. Il refuse `password` : pour changer un mot de passe, utilisez `devo secret set`. Consultez [Mettre à jour un secret depuis un script](/cli/fr/guides/secrets/update-a-secret.md).

**Autres détails d’une entrée**, sur un profil local :

<table><thead><tr><th width="240">TO</th><th>EXÉCUTION</th></tr></thead><tbody><tr><td>Lister les champs de métadonnées</td><td><code>devo entry metadata list "&#x3C;entry-name>"</code><br><br>Vous pouvez aussi sélectionner l’entrée par son chemin : <code>path:&#x3C;entry-path></code>.</td></tr><tr><td>Lister les pièces jointes</td><td><code>devo entry attachment list "&#x3C;entry-name>"</code></td></tr><tr><td>Lire une page de documentation</td><td><code>devo entry documentation list &#x3C;entry-id></code><br><code>devo entry documentation get &#x3C;entry-id> --title "&#x3C;page-title>"</code><br><br>Ces commandes prennent l’ID de l’entrée.</td></tr><tr><td>Renommer une page de documentation</td><td><code>devo entry documentation update &#x3C;entry-id> --title "&#x3C;page-title>" --new-title "&#x3C;new-title>" --yes</code><br><br>Un profil local ne peut pas modifier le contenu d’une page.</td></tr><tr><td>Lister et modifier les paramètres de commande</td><td><code>devo entry parameter list "&#x3C;entry-name>"</code><br><code>devo entry parameter set "&#x3C;entry-name>" --label "&#x3C;label>" --new-label "&#x3C;new-label>" --yes</code><br><br>Sélectionnez le paramètre par <code>--label</code> ou <code>--position</code>. Vous pouvez changer son libellé (<code>--new-label</code>), son type (<code>--type</code> : <code>Text</code>, <code>Secured</code>, <code>EnvironmentVariable</code> ou <code>Unused</code>) ou sa valeur par défaut (<code>--value</code>, <code>--value-env</code> ou <code>--value-file</code>). <code>--include-unused</code> énumère aussi les emplacements de paramètres inutilisés.</td></tr><tr><td>Lister les éléments d’une entrée Liste de mots de passe</td><td><code>devo entry password-list list "&#x3C;entry-name>" --name "&#x3C;item-name>"</code><br><br><code>--name</code> filtre les éléments par nom. Les mots de passe et les champs personnalisés sensibles reviennent vides.</td></tr></tbody></table>

## Créer et mettre à jour des coffres

La création, le renommage et la suppression de coffres sont offerts sur Devolutions Cloud et Devolutions Server.

1. Créer un coffre :

   ```bash
   devo vault create "<vault-name>" --description "<description>" --yes
   ```

   Pour créer plusieurs coffres à la fois, utilisez `devo vault create-many "<name-1>" "<name-2>" --yes`. Devolutions CLI indique lesquels ont été créés et lesquels ont échoué.
2. Renommez un coffre ou changez sa description :

   ```bash
   devo vault update "<vault-name>" --new-name "<new-name>" --description "<description>" --yes
   ```

## Créer et mettre à jour des entrées

La création d’entrées est offerte sur un profil local Devolutions Remote Desktop Manager.

Les deux commandes ci-dessous écrivent dans l’espace de travail local, donc elles ont besoin de sa phrase de passe : passez `--passphrase-file <file>` ou `--passphrase-env <VARIABLE_NAME>`, ou gardez-la dans un fichier `<workspace file>.passphrase` du dossier du profil. Sans l’une d’elles, elles s’arrêtent avec `missingParameter`.

1. Créez l’entrée. Un profil local ne crée que des entrées RDP :

   ```bash
   devo entry create "<entry-name>" --host <host> --username <username> --group "<folder>" --passphrase-file <passphrase-file> --yes
   ```

   L’entrée va dans le coffre par défaut : un profil local crée des entrées seulement là, et un autre `--vault-id` s’arrête avec `sqliteEntryCreateVaultUnsupported`.
2. Définissez son mot de passe à partir d’une variable d’environnement ou d’un fichier, pour que la valeur n’apparaisse jamais sur la ligne de commande :

   ```bash
   devo secret set password "<entry-name>" --value-env <VARIABLE_NAME> --passphrase-file <passphrase-file> --yes
   ```

   Consultez [Mettre à jour un secret depuis un script](/cli/fr/guides/secrets/update-a-secret.md).

Pour modifier une entrée existante, utilisez `devo entry update` avec les champs à modifier :

```bash
devo entry update "<entry-name>" --host <new-host> --username <new-username> --yes
```

Ce que vous pouvez modifier dépend du type d’espace de travail :

* **Profil local** : `--new-name`, `--host`, `--username` et `--domain`. `--host-port` et `--password-secret-reference` sont refusés.
* **Devolutions Server** : `--host`, `--username` et `--domain`.
* **Devolutions Cloud** : seulement le mot de passe, avec `devo secret set`.

## Organiser les entrées

Ces commandes sont offertes sur un profil local.

<table><thead><tr><th width="240">TO</th><th>EXÉCUTION</th></tr></thead><tbody><tr><td>Déplacer des entrées vers un autre dossier</td><td><code>devo entry move --entry-id &#x3C;entry-id> --destination-group "&#x3C;folder>" --yes</code><br><br>Répétez <code>--entry-id</code> pour déplacer plusieurs entrées. Un profil local déplace les entrées dans leur coffre seulement : un <code>--to-vault</code> différent s’arrête avec <code>entryMoveCrossVaultUnsupported</code>. Un <code>--destination-group</code> vide les déplace à la racine du coffre.</td></tr><tr><td>Renommer un dossier</td><td><code>devo entry folder rename "&#x3C;folder-path>" --new-name "&#x3C;new-name>" --yes</code><br><br>Les chemins des entrées à l’intérieur du dossier sont aussi mis à jour.</td></tr><tr><td>Définir l’état d’une entrée</td><td><code>devo entry status set "&#x3C;entry-name>" --status Locked --message "&#x3C;reason>" --yes</code><br><br>Valeurs d’état : <code>Archived</code>, <code>Broken</code>, <code>Default</code>, <code>Disabled</code>, <code>Expired</code>, <code>Locked</code> ou <code>Warning</code>.<br><br>Pour sélectionner l’entrée par ID avec cette commande et <code>devo entry tag set</code>, ajoutez <code>--id</code> : ces deux commandes ne reconnaissent pas le préfixe <code>id:</code>.</td></tr><tr><td>Remplacer les étiquettes d’une entrée</td><td><code>devo entry tag set "&#x3C;entry-name>" --tag &#x3C;tag-1> --tag &#x3C;tag-2> --yes</code><br><br>Les étiquettes que vous passez remplacent celles qui existent. Utilisez <code>--clear</code> pour toutes les retirer.</td></tr></tbody></table>

Pour les relire, utilisez `devo entry status get` et `devo entry tag list`. Ces deux commandes s’arrêtent avec `entryFieldNotFound` quand l’entrée n’a pas d’état ou pas d’étiquettes, et toujours sur Devolutions Cloud et Devolutions Server, qui ne les retournent pas. Pour voir les entrées qui ont été supprimées, utilisez `devo entry trash list`, avec `--before <date>` pour ne voir que celles supprimées avant une date.

## Supprimer des entrées et des coffres

{% hint style="danger" %}
`--yes` est la seule confirmation que Devolutions CLI demande. Vérifiez le nom ou l’ID avant de supprimer quoi que ce soit, surtout dans un script, et préférez les ID aux noms.
{% endhint %}

La suppression d’entrées et de coffres est offerte sur Devolutions Cloud et Devolutions Server.

**Supprimer une entrée :**

```bash
devo entry delete "<entry-name>" --yes
```

Sur Devolutions Cloud, supprimer une entrée supprime aussi les entrées qu’elle contient. Devolutions CLI refuse de le faire tant que vous n’ajoutez pas `--acknowledge-recursive-scope`, ce qui montre que vous le savez.

**Supprimer un coffre :**

```bash
devo vault delete id:<vault-id> --yes
```

Sur Devolutions Cloud, sélectionnez le coffre par son ID : un nom de coffre ou le coffre actuel n’est pas accepté. Le coffre va à la corbeille, sauf si vous ajoutez `--permanently`.

## Ce que chaque type d’espace de travail peut faire

<table><thead><tr><th width="260">TÂCHE</th><th>PROFIL LOCAL</th><th>DEVOLUTIONS CLOUD</th><th>DEVOLUTIONS SERVER</th></tr></thead><tbody><tr><td>Lister les espaces de travail, afficher l’espace actuel</td><td>Oui</td><td>Oui</td><td>Oui</td></tr><tr><td>Sélectionner, créer et supprimer des espaces de travail</td><td>Oui</td><td>No</td><td>No</td></tr><tr><td>Lister et sélectionner des coffres</td><td>Oui</td><td>Oui</td><td>Oui</td></tr><tr><td>Créer, renommer et supprimer des coffres</td><td>No</td><td>Oui</td><td>Oui</td></tr><tr><td>Lister, rechercher et obtenir des entrées</td><td>Oui</td><td>Oui</td><td>Oui</td></tr><tr><td>Créer des entrées</td><td>Entrées RDP</td><td>No</td><td>No</td></tr><tr><td>Lire un champ (<code>devo entry field get</code>)</td><td>Oui</td><td>Oui</td><td>ID, nom, type, dossier et coffre seulement</td></tr><tr><td>Mettre à jour des entrées (<code>devo entry update</code>, <code>devo entry field set</code>)</td><td>Oui*</td><td>Non (mot de passe avec <code>devo secret set</code>)</td><td>Hôte, nom d’utilisateur, domaine</td></tr><tr><td>Métadonnées, pièces jointes, documentation, paramètres de commande, éléments de Liste de mots de passe</td><td>Oui*</td><td>No</td><td>No</td></tr><tr><td>Déplacer des entrées, renommer des dossiers</td><td>Oui*</td><td>No</td><td>No</td></tr><tr><td>Lire et définir l’état et les étiquettes</td><td>Oui*</td><td>No</td><td>No</td></tr><tr><td>Supprimer des entrées</td><td>No</td><td>Oui, avec <code>--acknowledge-recursive-scope</code></td><td>Oui</td></tr><tr><td>Lister les entrées supprimées</td><td>Oui</td><td>No</td><td>No</td></tr></tbody></table>

\* Quand le profil le permet. `devo doctor` énumère les opérations que l’espace de travail sélectionné prend en charge. Si une modification n’est pas offerte sur votre profil, faites-la dans Devolutions Remote Desktop Manager.

## Bon à savoir

* `--yes` confirme la modification. Sans elle, la commande ne change rien et s’arrête avec `confirmationRequired`. Consultez [Exécuter sans invites](/cli/fr/pour-le-devops-et-les-administrateurs/automate/non-interactive.md).
* Ajoutez `--output json` pour obtenir un résultat qu’un script peut lire. Consultez [Lire les résultats en JSON](/cli/fr/pour-le-devops-et-les-administrateurs/automate/json-output.md).
* Une commande s’arrête avec `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) ou un autre code qui indique que le profil local ne peut pas le faire ? L’espace de travail sélectionné ne peut pas faire cette modification. Consultez [Une commande indique que l’espace de travail ne la prend pas en charge](/cli/fr/aide/troubleshooting/not-supported.md).

## Suivant

* [Manage users, groups, and access](/cli/fr/pour-le-devops-et-les-administrateurs/manage/users-and-access.md)
* [Review activity logs](/cli/fr/pour-le-devops-et-les-administrateurs/manage/logs.md)
* [Commands](/cli/fr/reference/commands.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/pour-le-devops-et-les-administrateurs/manage/vaults-and-entries.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.