> 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/custom-variables.md).

# Benutzerdefinierte Variablen verwenden

Die benutzerdefinierten Variablen eines lokalen Workspace und seiner Tresore mit Devolutions CLI auflisten, erstellen, aktualisieren, löschen und exportieren, von einem Terminal oder einem Skript.

Benutzerdefinierte Variablen sind benannte Werte, die in Ihrem Workspace oder in einem seiner Tresore gespeichert sind. Mit Devolutions CLI können Sie sie auflisten, aus einem Skript setzen und exportieren, ohne Devolutions Remote Desktop Manager zu öffnen.

{% hint style="info" %}
Benutzerdefinierte Variablen funktionieren nur mit einem lokalen Profil von Devolutions Remote Desktop Manager. Auf Devolutions Cloud und Devolutions Server sagen diese Befehle, dass der Workspace sie nicht unterstützt. Siehe [Ein Befehl meldet, dass der Workspace ihn nicht unterstützt](/cli/de/hilfe/troubleshooting/not-supported.md).
{% endhint %}

Diese Befehle arbeiten mit dem aktuellen Kontext. Um für einen einzelnen Befehl ein anderes lokales Profil zu verwenden, fügen Sie `--context <context-name>` hinzu. Siehe [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md).

## Den richtigen Befehl wählen

<table><thead><tr><th width="260">AUSWÄHLEN</th><th>WAS PASSIERT</th><th>VERWENDEN, WENN</th></tr></thead><tbody><tr><td><code>devo workspace variable</code></td><td>Listet benutzerdefinierte Variablen des aktuellen Workspace auf, setzt sie oder löscht sie.</td><td>Die Variable gehört zum gesamten Workspace.</td></tr><tr><td><code>devo vault variable</code></td><td>Listet die benutzerdefinierten Variablen des aktuellen Tresors oder des Tresors auf, den Sie mit <code>--vault</code> nennen, setzt sie oder löscht sie.</td><td>Die Variable gehört zu einem Tresor.</td></tr><tr><td><code>devo variable export</code></td><td>Schreibt die benutzerdefinierten Variablen eines Bereichs in eine JSON-Datei.</td><td>Sie wollen eine Kopie der Variablen, zum Beispiel um sie zu prüfen oder sie bei einem Skript zu behalten.</td></tr></tbody></table>

{% hint style="warning" %}
Benutzerdefinierte Variablen sind keine Geheimnisse. `devo workspace variable list` und `devo vault variable list` zeigen jeden Wert im Klartext, die JSON-Ausgabe dieser Befehle enthält die Werte, und die exportierte Datei enthält sie ebenfalls. Die Ausnahme: Eine Variable, deren Name oder eines der gespeicherten Felder `password`, `secret`, `token`, `encrypt`, `protected` oder `safevalue` enthält, kommt mit einem leeren Wert und dem Status `redacted` zurück. Eine Variable, deren Wert das Profil in verborgener Form speichert, kommt leer mit dem Status `unavailable` zurück. Bewahren Sie Passwörter und Schlüssel in Einträgen auf, und verwenden Sie sie mit [devo secret run](/cli/de/anleitungen/secrets/run-with-secrets.md).
{% endhint %}

## Variablen auflisten

```bash
devo workspace variable list
devo vault variable list --vault "<vault-name>"
```

Die Tabelle zeigt Name, Wert, Bereich, Quelle und Beschreibung jeder Variable. Um nur einige zu behalten, fügen Sie einen Namensfilter hinzu: `*` passt zu beliebigem Text und `?` zu einem Zeichen, und die Schreibweise spielt keine Rolle.

```bash
devo workspace variable list "API_*"
```

Ohne `--vault` verwendet `devo vault variable list` den aktuellen Tresor. Um den Tresor nach ID auszuwählen, schreiben Sie `--vault id:<vault-id>` oder fügen Sie `--id` hinzu.

## Eine Variable erstellen oder aktualisieren

`set` erstellt die Variable, wenn sie nicht vorhanden ist, und aktualisiert sie sonst. Der Wert kommt aus einer Umgebungsvariable (`--value-env`) oder einer Datei (`--value-file`), nie von der Befehlszeile, sodass er nicht im Verlauf Ihrer Shell landet. Verwenden Sie eines der beiden, nicht beides.

{% tabs %}
{% tab title="Bash" %}

```bash
export VARIABLE_VALUE='<value>'
devo workspace variable set API_REGION --value-env VARIABLE_VALUE --description "<description>" --yes
```

{% endtab %}

{% tab title="PowerShell" %}

```powershell
$env:VARIABLE_VALUE = '<value>'
devo workspace variable set API_REGION --value-env VARIABLE_VALUE --description "<description>" --yes
```

