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

# Workspace-, Tresor- und Variablenbefehle

Jeder Befehl devo workspace, devo vault und devo variable, mit jeder Option, ihrem Standardwert, ihren erlaubten Werten und den Workspace-Typen, die sie akzeptieren.

Diese Seite beschreibt jeden Befehl `devo workspace`, `devo vault` und `devo variable` und jede Option, die Sie damit eingeben können. Die kurze Liste aller Befehle steht in [Befehle](/cli/de/referenz/commands.md). Für Hilfe Schritt für Schritt siehe [Tresore und Einträge verwalten](/cli/de/fur-devops-und-administratoren/manage/vaults-and-entries.md) und [Benutzerdefinierte Variablen verwenden](/cli/de/fur-devops-und-administratoren/manage/custom-variables.md). Die Optionen, die jeder Befehl akzeptiert, etwa `--context`, `--output json` oder `--non-interactive`, sind in [Globale Optionen](/cli/de/referenz/global-options.md) beschrieben und werden hier nicht wiederholt. Die Eintragsbefehle stehen in [Eintragsbefehle](/cli/de/referenz/commands/entries.md).

{% hint style="info" %}
Um die Hilfe eines Befehls mit dem genauen Wortlaut zu sehen, führen Sie `devo <command> --help` aus, zum Beispiel `devo vault list --help`.
{% endhint %}

## So funktionieren diese Befehle

* **Workspace oder Tresor auswählen**: Befehle nehmen standardmäßig den **Namen**, genau abgeglichen, ohne Berücksichtigung der Groß- und Kleinschreibung. Um stattdessen eine ID zu übergeben, schreiben Sie `id:<value>` oder fügen Sie `--id` hinzu. `name:<value>` erzwingt einen Namen. Ausnahmen stehen unter jedem Befehl, etwa `devo workspace delete`, das die genaue Workspace-ID braucht.
* **Aktueller Workspace und aktueller Tresor**: Die meisten Befehle arbeiten im aktuellen Workspace und im aktuellen Tresor. Setzen Sie sie mit `devo workspace use` und `devo vault use`. Um für einen Befehl einen anderen Kontext zu verwenden, fügen Sie `--context <name>` hinzu. Siehe [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md).
* **Bestätigen einer Änderung**: Jeder Befehl, der etwas erstellt, ändert oder löscht, verweigert die Ausführung ohne `--yes` (Aliase `-y` und `--confirmed`) und stoppt mit `confirmationRequired`. Es wird nichts geändert.
* **Workspace-Typen**: Ein Befehl, den der ausgewählte Workspace nicht unterstützt, stoppt mit `operationNotSupportedBySource` (Devolutions Cloud, Devolutions Server) oder mit einem Code, der sagt, dass das lokale Profil es nicht kann. Siehe [Ein Befehl meldet, dass der Workspace ihn nicht unterstützt](/cli/de/hilfe/troubleshooting/not-supported.md).

## Befehlsgruppen

<table><thead><tr><th width="300">GRUPPE</th><th>BEFEHLE</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

Listet die Workspaces auf, die Sie verwenden können, mit Name, ID, Art und ob jeder verfügbar, der aktuelle und der Standard ist. Der aktuelle Workspace ist mit `*` markiert. Ein neues lokales Profil ohne Workspace gibt eine leere Liste zurück. Alias: `devo workspace ls`.

**Workspace:** Alle Workspace-Typen

```bash
devo workspace list
```

Dieser Befehl hat keine eigenen Optionen.

## devo workspace current

Zeigt den aktuellen Workspace.

**Workspace:** Alle Workspace-Typen

```bash
devo workspace current
```

Dieser Befehl hat keine eigenen Optionen.

## devo workspace use

