> 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/quick-start.md).

# Schnellstart

Installieren Sie Devolutions CLI, melden Sie sich bei Ihrem Tresor an, und führen Sie einen Befehl mit einem Geheimnis aus, das er nie anzeigt, in etwa fünf Minuten.

Am Ende dieser Seite führen Sie einen Befehl aus, der ein Passwort aus Ihrem Devolutions-Tresor erhält, ohne dass das Passwort in Ihrem Terminal, Ihren Dateien oder Ihrer Shell-Historie erscheint. Das dauert etwa fünf Minuten.

Sie brauchen ein Konto bei Devolutions Cloud oder Devolutions Server oder ein lokales Devolutions Remote Desktop Manager-Profil mit mindestens einem Eintrag, den Sie lesen können.

{% stepper %}
{% step %}

### Devolutions CLI installieren

Devolutions CLI kommt als Archiv für Ihre Plattform. Extrahieren Sie es in einen Ordner, fügen Sie diesen Ordner zu Ihrem `PATH` hinzu, und prüfen Sie, dass Ihr Terminal `devo` findet (`devo.exe` unter Windows):

```bash
devo --help
```

Andere Installationsarten und die unterstützten Plattformen stehen in [Devolutions CLI installieren](/cli/de/referenz/installation.md).
{% endstep %}

{% step %}

### Bei Ihrem Workspace anmelden

Speichern Sie Ihren Workspace als **Kontext**, einen Namen, den Sie von nun an verwenden. Der Kontext, bei dem Sie sich anmelden, wird der aktuelle.

{% tabs %}
{% tab title="Devolutions Cloud" %}

```bash
devo login my-cloud --cloud https://<your-organization>.devolutions.app --oauth
```

Ihr Browser öffnet sich, damit Sie sich anmelden können. Auf einem Computer ohne Browser melden Sie sich stattdessen mit einem Anwendungsschlüssel an: siehe [Bei Devolutions Cloud anmelden](/cli/de/anleitungen/connect/devolutions-cloud.md).
{% endtab %}

{% tab title="Devolutions Server" %}

```bash
devo login my-server --server https://<your-server-address> --oauth
```

Ihr Browser öffnet sich, damit Sie sich anmelden können. Andere Anmeldemethoden, etwa ein API-Schlüssel oder die Windows-Authentifizierung, stehen in [Bei Devolutions Server anmelden](/cli/de/anleitungen/connect/devolutions-server.md).
{% endtab %}

{% tab title="Local profile" %}

```bash
devo login my-local --sqlite <profile-folder>
```

Ersetzen Sie `<profile-folder>` durch den Ordner des Devolutions Remote Desktop Manager-Profils, das Ihren lokalen Workspace enthält. Es gibt keine Anmeldung: Ein lokaler Kontext zeigt nur auf diesen Ordner.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Die Referenz zu einem Passwort finden

Fragen Sie Devolutions CLI nach den Referenzen eines Eintrags. Das zeigt, wo jedes Geheimnis liegt, niemals das Geheimnis selbst.

```bash
devo entry references "<entry-name>" --vault-name "<vault-name>"
```

Kopieren Sie die Referenz des Felds `password`. Sie beginnt mit `devo://`.

{% hint style="info" %}
Zwei Arten von Referenzen können erscheinen. Eine **benannte Referenz** verwendet die Namen von Workspace, Tresor und Eintrag und ist deshalb leicht zu lesen. Eine **kanonische Referenz** (`devo://ws/…/vault/…/entry/…/field/…`) verwendet IDs und funktioniert weiter, wenn ein Eintrag umbenannt wird. Auf Devolutions Server listet dieser Befehl nur kanonische Referenzen. Siehe [Die Referenz zu einem Geheimnis finden](/cli/de/anleitungen/secrets/find-a-reference.md).
{% endhint %}
{% endstep %}

{% step %}

### Einen Befehl mit dem Geheimnis ausführen

Übergeben Sie die Referenz an `devo secret run`. Devolutions CLI liest das Passwort aus Ihrem Tresor, legt es in eine Umgebungsvariable für genau diesen Befehl und startet ihn. Alles nach `--` ist Ihr Befehl.

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

```powershell
devo secret run --env-ref DEMO_SECRET=<reference> -- pwsh -NoProfile -Command 'Write-Output $env:DEMO_SECRET'
```

{% endtab %}

{% tab title="Bash" %}

```bash
devo secret run --env-ref DEMO_SECRET=<reference> -- sh -c 'echo "$DEMO_SECRET"'
```

{% endtab %}
{% endtabs %}

Der Befehl hat das Passwort erhalten, aber das Terminal zeigt `<concealed by Devolutions>`: Devolutions CLI verbirgt die aufgelösten Werte in allem, was der Befehl ausgibt. Wenn der Befehl endet, ist die Variable weg. Sie hat in Ihrer Shell nie existiert.

Ersetzen Sie das Beispiel durch Ihr eigenes Programm, zum Beispiel eine Datenbankmigration oder ein Bereitstellungsskript, das sein Passwort aus einer Umgebungsvariable liest.

{% hint style="warning" %}
Die Maskierung schützt, was der Befehl ausgibt, nicht was er tut. Ein Programm, das ein Geheimnis erhält, kann es trotzdem in eine Datei schreiben oder irgendwohin senden. Führen Sie nur Programme aus, denen Sie Ihre Geheimnisse anvertrauen. Siehe [Was verborgen bleibt und was nicht](/cli/de/anleitungen/understand/security-model.md).
{% endhint %}
{% endstep %}

{% step %}

### Prüfen, bevor Sie ausführen (optional)

Fügen Sie `--check` hinzu, um sicherzugehen, dass der Befehl existiert und jede Referenz wohlgeformt ist, ohne ein Geheimnis zu lesen oder etwas zu starten:

```bash
devo secret run --check --env-ref DEMO_SECRET=<reference> -- <your-command>
```

Weitere Optionen, etwa mehrere Geheimnisse auf einmal, ein Zeitlimit oder eine Startdatei, stehen in [Einen Befehl mit seinen Geheimnissen ausführen](/cli/de/anleitungen/secrets/run-with-secrets.md).
{% endstep %}
{% endstepper %}

## Sie sind fertig. Was nun?

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Ihre .env-Dateien aufräumen</strong></td><td>Behalten Sie Ihre <code>.env</code>-Dateien im Repository, mit Referenzen statt Passwörtern.</td><td><a href="/cli/de/anleitungen/secrets/replace-env-files.md">Die Passwörter aus einer .env-Datei herausnehmen</a></td></tr><tr><td><strong>Sicher mit KI-Agenten arbeiten</strong></td><td>Lassen Sie einen Agenten Befehle ausführen, die Anmeldeinformationen brauchen, ohne dass die Werte in sein Transkript gelangen.</td><td><a href="/cli/de/anleitungen/ai-agents/run-an-agent.md">Einem Agenten eine Anmeldeinformation geben, ohne sie offenzulegen</a></td></tr><tr><td><strong>Automatisieren</strong></td><td>Melden Sie sich aus einer CI-Pipeline ohne Browser und ohne Eingabeaufforderung an.</td><td><a href="/cli/de/fur-devops-und-administratoren/automate/ci-sign-in.md">Aus einer CI-Pipeline anmelden</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/quick-start.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.