> 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/exit-codes-and-errors.md).

# Exitcodes und Fehler

Exitcodes von Devolutions CLI, wie Fehler in Text- und JSON-Ausgabe gemeldet werden, und die häufigsten Fehlercodes mit dem, was zu tun ist.

Jeder `devo`-Befehl gibt einen Exitcode zurück, sodass ein Skript Erfolg von Fehlschlag unterscheiden kann. Wenn ein Befehl fehlschlägt, meldet er auch einen Fehlercode, einen kurzen Bezeichner wie `invalidSecretReference`, und eine Meldung.

## Exitcodes

<table><thead><tr><th width="120">CODE</th><th>BEDEUTUNG</th></tr></thead><tbody><tr><td><code>0</code></td><td>Der Befehl war erfolgreich.</td></tr><tr><td><code>1</code></td><td>Der Befehl ist fehlgeschlagen, zum Beispiel weil der Workspace den Vorgang abgelehnt hat oder ihn nicht unterstützt.</td></tr><tr><td><code>2</code></td><td>Die Befehlszeile ist ungültig, und es wurde nichts getan: unbekannter Befehl oder unbekannte Option, fehlender oder ungültiger Wert, Optionen, die nicht kombiniert werden können, oder eine Änderung ohne <code>--yes</code>.</td></tr><tr><td><code>3</code></td><td>Der Hintergrundprozess konnte nicht erreicht werden oder hat nicht rechtzeitig geantwortet, oder er hat einen Fehler gemeldet. Ein lokales Profil, das einen Tresor- oder Eintragsbefehl nicht ausführen kann, zum Beispiel eine Tresoränderung (<code>sqliteVaultLifecycleUnavailable</code>), endet ebenfalls mit <code>3</code>. Siehe <a href="/cli/de/hilfe/troubleshooting/daemon-wont-start.md">Der Hintergrundprozess startet nicht</a>.</td></tr><tr><td><code>4</code></td><td>Ein angefordertes Element wurde nicht gefunden, etwa ein Workspace, ein Tresor, ein Eintrag, ein Benutzer oder eine Gruppe, oder ein Feld mit <code>devo secret read</code> und <code>devo secret get</code>. Einige Befehle melden ein fehlendes Element stattdessen mit <code>1</code>: zum Beispiel gibt <code>devo secret get</code> bei einem lokalen Profil <code>sqliteSecretNotFound</code> mit <code>1</code> zurück. Die Seite <a href="/cli/de/referenz/error-codes.md">Fehlercodes</a> nennt den Exitcode jedes Fehlers.</td></tr><tr><td><code>124</code></td><td>Nur <code>devo secret run</code>: der Befehl hat <code>--timeout-seconds</code> überschritten und wurde gestoppt.</td></tr><tr><td><code>130</code></td><td>Der Befehl wurde unterbrochen, zum Beispiel mit <kbd>Strg</kbd>+<kbd>C</kbd>. Mit <code>devo secret run</code> wurde der Befehl, den er gestartet hatte, abgebrochen.</td></tr></tbody></table>

### `devo secret run`

Wenn der Befehl, den es startet, bis zum Ende läuft, endet `devo secret run` mit **dem Exitcode dieses Befehls**, sodass Ihre Skripte und Pipelines dasselbe Ergebnis sehen, als hätten sie den Befehl direkt ausgeführt. Die Exitcodes `124` und `130` gelten nur, wenn der Befehl gestoppt wird. Wenn `devo secret run` die mit `--receipt-file` angegebene Datei nicht schreiben kann, endet es mit `1`.

Bevor der Befehl startet, endet ein ungültiges `--env-file` oder eine Referenz, die eine fehlende Umgebungsvariable braucht, mit `2`; ein anderer Fehler beim Lesen eines Geheimnisses endet mit `1`.

## Wie Fehler gemeldet werden