Macht einen Workspace zum aktuellen.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Erforderlich. Workspace-Name oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>. Ein unbekannter Workspace stoppt mit <code>workspaceNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;workspace></code> als ID.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Umgebungsvariable, die das Passwort des Workspace enthält. Wenn Sie sie übergeben, muss die Variable vorhanden sein, sonst stoppt der Befehl mit <code>invalidParameterValue</code>. Ein lokales Profil braucht kein Passwort, um einen Workspace auszuwählen.</td></tr></tbody></table>

Auf Devolutions Cloud und Devolutions Server stoppt der Befehl mit `operationNotSupportedBySource`: Wählen Sie mit `--context` oder `devo context use` einen anderen Workspace.

## devo workspace create

Erstellt einen SQLite-Workspace im Ordner des lokalen Profils und macht ihn, sofern Sie nicht `--no-set-current` hinzufügen, zum aktuellen. Die Passphrase, die Sie angeben, schützt den neuen Workspace.

**Workspace:** Lokales Profil

```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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Erforderlich. Name des Workspace. Ohne <code>--path</code> ist er auch der Name der Datenbankdatei.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td><code>sqlite</code></td><td>Art des Workspace. Ein lokales Profil erstellt nur <code>sqlite</code>-Workspaces; jede andere Art stoppt mit <code>operationNotSupportedBySource</code>.</td></tr><tr><td><code>--path &#x3C;file-name></code></td><td><code>&#x3C;name>.db</code></td><td>Dateiname der Datenbank, erstellt im Profilordner. Übergeben Sie einen Dateinamen, keinen Pfad mit Ordnern: Ein Pfad stoppt mit <code>invalidParameterValue</code>. <code>.db</code> wird hinzugefügt, wenn der Name nicht damit endet.</td></tr><tr><td><code>--passphrase-file &#x3C;file></code></td><td></td><td>Private Datei, die die Passphrase enthält, die den neuen Workspace schützt. Devolutions Cloud und Devolutions Server lehnen diese Option ab.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Umgebungsvariable, die die Passphrase enthält, die den neuen Workspace schützt. Devolutions Cloud und Devolutions Server lehnen diese Option ab.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Umgebungsvariable, die Passwortmaterial für den Workspace enthält. Ein lokales Profil lehnt sie ab: Verwenden Sie <code>--passphrase-file</code> oder <code>--passphrase-env</code>.</td></tr><tr><td><code>--no-set-current</code></td><td>Aus</td><td>Erstellt den Workspace, ohne ihn zum aktuellen zu machen.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Erstellung. Erforderlich.</td></tr></tbody></table>

Bei einem lokalen Profil übergeben Sie genau eines von `--passphrase-file` und `--passphrase-env`. Ohne beide oder mit beiden stoppt der Befehl mit `invalidParameterValue`. Auf Devolutions Cloud und Devolutions Server stoppt der Befehl mit `operationNotSupportedBySource`, mit oder ohne `--password-env`.

## devo workspace delete

Löscht einen SQLite-Workspace des lokalen Profils: Seine Datenbankdatei und seine temporären Dateien werden aus dem Profilordner gelöscht. Das kann nicht rückgängig gemacht werden. Alias: `devo workspace rm`.

Nur unter Windows verfügbar. Unter macOS und Linux stoppt der Befehl mit `sqliteWorkspaceDeleteUnsupported` (Exitcode `3`).

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td></td><td>Erforderlich. Die genaue Workspace-ID, die <code>devo workspace list</code> anzeigt, etwa <code>sqlite:Connections.db</code>, mit oder ohne das Präfix <code>id:</code>. Ein Workspace-Name wird nicht akzeptiert.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;workspace></code> als ID. Nicht nötig, wenn Sie die ID <code>sqlite:</code> angeben.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt das Löschen. Erforderlich.</td></tr></tbody></table>

## devo workspace variable list

Listet die benutzerdefinierten Variablen des aktuellen Workspace mit Name, Wert, Bereich, Quelle und Beschreibung. Die Werte werden im Klartext angezeigt, außer bei Variablen, deren Name oder eines der gespeicherten Felder `password`, `secret`, `token`, `encrypt`, `protected` oder `safevalue` enthält: Ihr Wert kommt leer zurück, und sie werden als `redacted` markiert. Alias: `devo workspace variable ls`.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Alle Variablen</td><td>Optionaler Namensfilter, ohne Beachtung der Groß- und Kleinschreibung. <code>*</code> passt zu beliebigem Text und <code>?</code> zu einem Zeichen. Ohne Platzhalter muss der Name genau passen. Die Trennzeichen <code>$</code> sind optional.</td></tr></tbody></table>

## devo workspace variable set

Erstellt eine benutzerdefinierte Variable des aktuellen Workspace oder aktualisiert sie, wenn sie vorhanden ist. Der Wert kommt aus einer Umgebungsvariable oder einer Datei, nie von der Befehlszeile.

**Workspace:** Lokales Profil

```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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Erforderlich. Variablenname: nur Buchstaben, Ziffern und Unterstriche. Die Trennzeichen <code>$</code> sind optional; der Name wird in Großbuchstaben gespeichert, zwischen <code>$</code>-Zeichen.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Umgebungsvariable, die den Wert enthält. Die Variable muss vorhanden sein.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>Datei, die den Wert enthält. Der ganze Inhalt wird unverändert verwendet, einschließlich eines abschließenden Zeilenumbruchs.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Unverändert</td><td>Beschreibung der Variable. Ohne sie wird eine vorhandene Beschreibung behalten.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Änderung. Erforderlich.</td></tr></tbody></table>

