> 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/sign-in-and-contexts.md).

# Anmelde- und Kontextbefehle

Jede Option von devo login, logout, status, info und den devo context-Befehlen, mit Standardwerten, erlaubten Werten und den Regeln, die Devolutions CLI prüft.

Diese Seite listet jedes Argument und jede Option der Befehle, die Ihre Workspaces speichern, auswählen und prüfen: `devo login`, `devo logout`, `devo status`, `devo info` und `devo context`. Eine Übersicht aller Befehle steht in [Befehle](/cli/de/referenz/commands.md). Für Hilfe Schritt für Schritt siehe [Bei Devolutions Cloud anmelden](/cli/de/anleitungen/connect/devolutions-cloud.md), [Bei Devolutions Server anmelden](/cli/de/anleitungen/connect/devolutions-server.md), [Ein lokales Profil von Devolutions Remote Desktop Manager verwenden](/cli/de/anleitungen/connect/local-profile.md) und [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md).

Die Optionen, die jeder Befehl akzeptiert, etwa `--context`, `--source` oder `--output json`, stehen in [Globale Optionen](/cli/de/referenz/global-options.md).

{% hint style="info" %}
Ein **Kontext** ist ein gespeicherter Workspace: eine Anmeldung bei Devolutions Cloud, eine Anmeldung bei Devolutions Server oder ein lokales Profil. Kontextnamen werden ohne Beachtung der Groß- und Kleinschreibung verglichen, daher sind `Prod` und `prod` derselbe Kontext.
{% endhint %}

## devo login

Speichert einen Workspace als Kontext: Meldet sich bei Devolutions Cloud oder Devolutions Server an oder zeigt auf den Ordner eines lokalen Profils von Devolutions Remote Desktop Manager. Der neue Kontext wird zum aktuellen, es sei denn, Sie fügen `--no-set-current` hinzu.

**Workspace:** Alle Workspace-Typen

```bash
devo login <name> --cloud <url> --oauth
devo login <name> --cloud <url> --application-key <key> --application-secret-env <variable>
devo login <name> --server <url> --api-key-env <variable>
devo login <name> --server <url> --username <username> --password-env <variable>
devo login <name> --sqlite <folder>
```

Übergeben Sie genau eines von `--cloud`, `--server` oder `--sqlite`. Ohne eines davon oder mit mehr als einem bricht der Befehl ab, bevor er irgendetwas kontaktiert.

