> 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/de/fur-devops-und-administratoren/manage/vaults-and-entries.md).

# Tresore und Einträge verwalten

Workspaces und Tresore auswählen, Einträge finden, ihre Details lesen und Tresore und Einträge mit Devolutions CLI erstellen, aktualisieren, organisieren und löschen.

Verwenden Sie `devo vault` und `devo entry`, um Ihren Workspace von einem Terminal oder einem Skript aus zu durchsuchen und geordnet zu halten: Wählen Sie den Tresor, in dem Sie arbeiten, finden Sie einen Eintrag, erstellen Sie einen, aktualisieren Sie ihn, verschieben Sie ihn oder löschen Sie ihn. Die Befehle sind für jeden Workspace-Typ dieselben, aber jeder Typ erlaubt andere Änderungen. Die Tabelle am Ende dieser Seite fasst sie zusammen.

Diese Befehle arbeiten mit dem aktuellen Kontext. Um zu prüfen, welcher Workspace das ist, führen Sie `devo status` aus. Um für einen einzelnen Befehl einen anderen zu verwenden, fügen Sie `--context <context-name>` hinzu. Siehe [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md).

## Workspaces anzeigen und auswählen

`devo workspace list` zeigt die Workspaces, die Sie verwenden können, mit Name, ID, Art und ob sie verfügbar sind. Der aktuelle ist mit `*` markiert. `devo workspace current` zeigt nur den aktuellen.

In einem lokalen Profil von Devolutions Remote Desktop Manager können Sie auch Workspaces auswählen, erstellen und löschen:

<table><thead><tr><th width="240">TO</th><th>AUSFÜHREN</th></tr></thead><tbody><tr><td>Den Workspace auswählen, in dem Sie arbeiten</td><td><code>devo workspace use "&#x3C;workspace-name>"</code><br><br>Verwenden Sie <code>id:&#x3C;workspace-id></code>, um ihn nach ID auszuwählen.</td></tr><tr><td>Einen SQLite-Workspace erstellen</td><td><code>devo workspace create "&#x3C;workspace-name>" --passphrase-file &#x3C;passphrase-file> --yes</code><br><br>Die Datenbankdatei ist <code>&#x3C;workspace-name>.db</code> im Profilordner, sofern Sie nicht mit <code>--path</code> einen anderen Dateinamen angeben. Die Passphrase schützt den neuen Workspace; sie kann auch aus einer Umgebungsvariable mit <code>--passphrase-env</code> kommen. Der neue Workspace wird der aktuelle, sofern Sie nicht <code>--no-set-current</code> hinzufügen.</td></tr><tr><td>Einen Workspace löschen</td><td><code>devo workspace delete id:&#x3C;workspace-id> --yes</code><br><br>Verwenden Sie die genaue ID, die <code>devo workspace list</code> anzeigt. Das löscht die Datenbankdatei des Workspace und ihre temporären Dateien aus dem Profilordner: Es kann nicht rückgängig gemacht werden. Nur unter Windows verfügbar; unter macOS und Linux stoppt der Befehl mit <code>sqliteWorkspaceDeleteUnsupported</code>.</td></tr></tbody></table>

## Den Tresor auswählen, in dem Sie arbeiten

Die meisten Eintragsbefehle verwenden den **aktuellen Tresor**. Auf Devolutions Cloud und Devolutions Server braucht ein Befehl, der Einträge liest, einen: entweder einen aktuellen Tresor oder `--vault-name` oder `--vault-id` am Befehl.

1. Listen Sie die Tresore auf, die Sie sehen können:

   ```bash
   devo vault list
   ```
2. Machen Sie einen von ihnen zum aktuellen Tresor:

   ```bash
   devo vault use "<vault-name>"
   ```
3. Prüfen Sie, welcher Tresor aktuell ist:

   ```bash
   devo vault current
   ```

Um für einen Befehl in einem anderen Tresor zu arbeiten, ohne den aktuellen zu ändern, fügen Sie `--vault-name "<vault-name>"` oder `--vault-id <vault-id>` zu diesem Befehl hinzu.

Um die Details eines Tresors zu sehen, führen Sie `devo vault get "<vault-name>"` aus. Bei einem lokalen Profil zeigt `devo vault settings get` die Stammeinstellungen des aktuellen Tresors (oder des Tresors, den Sie nennen), und `devo vault template list` listet die Tresovorlagen auf.

{% hint style="info" %}
Befehle wählen standardmäßig einen Tresor, einen Eintrag, einen Benutzer oder eine Gruppe nach **Name**. Wenn zwei Elemente denselben Namen haben oder ein Name schwer zu tippen ist, wählen Sie nach ID: Schreiben Sie `id:<value>` oder fügen Sie `--id` hinzu. Zum Beispiel `devo vault use id:<vault-id>`.
{% endhint %}