Übergeben Sie genau eines von `--value-env` und `--value-file`: beide stoppen den Befehl mit `conflictingOptions`, keines mit `missingParameter`. Denselben Wert und dieselbe Beschreibung erneut zu setzen stoppt den Befehl mit `sqliteVariableUpdateNoChanges`. Änderungen brauchen eine unverschlüsselte lokale Datenbank.

## devo workspace variable delete

Löscht benutzerdefinierte Variablen des aktuellen Workspace. Alias: `devo workspace variable rm`.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Erforderlich. Ein oder mehrere Variablennamen. Wenn ein Name nicht vorhanden ist oder zweimal vorkommt, schlägt der Befehl fehl und löscht nichts.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt das Löschen. Erforderlich.</td></tr></tbody></table>

## devo vault list

Listet die Tresore des aktuellen Workspace auf, mit Name, ID und Typ. Der aktuelle Tresor ist markiert. Alias: `devo vault ls`.

**Workspace:** Alle Workspace-Typen

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Alle Tresore</td><td>Optional. Behält nur den Tresor mit diesem Namen, oder mit dieser ID mit <code>id:&#x3C;value></code> oder <code>--id</code>. Der Name wird genau abgeglichen, ohne Berücksichtigung der Groß- und Kleinschreibung, bei jedem Workspace-Typ. Auf Devolutions Cloud und Devolutions Server werden die Tresore nach Name sortiert.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr></tbody></table>

## devo vault get

Zeigt einen Tresor.

**Workspace:** Alle Workspace-Typen

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>. Der Name wird genau abgeglichen, ohne Berücksichtigung der Groß- und Kleinschreibung, bei jedem Workspace-Typ. Wenn kein Tresor passt, stoppt der Befehl mit <code>vaultNotFound</code>; wenn mehrere Tresore den Namen teilen, mit <code>vaultSelectorAmbiguous</code>: Verwenden Sie die ID.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr></tbody></table>

## devo vault current

Zeigt den aktuellen Tresor.

**Workspace:** Alle Workspace-Typen

```bash
devo vault current
```

Dieser Befehl hat keine eigenen Optionen.

## devo vault use

Macht einen Tresor zum aktuellen. Eintragsbefehle arbeiten dann in diesem Tresor, sofern Sie nicht `--vault-name` oder `--vault-id` übergeben.