<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>Name des zu erstellenden Kontexts. Erforderlich. Er darf nicht leer sein. Er darf kein Name sein, den bereits ein Kontext eines anderen Typs verwendet: Wählen Sie einen anderen Namen, oder löschen Sie zuerst den anderen Kontext.</td></tr><tr><td><code>--cloud &#x3C;url></code></td><td></td><td>Adresse von Devolutions Cloud, zum Beispiel <code>https://example.devolutions.app</code>. Sie muss eine absolute Adresse <code>https</code> ohne Benutzername oder Passwort sein; einfaches <code>http</code> wird nur für eine Loopback-Adresse wie <code>localhost</code> akzeptiert. Eine erneute Anmeldung mit dem Namen eines vorhandenen Kontexts von Devolutions Cloud ersetzt ihn.</td></tr><tr><td><code>--server &#x3C;url></code></td><td></td><td>Adresse von Devolutions Server. Dieselben Regeln wie <code>--cloud</code>: absolute <code>https</code>-Adresse, <code>http</code> nur für eine Loopback-Adresse, ohne Benutzername oder Passwort darin.</td></tr><tr><td><code>--sqlite &#x3C;folder></code></td><td></td><td>Ordner des lokalen Profils von Devolutions Remote Desktop Manager, der den SQLite-Workspace enthält. Umgebungsvariablen im Pfad werden erweitert. Es wird nichts angemeldet: Der Kontext zeigt nur auf den Ordner. Die Anmeldeoptionen unten werden mit <code>--sqlite</code> ignoriert.</td></tr><tr><td><code>--oauth</code></td><td>Aus</td><td>Devolutions Cloud oder Devolutions Server: meldet sich über Ihren Browser an. Devolutions CLI gibt die Anmeldeadresse jedes Mal auf der Fehlerausgabe aus, falls der Browser sich nicht öffnet. Verwendet eine lokale Browserumleitung, sofern Sie nicht <code>--use-device-code</code> hinzufügen. Kann nicht mit den Optionen des Anwendungsschlüssels (Devolutions Cloud) oder mit einem API-Schlüssel, Benutzernamen, Passwort, einer Domäne oder einer Anwendungsbenutzer-Option (Devolutions Server) kombiniert werden.</td></tr><tr><td><code>--use-device-code</code></td><td>Aus</td><td>Nur mit <code>--oauth</code>: meldet sich mit einem Gerätecode an statt mit der lokalen Browserumleitung, für einen Computer ohne Browser. Das Setzen der Umgebungsvariable <code>DEVO_CLI_USE_DEVICE_CODE</code> hat dieselbe Wirkung. Bei Devolutions Cloud erhält eine Anmeldung mit Gerätecode keinen Kontoschlüssel, daher funktionieren nur <code>devo status</code> und <code>devo logout</code>: Melden Sie sich ohne <code>--use-device-code</code> an, um vollen Zugriff zu erhalten. Abgelehnt ohne <code>--oauth</code>.</td></tr><tr><td><code>--application-key &#x3C;key></code> (<code>--app-key</code>)</td><td></td><td>Nur Devolutions Cloud: Anwendungsschlüssel. Erforderlich für eine Anmeldung bei Devolutions Cloud ohne <code>--oauth</code>. Er darf keine Steuerzeichen enthalten. Abgelehnt mit <code>--oauth</code> und mit <code>--server</code>.</td></tr><tr><td><code>--application-secret-env &#x3C;variable></code> (<code>--app-secret-env</code>)</td><td></td><td>Nur Devolutions Cloud: Name der Umgebungsvariable, die das Anwendungsgeheimnis enthält. Verwenden Sie diese Option oder <code>--application-secret-file</code>, nicht beides. Die Variable muss vorhanden sein und ihr Wert darf nicht leer sein.</td></tr><tr><td><code>--application-secret-file &#x3C;path></code> (<code>--app-secret-file</code>)</td><td></td><td>Nur Devolutions Cloud: Datei, die das Anwendungsgeheimnis enthält. Zeilenumbrüche am Ende der Datei werden ignoriert.</td></tr><tr><td><code>--api-key-env &#x3C;variable></code></td><td></td><td>Nur Devolutions Server: Name der Umgebungsvariable, die den API-Schlüssel enthält. Verwenden Sie diese Option oder <code>--api-key-file</code>, nicht beides. Kann nicht mit <code>--username</code>, einer Passwortoption, <code>--domain-id</code> oder <code>--as-application</code> kombiniert werden.</td></tr><tr><td><code>--api-key-file &#x3C;path></code></td><td></td><td>Nur Devolutions Server: Datei, die den API-Schlüssel enthält.</td></tr><tr><td><code>--username &#x3C;username></code></td><td></td><td>Nur Devolutions Server: Benutzername, für die Anmeldung mit Benutzername und Passwort. Benötigt <code>--password-env</code> oder <code>--password-file</code>.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Nur Devolutions Server: Name der Umgebungsvariable, die das Passwort enthält. Verwenden Sie diese Option oder <code>--password-file</code>, nicht beides. Benötigt <code>--username</code>.</td></tr><tr><td><code>--password-file &#x3C;path></code></td><td></td><td>Nur Devolutions Server: Datei, die das Passwort enthält. Benötigt <code>--username</code>.</td></tr><tr><td><code>--windows-auth</code></td><td>Aus</td><td>Nur Devolutions Server: meldet sich mit Windows-Authentifizierung an. Funktioniert nur unter Windows. Kann nicht mit <code>--username</code>, einer Passwortoption, <code>--domain-id</code> oder <code>--as-application</code> kombiniert werden.</td></tr><tr><td><code>--as-application</code></td><td>Aus</td><td>Nur Devolutions Server: Mit <code>--username</code> und einer Passwortoption meldet es sich als Anwendungsbenutzer an.</td></tr><tr><td><code>--domain-id &#x3C;id></code></td><td></td><td>Nur Devolutions Server: Domänen-ID, für die Domänenauthentifizierung mit <code>--username</code> und einer Passwortoption.</td></tr><tr><td><code>--timeout &#x3C;seconds></code></td><td><code>15</code></td><td>Devolutions Cloud und Devolutions Server: Zeitlimit der Anfragen während der Anmeldung, von 3 bis 600 Sekunden. Jeder andere Wert wird abgelehnt. Der Wert wird nicht mit dem Kontext gespeichert: Er gilt nur für diese Anmeldung.</td></tr><tr><td><code>--no-set-current</code></td><td>Aus</td><td>Speichert den Kontext, ohne ihn zum aktuellen zu machen. Bei einem lokalen Profil wird der neue Kontext trotzdem der aktuelle, wenn noch kein Kontext aktuell ist.</td></tr><tr><td><code>--workspace &#x3C;name></code></td><td></td><td>Nur lokales Profil: Standard-Workspace, mit dem Kontext als Hinweis für Personen und Agenten gespeichert. Abgelehnt mit <code>--cloud</code> oder <code>--server</code>.</td></tr><tr><td><code>--vault &#x3C;name></code></td><td></td><td>Nur lokales Profil: Standardtresor, mit dem Kontext als Hinweis für Personen und Agenten gespeichert. Abgelehnt mit <code>--cloud</code> oder <code>--server</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Nur lokales Profil: Beschreibung des Kontexts. Abgelehnt mit <code>--cloud</code> oder <code>--server</code>.</td></tr><tr><td><code>--replace</code></td><td>Aus</td><td>Nur lokales Profil: ersetzt einen vorhandenen Kontext eines lokalen Profils mit demselben Namen. Ohne die Option wird dieser Name abgelehnt. Abgelehnt mit <code>--cloud</code> oder <code>--server</code>.</td></tr></tbody></table>