{% endtab %}
{% endtabs %}

Verwenden Sie für eine Tresorvariable `devo vault variable set` mit denselben Optionen, plus `--vault "<vault-name>"`, um einen anderen Tresor als den aktuellen zu wählen.

* **Name**: nur Buchstaben, Ziffern und Unterstriche. Die Trennzeichen `$` sind optional: `API_REGION` und `$API_REGION$` sind dieselbe Variable. Devolutions CLI speichert den Namen in Großbuchstaben, zwischen `$`-Zeichen.
* **Wert aus einer Datei**: Der gesamte Inhalt der Datei wird zum Wert, so wie er ist, einschließlich eines abschließenden Zeilenumbruchs, wenn die Datei mit einem endet.
* **Wert aus einer Variable**: die Umgebungsvariable muss vorhanden sein. Devolutions CLI stoppt, wenn sie nicht gesetzt ist.
* **Bestätigung**: Ohne `--yes` (oder `-y`, `--confirmed`) ändert der Befehl nichts und gibt `confirmationRequired` zurück.

## Variablen löschen

{% hint style="danger" %}
Das Löschen einer benutzerdefinierten Variable kann von Devolutions CLI nicht rückgängig gemacht werden. Exportieren Sie die Variablen zuerst, falls Sie sie wieder brauchen könnten.
{% endhint %}

```bash
devo workspace variable delete API_REGION OLD_ENDPOINT --yes
devo vault variable delete API_REGION --vault "<vault-name>" --yes
```

Sie können mehrere Variablen in einem Befehl nennen. Wenn eine davon nicht existiert oder ein Name zweimal vorkommt, schlägt der Befehl fehl und löscht nichts. Ohne `--yes` wird nichts gelöscht.

## Variablen in eine Datei exportieren

```bash
devo variable export --scope workspace --out-file variables.json
devo variable export --scope vault --vault "<vault-name>" --out-file vault-variables.json
```

<table><thead><tr><th width="200">OPTION</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>--scope</code></td><td>Erforderlich. Welche Variablen exportiert werden: <code>workspace</code>, <code>vault</code>, <code>user-vault</code> oder <code>option</code>.</td></tr><tr><td><code>--out-file</code></td><td>Erforderlich. Die zu schreibende JSON-Datei. Ihr Ordner muss bereits vorhanden sein.</td></tr><tr><td><code>--name</code></td><td>Behält nur die Variablen, deren Name übereinstimmt. Akzeptiert <code>*</code> und <code>?</code>.</td></tr><tr><td><code>--vault</code>, <code>--id</code></td><td>Für die Bereiche <code>vault</code> und <code>user-vault</code> der zu exportierende Tresor. Ohne ihn der aktuelle Tresor.</td></tr><tr><td><code>--force</code></td><td>Ersetzt die Datei, wenn sie bereits vorhanden ist. Ohne sie stoppt der Befehl.</td></tr></tbody></table>

Die Datei listet jede Variable mit Name, Wert, Beschreibung, Bereich und Quelle auf. Der Export liest die Variablen nur: Er braucht `--yes` nicht, und Sie können jeden Bereich exportieren, auch die, die Sie aus Devolutions CLI nicht ändern können.

{% hint style="warning" %}
Die exportierte Datei enthält die Werte im Klartext, außer den geschwärzten, und anders als die Datei, die `devo secret inject --out-file` schreibt, macht Devolutions CLI sie nicht privat. Committen Sie sie nicht, und löschen Sie sie, wenn Sie sie nicht mehr brauchen.
{% endhint %}

## Gut zu wissen

* `set` und `delete` ändern nur die Bereiche `workspace` und `vault`.
* Änderungen brauchen eine unverschlüsselte lokale Datenbank. Wenn das Profil nicht sicher geändert werden kann, erklärt der Befehl warum und ändert nichts.
* Fügen Sie `--output json` hinzu, um das Ergebnis in einem Skript zu lesen. Siehe [Ergebnisse als JSON lesen](/cli/de/fur-devops-und-administratoren/automate/json-output.md).
* Ein Befehl, der für Ihren Workspace-Typ abgelehnt wird: siehe [Ein Befehl sagt, dass der Workspace ihn nicht unterstützt](/cli/de/hilfe/troubleshooting/not-supported.md).

## Weiter

* [Manage vaults and entries](/cli/de/fur-devops-und-administratoren/manage/vaults-and-entries.md)
* [Compare workspace types](/cli/de/anleitungen/understand/workspace-types.md)
* Jede Option dieser Befehle: [Befehle](/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/custom-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.