**Workspace:** Alle Workspace-Typen

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>. Der Name wird genau abgeglichen, ohne Berücksichtigung der Groß- und Kleinschreibung, bei jedem Workspace-Typ. Wenn mehrere Tresore den Namen teilen, wird der zuerst gefundene zum aktuellen Tresor: Verwenden Sie die ID, um sicherzugehen. Ein unbekannter Tresor stoppt mit <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr></tbody></table>

## devo vault create

Erstellt einen Tresor.

**Workspace:** Devolutions Cloud, Devolutions Server

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Erforderlich. Name des neuen Tresors. Ein leerer Name stoppt mit <code>missingParameter</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Beschreibung des neuen Tresors.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Erstellung. Erforderlich.</td></tr></tbody></table>

## devo vault create-many

Erstellt mehrere Tresore in einem Befehl, einen nach dem anderen, und meldet für jeden Namen, ob er erstellt wurde oder fehlgeschlagen ist.

**Workspace:** 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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Erforderlich. Ein oder mehrere Tresornamen.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Beschreibung, die jedem erstellten Tresor gegeben wird.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Erstellung. Erforderlich.</td></tr></tbody></table>

Ein Fehler stoppt die anderen nicht. Wenn einige Tresore erstellt wurden und andere nicht, sagt das Ergebnis `partialFailure`; wenn keiner erstellt wurde, `vaultCreateFailed`.

## devo vault update

Benennt einen Tresor um oder ändert seine Beschreibung.

**Workspace:** 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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr><tr><td><code>--new-name &#x3C;name></code></td><td>Unverändert</td><td>Neuer Tresorname.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Unverändert</td><td>Neue Tresor-Beschreibung. Ein leerer Wert wird ignoriert, daher kann dieser Befehl eine Beschreibung nicht löschen.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Änderung. Erforderlich.</td></tr></tbody></table>

Geben Sie mindestens eines von `--new-name` und `--description` an, sonst stoppt der Befehl mit `missingParameter`.

## devo vault delete

Löscht einen Tresor. Alias: `devo vault rm`.

**Workspace:** Devolutions Cloud, Devolutions Server

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>. Auf Devolutions Cloud wird nur die ID akzeptiert: Ein Name stoppt mit <code>cloudVaultCanonicalIdRequired</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr><tr><td><code>--permanently</code></td><td>Aus</td><td>Devolutions Cloud: Löscht den Tresor dauerhaft, statt ihn in den Papierkorb zu verschieben. Von Devolutions Server ignoriert.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt das Löschen. Erforderlich.</td></tr></tbody></table>

## devo vault settings get

Zeigt die Stammeinstellungen des aktuellen Tresors oder des Tresors, den Sie nennen: Beschreibung, Stammeintrag und Tag-Konfigurationsmodus. Das Ergebnis ist schreibgeschützt.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td>Aktueller Tresor</td><td>Optional. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr></tbody></table>

Dieser Befehl funktioniert nur, wenn das Profil es zulässt.

## devo vault template list

Listet die Tresorvorlagen des Profils mit ihrem Namen und ihrer ID auf. Alias: `devo vault template ls`.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>--vault-id &#x3C;id></code></td><td>Alle Vorlagen</td><td>Behält die Tresorvorlage mit dieser ID. Der Wert wird mit den Vorlagen abgeglichen, nicht mit Ihren Tresoren.</td></tr><tr><td><code>--vault-name &#x3C;name></code></td><td>Alle Vorlagen</td><td>Behält die Tresorvorlage mit diesem Namen, ohne Berücksichtigung der Groß- und Kleinschreibung. Ignoriert, wenn <code>--vault-id</code> angegeben ist.</td></tr></tbody></table>

## devo vault access list

Listet die Benutzer und Gruppen auf, die Zugriff auf einen Tresor haben, mit ihrer Rolle. Alias: `devo vault access ls`.