### Anmeldemethoden auf einen Blick

<table><thead><tr><th width="220">WORKSPACE</th><th>WÄHLEN SIE GENAU EINE VON</th></tr></thead><tbody><tr><td>Devolutions Cloud</td><td><code>--oauth</code> (optional mit <code>--use-device-code</code>) oder <code>--application-key</code> mit <code>--application-secret-env</code> oder <code>--application-secret-file</code>.</td></tr><tr><td>Devolutions Server</td><td><code>--oauth</code> (optional mit <code>--use-device-code</code>), <code>--api-key-env</code> oder <code>--api-key-file</code>, <code>--username</code> mit <code>--password-env</code> oder <code>--password-file</code> (optional mit <code>--domain-id</code> oder <code>--as-application</code>) oder <code>--windows-auth</code>. Ohne Anmeldemethode, oder mit mehr als einer, stoppt der Befehl.</td></tr><tr><td>Lokales Profil</td><td>Ohne Anmeldung: <code>--sqlite &#x3C;folder></code>, optional mit <code>--workspace</code>, <code>--vault</code>, <code>--description</code> und <code>--replace</code>.</td></tr></tbody></table>

{% hint style="info" %}
Devolutions CLI speichert keine Anwendungsgeheimnisse, API-Schlüssel oder Passwörter. Es speichert den Namen der Umgebungsvariable oder den Pfad der Datei und liest den Wert jedes Mal erneut, wenn ein Befehl ihn braucht. Lassen Sie diese Variable gesetzt, oder diese Datei an ihrem Platz, solange Sie den Kontext verwenden. Eine Browseranmeldung wird im sicheren Speicher Ihres Betriebssystems aufbewahrt.
{% endhint %}