* **Textausgabe** (der Standard): Der Fehler wird als `<code>: <message>` geschrieben, meist in die Fehlerausgabe. Fehler der Befehle, die nur mit Devolutions Cloud oder Devolutions Server funktionieren, etwa die meisten `devo admin`-Befehle, gehen an die Standardausgabe. Bei einer ungültigen Befehlszeile folgt die Hilfe des Befehls.
* **JSON- oder YAML-Ausgabe**: Der Fehler geht an die Standardausgabe, in derselben Hülle wie ein Ergebnis, mit `status` auf `error` gesetzt und einer Liste `errors`. Jeder Fehler hat einen `code` und eine `message`. Eine ungültige Befehlszeile gibt den Code `usageError` zurück, und `usageSuggestion`, wenn Devolutions CLI eine Korrektur vorschlagen kann. Siehe [Ergebnisse als JSON lesen](/cli/de/fur-devops-und-administratoren/automate/json-output.md).
* **`devo secret run`**: Unabhängig vom Ausgabeformat werden die Fehler, die beim Lesen der Geheimnisse oder beim Ausführen des Befehls auftreten (Zeitlimit, Abbruch, Standardeingabe), als reiner `<code>: <message>`-Text in die Fehlerausgabe geschrieben.

## Häufige Fehlercodes

Die Tabelle unten listet die Fehlercodes auf, denen Sie am häufigsten begegnen. Für jeden Fehlercode siehe [Fehlercodes](/cli/de/referenz/error-codes.md).