**Workspace:** 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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td>Alle</td><td>Behält einen Benutzer: standardmäßig der Name, oder <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> oder <code>email:&#x3C;value></code>. Eine bloße GUID wird als ID gelesen.</td></tr><tr><td><code>--group &#x3C;group></code></td><td>Alle</td><td>Behält eine Benutzergruppe: standardmäßig den Namen, oder <code>id:&#x3C;value></code> oder <code>name:&#x3C;value></code>. Eine bloße GUID wird als ID gelesen.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Behält eine Anwendungsidentität. Devolutions Cloud lehnt sie mit <code>cloudVaultAccessApplicationUnsupported</code> ab.</td></tr><tr><td><code>--case-sensitive</code></td><td>Aus</td><td>Vergleicht Namen und E-Mails unter Beachtung der Groß- und Kleinschreibung. Standardmäßig spielt die Schreibweise keine Rolle. Ein Benutzername passt zum Benutzernamen oder zum Anzeigenamen; eine E-Mail passt zur E-Mail oder zur Anmelde-E-Mail; ein Gruppenname passt zum Gruppennamen.</td></tr></tbody></table>

Verwenden Sie höchstens eines von `--user`, `--group` und `--application`, sonst stoppt der Befehl mit `conflictingOptions`.

## devo vault access grant

Gibt einem Benutzer oder einer Gruppe eine Rolle für einen Tresor.

**Workspace:** 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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Benutzer, der die Rolle erhält: standardmäßig der Name, oder <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> oder <code>email:&#x3C;value></code>. Eine bloße GUID wird als ID gelesen.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Benutzergruppe, die die Rolle erhält: standardmäßig der Name, oder <code>id:&#x3C;value></code> oder <code>name:&#x3C;value></code>. Eine bloße GUID wird als ID gelesen.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Anwendungsidentität, die die Rolle erhält. Devolutions Cloud lehnt sie mit <code>cloudVaultAccessPrincipalUnsupported</code> ab.</td></tr><tr><td><code>--role &#x3C;role></code></td><td></td><td>Tresorrolle, nach Name oder ID, ohne Berücksichtigung der Groß- und Kleinschreibung: <code>Restricted</code>, <code>Readers</code>, <code>PrivilegedReaders</code>, <code>Operators</code>, <code>PrivilegedOperators</code>, <code>Contributors</code> oder <code>VaultOwners</code>. Eine unbekannte Rolle stoppt mit <code>cloudVaultRoleNotFound</code>.</td></tr><tr><td><code>--case-sensitive</code></td><td>Aus</td><td>Vergleicht Namen und E-Mails unter Beachtung der Groß- und Kleinschreibung. Standardmäßig spielt die Schreibweise keine Rolle. Ein Benutzername passt zum Benutzernamen oder zum Anzeigenamen; eine E-Mail passt zur E-Mail oder zur Anmelde-E-Mail; ein Gruppenname passt zum Gruppennamen.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Änderung. Erforderlich.</td></tr></tbody></table>

Übergeben Sie genau eines von `--user` und `--group`: keines stoppt mit `missingParameter`, mehrere mit `conflictingOptions`. Wenn der Name zu mehreren Benutzern oder Gruppen passt, stoppt der Befehl mit `principalAmbiguous`: Verwenden Sie die ID.

## devo vault access revoke

Entfernt den Zugriff eines Benutzers oder einer Gruppe auf einen Tresor. Alias: `devo vault access rm`.