## Einträge finden

Suchen Sie im aktuellen Tresor oder in einem anderen, nach Text, Typ oder Ordner:

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

<table><thead><tr><th width="240">OPTION</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>--type</code></td><td>Behält nur einen Eintragstyp. <code>devo entry types</code> listet die Typbezeichner auf.</td></tr><tr><td><code>--group</code></td><td>Behält nur die Einträge unter einem Ordnerpfad.</td></tr><tr><td><code>--limit</code></td><td>Maximale Anzahl zurückgegebener Einträge. Der Standard ist <code>100</code>.</td></tr><tr><td><code>--smart-folder</code></td><td>Soll die Einträge eines intelligenten Ordners auflisten, aber kein Workspace-Typ wertet intelligente Ordner aus: Der Befehl stoppt mit <code>smartFolderUnavailable</code>. Filtern Sie stattdessen mit <code>--group</code> oder <code>--type</code>.</td></tr></tbody></table>

Um einen Eintrag anzuzeigen, verwenden Sie `devo entry get "<entry-name>"`. Keiner der beiden Befehle zeigt geheime Werte. Um ein Geheimnis zu verwenden, finden Sie seine Referenz mit `devo entry references` und siehe [Die Referenz zu einem Geheimnis finden](/cli/de/anleitungen/secrets/find-a-reference.md).

Bei einem lokalen Profil listet `devo entry sealed list` die versiegelten Einträge auf, mit derselben Art von Filtern (`--name`, `--type`, `--group`, `--limit`), und `devo entry template list` listet die Eintragsvorlagen auf.

## Eintragsdetails lesen und ändern

Neben seinen Geheimnissen enthält ein Eintrag Details, die nicht geheim sind: Host, Benutzername oder Domäne, Anhänge, Dokumentationsseiten oder Befehlsparameter. Diese Befehle lesen und ändern sie. Keiner zeigt einen geheimen Wert.

**Ein Feld lesen oder ändern.** `devo entry field get` gibt einen einzelnen Wert zurück, was in einem Skript praktisch ist:

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