<table><thead><tr><th width="270">FEHLERCODE</th><th>WAS ES BEDEUTET</th><th>WAS ZU TUN IST</th></tr></thead><tbody><tr><td><code>usageError</code></td><td>Unbekannter Befehl oder unbekannte Option, oder fehlendes Argument.</td><td>Prüfen Sie die Schreibweise mit <code>devo &#x3C;command> --help</code>. Siehe <a href="/cli/de/referenz/commands.md">Befehle</a>.</td></tr><tr><td><code>conflictingOptions</code></td><td>Zwei Optionen, die nicht zusammen verwendet werden können, etwa <code>--json</code> und <code>--yaml</code> oder <code>--quiet</code> und <code>--verbose</code>.</td><td>Behalten Sie eines. Siehe <a href="/cli/de/referenz/global-options.md#options-that-cant-be-combined">Globale Optionen</a>.</td></tr><tr><td><code>missingParameter</code>, <code>invalidParameterValue</code></td><td>Ein erforderlicher Wert fehlt, oder ein Wert ist nicht zulässig.</td><td>Lesen Sie die Meldung: sie nennt die Option. Prüfen Sie die zulässigen Werte mit <code>--help</code>.</td></tr><tr><td><code>invalidSource</code></td><td>Der Wert <code>--source</code> ist ungültig.</td><td>Verwenden Sie <code>sqlite</code>, <code>cloud[:&#x3C;context>]</code> oder <code>server[:&#x3C;context>]</code>.</td></tr><tr><td><code>confirmationRequired</code>, <code>mutationConfirmationRequired</code></td><td>Der Befehl ändert oder löscht etwas und wurde nicht bestätigt.</td><td>Fügen Sie <code>--yes</code> hinzu, sobald Sie sicher sind.</td></tr><tr><td><code>rawSensitiveValueRejected</code></td><td>Ein Geheimnis wurde so übergeben, dass es offengelegt werden könnte, etwa ein Passwort als Klartextfeldwert.</td><td>Verwenden Sie <code>devo secret set</code> mit <code>--value-env</code> oder <code>--value-file</code>. Siehe <a href="/cli/de/anleitungen/secrets/update-a-secret.md">Ein Geheimnis aus einem Skript aktualisieren</a>.</td></tr><tr><td><code>invalidSecretReference</code></td><td>Die Referenz ist nicht richtig geschrieben.</td><td>Siehe die Meldungen in <a href="/cli/de/referenz/secret-references.md#rules-and-errors">Syntax der Geheimnisreferenz</a>.</td></tr><tr><td><code>unsupportedSecretAttribute</code></td><td>Der Wert <code>?attribute=</code> ist nicht bekannt.</td><td>Verwenden Sie <code>value</code>, <code>type</code>, <code>id</code>, <code>title</code> oder <code>purpose</code>. <code>otp</code> wird in einer Referenz akzeptiert, aber kein Workspace-Typ gibt einen Wert dafür zurück. Siehe <a href="/cli/de/referenz/secret-references.md#attributes">Attribute</a>.</td></tr><tr><td><code>missingSecretReferenceVariable</code></td><td>Eine Referenz in einer Vorlage verwendet eine Umgebungsvariable, die nicht gesetzt ist.</td><td>Setzen Sie die Variable, oder geben Sie ihr mit <code>${NAME:-default}</code> einen Standardwert. Siehe <a href="/cli/de/referenz/secret-references.md#references-inside-a-text">Referenzen in einem Text</a>.</td></tr><tr><td><code>secretLaunchArgumentReference</code></td><td>Eine Referenz <code>devo://</code> wurde als Argument des auszuführenden Befehls geschrieben.</td><td>Übergeben Sie sie mit <code>--env-ref</code>, <code>--stdin-reference</code> oder <code>--manifest</code>. Siehe <a href="/cli/de/anleitungen/secrets/run-with-secrets.md">Einen Befehl mit seinen Geheimnissen ausführen</a>.</td></tr><tr><td><code>secretLaunchTimedOut</code></td><td>Der von <code>devo secret run</code> gestartete Befehl hat <code>--timeout-seconds</code> überschritten.</td><td>Erhöhen Sie das Zeitlimit, oder finden Sie heraus, warum der Befehl so lange dauert.</td></tr><tr><td><code>secretLaunchCancelled</code>, <code>interrupted</code></td><td>Der Befehl wurde unterbrochen.</td><td>Führen Sie ihn erneut aus.</td></tr><tr><td><code>operationNotSupportedBySource</code></td><td>Der ausgewählte Workspace-Typ kann diesen Befehl nicht ausführen.</td><td>Wählen Sie mit <code>--context</code> einen anderen Workspace. Siehe <a href="/cli/de/hilfe/troubleshooting/not-supported.md">Ein Befehl sagt, dass der Workspace ihn nicht unterstützt</a>.</td></tr><tr><td><code>cloudContextNotFound</code></td><td>Kein Devolutions Cloud-Kontext mit diesem Namen, oder kein aktueller.</td><td>Prüfen Sie <code>devo context list</code>, oder melden Sie sich mit <code>devo login</code> an. Siehe <a href="/cli/de/hilfe/troubleshooting/sign-in-fails.md">Die Anmeldung schlägt fehl oder die Sitzung ist abgelaufen</a>.</td></tr><tr><td><code>daemonUnavailable</code>, <code>daemonTimeout</code>, <code>daemonIoError</code></td><td>Der Hintergrundprozess war nicht erreichbar, hat nicht rechtzeitig geantwortet, oder die Verbindung ist abgebrochen.</td><td>Führen Sie <code>devo daemon status</code> aus, dann <code>devo daemon restart</code>. Siehe <a href="/cli/de/hilfe/troubleshooting/daemon-wont-start.md">Der Hintergrundprozess startet nicht</a>.</td></tr><tr><td><code>unexpectedError</code></td><td>Ein Fehler, den Devolutions CLI nicht erwartet hat.</td><td>Führen Sie <code>devo doctor</code> aus und kontaktieren Sie den Support. Siehe <a href="/cli/de/hilfe/troubleshooting/collect-diagnostics.md">Diagnosedaten für den Support erfassen</a>.</td></tr></tbody></table>


---

# 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/exit-codes-and-errors.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.