Bevor es einen Kontext von Devolutions Cloud oder Devolutions Server speichert, prüft `devo login` die Anmeldung beim Workspace. Wenn die Prüfung fehlschlägt, wird nichts gespeichert. Fehler in den Optionen selbst stoppen den Befehl mit Exitcode `2`; eine fehlgeschlagene Anmeldung endet mit `1`. Siehe [Exitcodes und Fehler](/cli/de/referenz/exit-codes-and-errors.md).

## devo logout

Löscht die gespeicherte Anmeldung eines Kontexts von Devolutions Cloud oder Devolutions Server. Der Kontext selbst bleibt erhalten: Melden Sie sich erneut mit `devo login` an, oder löschen Sie ihn mit `devo context delete`.

**Workspace:** Devolutions Cloud, Devolutions Server

```bash
devo logout [<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>Aktueller Kontext</td><td>Kontext, von dem abgemeldet werden soll. Ohne ihn wird der aktuelle Kontext verwendet; wenn kein Kontext aktuell ist, stoppt der Befehl und fragt nach einem Namen. Ein Kontext eines lokalen Profils wird abgelehnt, weil er keine Anmeldung hat. Bei einer Browseranmeldung wird die im sicheren Speicher gehaltene Sitzung ebenfalls gelöscht.</td></tr></tbody></table>

## devo status

Zeigt den ausgewählten Workspace: seinen Kontext, seine Art und, für Devolutions Cloud oder Devolutions Server, ob Sie angemeldet sind.

**Workspace:** Alle Workspace-Typen

```bash
devo status [<name>] [--online]
```

<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>Ausgewählter Workspace</td><td>Anzuzeigender Kontext. Ohne ihn wird der Workspace angezeigt, der durch <code>--source</code>, <code>--context</code> oder den aktuellen Kontext ausgewählt ist. Ein unbekannter Name ist ein Fehler. Bei einem lokalen Profil zeigt der Status den Kontext und seinen Profilordner. Mit <code>--source cloud</code> oder <code>--source server</code> und ohne Kontextnamen wird der aktuelle Kontext dieser Art verwendet; gibt es keinen, sagt der Status, dass Sie nicht angemeldet sind, statt zu scheitern.</td></tr><tr><td><code>--online</code></td><td>Aus</td><td>Devolutions Cloud und Devolutions Server: Kontaktiert den Workspace, um zu prüfen, ob die Anmeldung noch funktioniert. Wenn die Prüfung fehlschlägt, meldet der Befehl den Fehler und endet mit Code <code>1</code>. Ohne <code>--online</code> kommt der Status von dem, was auf Ihrem Computer gespeichert ist, und es wird nichts kontaktiert. Hat keine Wirkung auf ein lokales Profil.</td></tr></tbody></table>

## devo info

Zeigt Informationen über eine Devolutions Cloud- oder Devolutions Server-Instanz, für einen gespeicherten Kontext oder für eine Adresse, ohne Anmeldung.

**Workspace:** Devolutions Cloud, Devolutions Server

```bash
devo info [<name>]
devo info --cloud <url>
devo info --server <url>
devo info <name> --private
```

<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>Ausgewählter Workspace</td><td>Abzufragender Kontext. Ohne ihn und ohne Adresse wird der ausgewählte Workspace verwendet. Ein lokales Profil wird abgelehnt: Der Befehl funktioniert nur mit Devolutions Cloud und Devolutions Server. Kann nicht mit <code>--cloud</code> oder <code>--server</code> kombiniert werden. Mit einem gespeicherten Kontext und ohne <code>--private</code> werden nur öffentliche Informationen zurückgegeben, und die Anmeldung des Kontexts wird nicht verwendet.</td></tr><tr><td><code>--cloud &#x3C;url></code></td><td></td><td>Devolutions Cloud-Adresse, die ohne gespeicherten Kontext abgefragt wird. Dieselben Adressregeln wie <code>devo login</code>. Kann nicht mit <code>--server</code> oder einem Kontextnamen kombiniert werden.</td></tr><tr><td><code>--server &#x3C;url></code></td><td></td><td>Devolutions Server-Adresse, die ohne gespeicherten Kontext abgefragt wird. Es werden nur öffentliche Informationen zurückgegeben. Kann nicht mit <code>--cloud</code> oder einem Kontextnamen kombiniert werden.</td></tr><tr><td><code>--private</code></td><td>Aus</td><td>Nur Devolutions Server: fügt private Informationen hinzu, mit der Anmeldung eines gespeicherten Kontexts. Abgelehnt mit <code>--server &#x3C;url></code> und für Devolutions Cloud abgelehnt.</td></tr></tbody></table>

## devo context list

Listet Ihre Kontexte jedes Workspace-Typs auf, sortiert nach Name, und zeigt, welcher aktuell ist. Alias: `devo context ls`.

**Workspace:** Alle Workspace-Typen

```bash
devo context list
```

Dieser Befehl hat keine eigenen Argumente oder Optionen.

## devo context use

Macht einen Kontext zum aktuellen. Jeder spätere Befehl verwendet ihn, bis Sie einen anderen wählen oder ihn für einen Befehl mit der globalen Option `--context <name>` außer Kraft setzen.

**Workspace:** Alle Workspace-Typen

```bash
devo context use <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></td><td>Kontext, der aktuell werden soll. Erforderlich. Wenn derselbe Name für mehr als eine Art von Kontext vorhanden ist, stoppt der Befehl und sagt Ihnen, einen davon mit <code>devo context delete &#x3C;name> --kind &#x3C;kind></code> zu löschen.</td></tr></tbody></table>