Es liest `name`, `type`, `group`, `host`, `username`, `domain`, `port` oder eine andere Eigenschaft des Eintrags, etwa eine Metadateneigenschaft. Auf Devolutions Server kommen nur ID, Name, Typ, Ordner und Tresor zurück: `host` und `username` sind leer. Siehe [Eintragsbefehle](/cli/de/referenz/commands/entries.md#devo-entry-field-get). Um ein Feld zu ändern, verwenden Sie `devo entry field set` mit dem neuen Wert in `--value`, oder aus `--value-env` oder `--value-file`:

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

`devo entry field set` ändert dieselben Felder wie `devo entry update`: `host`, `username` und `domain` auf Devolutions Server und einem lokalen Profil, und `name` nur auf einem lokalen Profil. Es lehnt `password` ab: Um ein Passwort zu ändern, verwenden Sie `devo secret set`. Siehe [Ein Geheimnis aus einem Skript aktualisieren](/cli/de/anleitungen/secrets/update-a-secret.md).

**Weitere Details eines Eintrags**, auf einem lokalen Profil:

<table><thead><tr><th width="240">TO</th><th>AUSFÜHREN</th></tr></thead><tbody><tr><td>Die Metadatenfelder auflisten</td><td><code>devo entry metadata list "&#x3C;entry-name>"</code><br><br>Sie können den Eintrag auch über seinen Pfad auswählen: <code>path:&#x3C;entry-path></code>.</td></tr><tr><td>Die Anhänge auflisten</td><td><code>devo entry attachment list "&#x3C;entry-name>"</code></td></tr><tr><td>Eine Dokumentationsseite lesen</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>Diese Befehle nehmen die ID des Eintrags.</td></tr><tr><td>Eine Dokumentationsseite umbenennen</td><td><code>devo entry documentation update &#x3C;entry-id> --title "&#x3C;page-title>" --new-title "&#x3C;new-title>" --yes</code><br><br>Ein lokales Profil kann den Inhalt einer Seite nicht ändern.</td></tr><tr><td>Befehlsparameter auflisten und ändern</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>Wählen Sie den Parameter mit <code>--label</code> oder <code>--position</code> aus. Sie können seine Bezeichnung (<code>--new-label</code>), seinen Typ (<code>--type</code>: <code>Text</code>, <code>Secured</code>, <code>EnvironmentVariable</code> oder <code>Unused</code>) oder seinen Standardwert (<code>--value</code>, <code>--value-env</code> oder <code>--value-file</code>) ändern. <code>--include-unused</code> listet auch die ungenutzten Parameterplätze auf.</td></tr><tr><td>Die Elemente eines Password List-Eintrags auflisten</td><td><code>devo entry password-list list "&#x3C;entry-name>" --name "&#x3C;item-name>"</code><br><br><code>--name</code> filtert die Elemente nach Name. Passwörter und vertrauliche benutzerdefinierte Felder kommen leer zurück.</td></tr></tbody></table>

## Tresore erstellen und aktualisieren

Das Erstellen, Umbenennen und Löschen von Tresoren ist auf Devolutions Cloud und Devolutions Server verfügbar.

1. Einen Tresor erstellen:

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

   Um mehrere Tresore auf einmal zu erstellen, verwenden Sie `devo vault create-many "<name-1>" "<name-2>" --yes`. Devolutions CLI meldet, welche erstellt wurden und welche fehlgeschlagen sind.
2. Benennen Sie einen Tresor um oder ändern Sie seine Beschreibung:

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

## Einträge erstellen und aktualisieren

Das Erstellen von Einträgen ist in einem lokalen Profil von Devolutions Remote Desktop Manager verfügbar.

Beide Befehle unten schreiben in den lokalen Workspace, daher brauchen sie seine Passphrase: Übergeben Sie `--passphrase-file <file>` oder `--passphrase-env <VARIABLE_NAME>`, oder bewahren Sie sie in einer `<workspace file>.passphrase`-Datei im Profilordner auf. Ohne eine davon stoppen sie mit `missingParameter`.

1. Erstellen Sie den Eintrag. Ein lokales Profil erstellt nur RDP-Einträge:

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

   Der Eintrag geht in den Standardtresor: Ein lokales Profil erstellt Einträge nur dort, und ein anderes `--vault-id` stoppt mit `sqliteEntryCreateVaultUnsupported`.
2. Legen Sie sein Passwort aus einer Umgebungsvariable oder einer Datei fest, damit der Wert nie in der Befehlszeile erscheint:

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

   Siehe [Ein Geheimnis aus einem Skript aktualisieren](/cli/de/anleitungen/secrets/update-a-secret.md).

Um einen vorhandenen Eintrag zu ändern, verwenden Sie `devo entry update` mit den zu ändernden Feldern:

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

Was Sie ändern können, hängt vom Workspace-Typ ab:

* **Lokales Profil**: `--new-name`, `--host`, `--username` und `--domain`. `--host-port` und `--password-secret-reference` werden abgelehnt.
* **Devolutions Server**: `--host`, `--username` und `--domain`.
* **Devolutions Cloud**: nur das Passwort, mit `devo secret set`.

## Einträge organisieren

Diese Befehle sind auf einem lokalen Profil verfügbar.

<table><thead><tr><th width="240">TO</th><th>AUSFÜHREN</th></tr></thead><tbody><tr><td>Einträge in einen anderen Ordner verschieben</td><td><code>devo entry move --entry-id &#x3C;entry-id> --destination-group "&#x3C;folder>" --yes</code><br><br>Wiederholen Sie <code>--entry-id</code>, um mehrere Einträge zu verschieben. Ein lokales Profil verschiebt Einträge nur innerhalb ihres Tresors: Ein anderes <code>--to-vault</code> stoppt mit <code>entryMoveCrossVaultUnsupported</code>. Ein leeres <code>--destination-group</code> verschiebt sie in die Wurzel des Tresors.</td></tr><tr><td>Einen Ordner umbenennen</td><td><code>devo entry folder rename "&#x3C;folder-path>" --new-name "&#x3C;new-name>" --yes</code><br><br>Die Pfade der Einträge im Ordner werden ebenfalls aktualisiert.</td></tr><tr><td>Den Status eines Eintrags festlegen</td><td><code>devo entry status set "&#x3C;entry-name>" --status Locked --message "&#x3C;reason>" --yes</code><br><br>Statuswerte: <code>Archived</code>, <code>Broken</code>, <code>Default</code>, <code>Disabled</code>, <code>Expired</code>, <code>Locked</code> oder <code>Warning</code>.<br><br>Um den Eintrag mit diesem Befehl und <code>devo entry tag set</code> nach ID auszuwählen, fügen Sie <code>--id</code> hinzu: Diese beiden Befehle erkennen das Präfix <code>id:</code> nicht.</td></tr><tr><td>Die Tags eines Eintrags ersetzen</td><td><code>devo entry tag set "&#x3C;entry-name>" --tag &#x3C;tag-1> --tag &#x3C;tag-2> --yes</code><br><br>Die Tags, die Sie übergeben, ersetzen die vorhandenen. Verwenden Sie <code>--clear</code>, um sie alle zu entfernen.</td></tr></tbody></table>

Um sie wieder zu lesen, verwenden Sie `devo entry status get` und `devo entry tag list`. Diese beiden Befehle stoppen mit `entryFieldNotFound`, wenn der Eintrag keinen Status oder keine Tags hat, und immer auf Devolutions Cloud und Devolutions Server, die sie nicht zurückgeben. Um die gelöschten Einträge zu sehen, verwenden Sie `devo entry trash list`, mit `--before <date>`, um nur die vor einem Datum gelöschten zu sehen.

## Einträge und Tresore löschen

{% hint style="danger" %}
`--yes` ist die einzige Bestätigung, die Devolutions CLI verlangt. Prüfen Sie den Namen oder die ID, bevor Sie etwas löschen, besonders in einem Skript, und ziehen Sie IDs den Namen vor.
{% endhint %}

Das Löschen von Einträgen und Tresoren ist auf Devolutions Cloud und Devolutions Server verfügbar.

**Einen Eintrag löschen:**

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

Auf Devolutions Cloud löscht das Löschen eines Eintrags auch die Einträge darunter. Devolutions CLI verweigert das, bis Sie `--acknowledge-recursive-scope` hinzufügen, was zeigt, dass Sie es wissen.

**Einen Tresor löschen:**

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

Wählen Sie auf Devolutions Cloud den Tresor nach seiner ID: Ein Tresorname oder der aktuelle Tresor wird nicht akzeptiert. Der Tresor geht in den Papierkorb, sofern Sie nicht `--permanently` hinzufügen.

## Was jeder Workspace-Typ tun kann

<table><thead><tr><th width="260">AUFGABE</th><th>LOKALES PROFIL</th><th>DEVOLUTIONS CLOUD</th><th>DEVOLUTIONS SERVER</th></tr></thead><tbody><tr><td>Workspaces auflisten, den aktuellen anzeigen</td><td>Ja</td><td>Ja</td><td>Ja</td></tr><tr><td>Workspaces auswählen, erstellen und löschen</td><td>Ja</td><td>No</td><td>No</td></tr><tr><td>Tresore auflisten und auswählen</td><td>Ja</td><td>Ja</td><td>Ja</td></tr><tr><td>Tresore erstellen, umbenennen und löschen</td><td>No</td><td>Ja</td><td>Ja</td></tr><tr><td>Einträge auflisten, suchen und abrufen</td><td>Ja</td><td>Ja</td><td>Ja</td></tr><tr><td>Einträge erstellen</td><td>RDP-Einträge</td><td>No</td><td>No</td></tr><tr><td>Ein Feld lesen (<code>devo entry field get</code>)</td><td>Ja</td><td>Ja</td><td>Nur ID, Name, Typ, Ordner und Tresor</td></tr><tr><td>Einträge aktualisieren (<code>devo entry update</code>, <code>devo entry field set</code>)</td><td>Ja*</td><td>Nein (Passwort mit <code>devo secret set</code>)</td><td>Host, Benutzername, Domäne</td></tr><tr><td>Metadaten, Anhänge, Dokumentation, Befehlsparameter, Elemente eines Password List-Eintrags</td><td>Ja*</td><td>No</td><td>No</td></tr><tr><td>Einträge verschieben, Ordner umbenennen</td><td>Ja*</td><td>No</td><td>No</td></tr><tr><td>Status und Tags lesen und festlegen</td><td>Ja*</td><td>No</td><td>No</td></tr><tr><td>Einträge löschen</td><td>No</td><td>Ja, mit <code>--acknowledge-recursive-scope</code></td><td>Ja</td></tr><tr><td>Gelöschte Einträge auflisten</td><td>Ja</td><td>No</td><td>No</td></tr></tbody></table>

\* Wenn das Profil es zulässt. `devo doctor` listet die Vorgänge auf, die der ausgewählte Workspace unterstützt. Wenn eine Änderung in Ihrem Profil nicht verfügbar ist, nehmen Sie sie in Devolutions Remote Desktop Manager vor.

## Gut zu wissen

* `--yes` bestätigt die Änderung. Ohne diese Option ändert der Befehl nichts und stoppt mit `confirmationRequired`. Siehe [Ohne Eingabeaufforderungen ausführen](/cli/de/fur-devops-und-administratoren/automate/non-interactive.md).
* Fügen Sie `--output json` hinzu, um ein Ergebnis zu erhalten, das ein Skript lesen kann. Siehe [Ergebnisse als JSON lesen](/cli/de/fur-devops-und-administratoren/automate/json-output.md).
* Ein Befehl stoppt mit `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) oder einem anderen Code, der sagt, dass das lokale Profil es nicht kann? Der ausgewählte Workspace kann diese Änderung nicht vornehmen. Siehe [Ein Befehl meldet, dass der Workspace ihn nicht unterstützt](/cli/de/hilfe/troubleshooting/not-supported.md).

## Weiter

* [Manage users, groups, and access](/cli/de/fur-devops-und-administratoren/manage/users-and-access.md)
* [Review activity logs](/cli/de/fur-devops-und-administratoren/manage/logs.md)
* [Commands](/cli/de/referenz/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/de/fur-devops-und-administratoren/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.