**Workspace:** 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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;vault></code></td><td></td><td>Erforderlich. Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>&#x3C;vault></code> als ID.</td></tr><tr><td><code>--user &#x3C;user></code></td><td></td><td>Benutzer, dessen Zugriff entfernt wird: standardmäßig der Name, oder <code>id:&#x3C;value></code>, <code>name:&#x3C;value></code> oder <code>email:&#x3C;value></code>.</td></tr><tr><td><code>--group &#x3C;group></code></td><td></td><td>Benutzergruppe, deren Zugriff entfernt wird: standardmäßig der Name, oder <code>id:&#x3C;value></code> oder <code>name:&#x3C;value></code>.</td></tr><tr><td><code>--application &#x3C;application></code></td><td></td><td>Anwendungsidentität, deren Zugriff entfernt wird. Devolutions Cloud lehnt sie mit <code>cloudVaultAccessPrincipalUnsupported</code> ab.</td></tr><tr><td><code>--all</code></td><td>Aus</td><td>Entfernt jede Zugriffszuweisung des Tresors. Kann nicht mit <code>--user</code>, <code>--group</code> oder <code>--application</code> kombiniert werden. Devolutions Cloud lehnt sie mit <code>cloudVaultAccessPrincipalUnsupported</code> ab: Widerrufen Sie einen Benutzer oder eine Gruppe nach der anderen.</td></tr><tr><td><code>--case-sensitive</code></td><td>Aus</td><td>Vergleicht Namen und E-Mails unter Beachtung der Groß- und Kleinschreibung. Standardmäßig spielt die Schreibweise keine Rolle. Ein Benutzername passt zum Benutzernamen oder zum Anzeigenamen; eine E-Mail passt zur E-Mail oder zur Anmelde-E-Mail; ein Gruppenname passt zum Gruppennamen.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt das Entfernen. Erforderlich.</td></tr></tbody></table>

## devo vault variable list

Listet die benutzerdefinierten Variablen des aktuellen Tresors oder des Tresors, den Sie nennen, mit Name, Wert, Bereich, Quelle und Beschreibung. Die Werte werden im Klartext angezeigt, außer bei Variablen, deren Name oder eines der gespeicherten Felder `password`, `secret`, `token`, `encrypt`, `protected` oder `safevalue` enthält: Ihr Wert kommt leer zurück, und sie werden als `redacted` markiert. Alias: `devo vault variable ls`.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Alle Variablen</td><td>Optionaler Namensfilter, ohne Beachtung der Groß- und Kleinschreibung. <code>*</code> passt zu beliebigem Text und <code>?</code> zu einem Zeichen. Ohne Platzhalter muss der Name genau passen. Die Trennzeichen <code>$</code> sind optional.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Aktueller Tresor</td><td>Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>. Ein unbekannter Tresor stoppt mit <code>vaultNotFound</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>--vault</code> als ID.</td></tr></tbody></table>

## devo vault variable set

Erstellt eine benutzerdefinierte Variable des aktuellen Tresors oder des Tresors, den Sie nennen, oder aktualisiert sie, wenn sie vorhanden ist. Der Wert kommt aus einer Umgebungsvariable oder einer Datei, nie von der Befehlszeile.

**Workspace:** Lokales Profil