## devo context inspect

Zeigt die Details eines Kontexts: seine Art, seine Adresse oder seinen Profilordner und, bei einem lokalen Profil, seinen Standard-Workspace, seinen Standardtresor und seine Beschreibung.

**Workspace:** Alle Workspace-Typen

```bash
devo context inspect [<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>Aktueller Kontext</td><td>Anzuzeigender Kontext. Ohne diese Option wird der aktuelle Kontext angezeigt; wenn kein Kontext aktuell ist, stoppt der Befehl und fragt nach einem Namen.</td></tr></tbody></table>

## devo context delete

Entfernt einen Kontext. Alias: `devo context rm`. Wenn er der aktuelle Kontext war, ist danach kein Kontext aktuell.

**Workspace:** Alle Workspace-Typen

```bash
devo context delete <name> [--kind <kind>] [--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>Zu löschender Kontext. Erforderlich. Das Löschen eines lokalen Profilkontexts entfernt nur den Kontext: Der Profilordner wird nicht verändert.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td></td><td>Art des zu löschenden Kontexts, wenn derselbe Name für mehr als eine Art vorhanden ist: <code>sqlite</code> (lokales Profil), <code>cloud</code> oder <code>server</code>. Jeder andere Wert wird abgelehnt.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Aus</td><td>Bestätigt das Löschen eines Kontexts von Devolutions Cloud oder Devolutions Server, was auch seine gespeicherte Anmeldung verwirft. Ohne diese Option wird ein solcher Kontext nicht gelöscht. Für einen Kontext eines lokalen Profils nicht nötig.</td></tr></tbody></table>

## Weiter

* [Secret commands](/cli/de/referenz/commands/secrets.md)
* [MCP, background process, and configuration commands](/cli/de/referenz/commands/mcp-daemon-config.md)
* [Global options](/cli/de/referenz/global-options.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/sign-in-and-contexts.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.