```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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Erforderlich. Variablenname: nur Buchstaben, Ziffern und Unterstriche. Die Trennzeichen <code>$</code> sind optional; der Name wird in Großbuchstaben gespeichert, zwischen <code>$</code>-Zeichen.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Umgebungsvariable, die den Wert enthält. Die Variable muss vorhanden sein.</td></tr><tr><td><code>--value-file &#x3C;file></code></td><td></td><td>Datei, die den Wert enthält. Der ganze Inhalt wird unverändert verwendet, einschließlich eines abschließenden Zeilenumbruchs.</td></tr><tr><td><code>--description &#x3C;text></code></td><td>Unverändert</td><td>Beschreibung der Variable. Ohne sie wird eine vorhandene Beschreibung behalten.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Aktueller Tresor</td><td>Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>--vault</code> als ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt die Änderung. Erforderlich.</td></tr></tbody></table>

Übergeben Sie genau eines von `--value-env` und `--value-file`: beide stoppen den Befehl mit `conflictingOptions`, keines mit `missingParameter`. Denselben Wert und dieselbe Beschreibung erneut zu setzen stoppt den Befehl mit `sqliteVariableUpdateNoChanges`. Änderungen brauchen eine unverschlüsselte lokale Datenbank.

## devo vault variable delete

Löscht benutzerdefinierte Variablen des aktuellen Tresors oder des Tresors, den Sie nennen. Alias: `devo vault variable rm`.

**Workspace:** Lokales Profil

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

<table><thead><tr><th width="300">OPTION</th><th width="130">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>&#x3C;name>…</code></td><td></td><td>Erforderlich. Ein oder mehrere Variablennamen. Wenn ein Name nicht vorhanden ist oder zweimal vorkommt, schlägt der Befehl fehl und löscht nichts.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Aktueller Tresor</td><td>Tresorname oder seine ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>--vault</code> als ID.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt das Löschen. Erforderlich.</td></tr></tbody></table>

## devo variable export

Schreibt die benutzerdefinierten Variablen eines Bereichs in eine JSON-Datei. Jede Variable wird mit Name, Wert, Beschreibung, Bereich und Quelle geschrieben. Wie bei `list` wird eine Variable, deren Name oder eines der gespeicherten Felder `password`, `secret`, `token`, `encrypt`, `protected` oder `safevalue` enthält, mit einem leeren Wert geschrieben. Der Export liest die Variablen nur: Er braucht kein `--yes` und funktioniert für jeden Bereich, auch für jene, die Sie von Devolutions CLI aus nicht ändern können. `variable export` ist der einzige Befehl `devo variable`.

**Workspace:** Lokales Profil

```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">STANDARD</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>--scope &#x3C;scope></code></td><td></td><td>Erforderlich. Welche Variablen exportiert werden, ohne Rücksicht auf die Großschreibung: <code>workspace</code> (die Variablen des aktuellen Workspace), <code>vault</code> (die Variablen eines Tresors), <code>option</code> (auch <code>options</code> geschrieben: die Variablen in der Optionsdatei von Devolutions Remote Desktop Manager des Profils; ein verschleiert gespeicherter Wert kommt leer zurück und wird als <code>unavailable</code> markiert) oder <code>user-vault</code> (auch <code>uservault</code> geschrieben: akzeptiert, aber ein lokales Profil hat keine Variablen des Benutzer-Tresors, die Datei enthält daher eine leere Liste). Jeder andere Wert stoppt mit <code>invalidVariableScope</code>.</td></tr><tr><td><code>--out-file &#x3C;file></code></td><td></td><td>Erforderlich. Zu schreibende JSON-Datei. Ihr Ordner muss vorhanden sein (sonst <code>directoryNotFound</code>), und der Pfad darf kein Ordner sein.</td></tr><tr><td><code>--force</code></td><td>Aus</td><td>Ersetzt die Datei, wenn sie vorhanden ist. Ohne diese Option stoppt eine vorhandene Datei den Befehl mit <code>fileExists</code>.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Aktueller Tresor</td><td>Für die Bereiche <code>vault</code> und <code>user-vault</code> der zu exportierende Tresor: Name oder ID mit <code>id:&#x3C;value></code> oder <code>--id</code>.</td></tr><tr><td><code>--id</code></td><td>Aus</td><td>Behandelt <code>--vault</code> als ID.</td></tr><tr><td><code>--name &#x3C;filter></code></td><td>Alle Variablen</td><td>Behält nur die Variablen, deren Name übereinstimmt, ohne Berücksichtigung der Groß- und Kleinschreibung. <code>*</code> entspricht beliebigem Text und <code>?</code> einem Zeichen.</td></tr></tbody></table>

{% hint style="warning" %}
Die exportierte Datei enthält die Werte im Klartext, und Devolutions CLI macht sie nicht privat. Committen Sie sie nicht, und löschen Sie sie, wenn Sie sie nicht mehr brauchen.
{% endhint %}

## Verwandte Seiten

* [Manage vaults and entries](/cli/de/fur-devops-und-administratoren/manage/vaults-and-entries.md)
* [Use custom variables](/cli/de/fur-devops-und-administratoren/manage/custom-variables.md)
* [Manage users, groups, and access](/cli/de/fur-devops-und-administratoren/manage/users-and-access.md)
* [Entry commands](/cli/de/referenz/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/de/referenz/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.