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

# Commandes de connexion et de contexte

Chaque option de devo login, logout, status, info et des commandes devo context, avec les valeurs par défaut, les valeurs permises et les règles que Devolutions CLI vérifie.

Cette page énumère chaque argument et chaque option des commandes qui enregistrent, sélectionnent et inspectent vos espaces de travail : `devo login`, `devo logout`, `devo status`, `devo info` et `devo context`. Pour un aperçu de toutes les commandes, consultez [Commandes](/cli/fr/reference/commands.md). Pour une aide étape par étape, consultez [Se connecter à Devolutions Cloud](/cli/fr/guides/connect/devolutions-cloud.md), [Se connecter à Devolutions Server](/cli/fr/guides/connect/devolutions-server.md), [Utiliser un profil local Devolutions Remote Desktop Manager](/cli/fr/guides/connect/local-profile.md) et [Basculer entre les espaces de travail](/cli/fr/guides/connect/switch-workspaces.md).

Les options que chaque commande accepte, telles que `--context`, `--source` ou `--output json`, se trouvent dans [Options globales](/cli/fr/reference/global-options.md).

{% hint style="info" %}
Un **contexte** est un espace de travail enregistré : une connexion Devolutions Cloud, une connexion Devolutions Server ou un profil local. Les noms de contexte sont comparés sans tenir compte de la casse, donc `Prod` et `prod` sont le même contexte.
{% endhint %}

## devo login

Enregistre un espace de travail comme contexte : se connecte à Devolutions Cloud ou Devolutions Server, ou pointe vers le dossier d’un profil local Devolutions Remote Desktop Manager. Le nouveau contexte devient le contexte actuel, sauf si vous ajoutez `--no-set-current`.

**Espace de travail :** Tous les types d’espace de travail

```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>
```

Passez exactement l’un de `--cloud`, `--server` ou `--sqlite`. Sans aucun d’eux, ou avec plus d’un, la commande s’arrête avant de contacter quoi que ce soit.

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Nom du contexte à créer. Obligatoire. Il ne peut pas être vide. Il ne peut pas être un nom déjà utilisé par un contexte d’un autre type : choisissez un autre nom, ou supprimez d’abord l’autre contexte.</td></tr><tr><td><code>--cloud &#x3C;url></code></td><td></td><td>Adresse Devolutions Cloud, par exemple <code>https://example.devolutions.app</code>. Elle doit être une adresse <code>https</code> absolue sans nom d’utilisateur ni mot de passe ; le <code>http</code> simple n’est accepté que pour une adresse de bouclage comme <code>localhost</code>. Se connecter de nouveau avec le nom d’un contexte Devolutions Cloud existant le remplace.</td></tr><tr><td><code>--server &#x3C;url></code></td><td></td><td>Adresse de Devolutions Server. Mêmes règles que <code>--cloud</code> : adresse <code>https</code> absolue, <code>http</code> seulement pour une adresse de bouclage, sans nom d’utilisateur ni mot de passe.</td></tr><tr><td><code>--sqlite &#x3C;folder></code></td><td></td><td>Dossier du profil local Devolutions Remote Desktop Manager qui contient l’espace de travail SQLite. Les variables d’environnement du chemin sont développées. Aucune connexion n’est faite : le contexte ne fait que pointer vers le dossier. Les options de connexion ci-dessous sont ignorées avec <code>--sqlite</code>.</td></tr><tr><td><code>--oauth</code></td><td>Désactivé</td><td>Devolutions Cloud ou Devolutions Server : se connecte par votre navigateur. Devolutions CLI affiche l’adresse de connexion sur la sortie d’erreur à chaque fois, au cas où le navigateur ne s’ouvrirait pas. Utilise une redirection du navigateur local, à moins que vous n’ajoutiez <code>--use-device-code</code>. Ne peut pas être combiné avec les options de clé d’application (Devolutions Cloud), ni avec une clé d’API, un nom d’utilisateur, un mot de passe, un domaine ou une option d’utilisateur d’application (Devolutions Server).</td></tr><tr><td><code>--use-device-code</code></td><td>Désactivé</td><td>Avec <code>--oauth</code> seulement : se connecte avec un code d’appareil au lieu de la redirection du navigateur local, pour un ordinateur sans navigateur. Définir la variable d’environnement <code>DEVO_CLI_USE_DEVICE_CODE</code> a le même effet. Avec Devolutions Cloud, une connexion par code d’appareil n’obtient pas de clé de compte, donc seuls <code>devo status</code> et <code>devo logout</code> fonctionnent : connectez-vous sans <code>--use-device-code</code> pour un accès complet. Refusé sans <code>--oauth</code>.</td></tr><tr><td><code>--application-key &#x3C;key></code> (<code>--app-key</code>)</td><td></td><td>Devolutions Cloud seulement : clé d’application. Obligatoire pour une connexion Devolutions Cloud sans <code>--oauth</code>. Elle ne peut pas contenir de caractères de contrôle. Refusée avec <code>--oauth</code> et avec <code>--server</code>.</td></tr><tr><td><code>--application-secret-env &#x3C;variable></code> (<code>--app-secret-env</code>)</td><td></td><td>Devolutions Cloud seulement : nom de la variable d’environnement qui contient le secret d’application. Utilisez cette option ou <code>--application-secret-file</code>, pas les deux. La variable doit exister et sa valeur ne peut pas être vide.</td></tr><tr><td><code>--application-secret-file &#x3C;path></code> (<code>--app-secret-file</code>)</td><td></td><td>Devolutions Cloud seulement : fichier qui contient le secret d’application. Les sauts de ligne à la fin du fichier sont ignorés.</td></tr><tr><td><code>--api-key-env &#x3C;variable></code></td><td></td><td>Devolutions Server seulement : nom de la variable d’environnement qui contient la clé d’API. Utilisez cette option ou <code>--api-key-file</code>, pas les deux. Ne peut pas être combinée avec <code>--username</code>, une option de mot de passe, <code>--domain-id</code> ou <code>--as-application</code>.</td></tr><tr><td><code>--api-key-file &#x3C;path></code></td><td></td><td>Devolutions Server seulement : fichier qui contient la clé d’API.</td></tr><tr><td><code>--username &#x3C;username></code></td><td></td><td>Devolutions Server seulement : nom d’utilisateur, pour une connexion par nom d’utilisateur et mot de passe. Nécessite <code>--password-env</code> ou <code>--password-file</code>.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Devolutions Server seulement : nom de la variable d’environnement qui contient le mot de passe. Utilisez cette option ou <code>--password-file</code>, pas les deux. Nécessite <code>--username</code>.</td></tr><tr><td><code>--password-file &#x3C;path></code></td><td></td><td>Devolutions Server seulement : fichier qui contient le mot de passe. Nécessite <code>--username</code>.</td></tr><tr><td><code>--windows-auth</code></td><td>Désactivé</td><td>Devolutions Server seulement : se connecte avec l’authentification Windows. Fonctionne sur Windows seulement. Ne peut pas être combiné avec <code>--username</code>, une option de mot de passe, <code>--domain-id</code> ou <code>--as-application</code>.</td></tr><tr><td><code>--as-application</code></td><td>Désactivé</td><td>Devolutions Server seulement : avec <code>--username</code> et une option de mot de passe, se connecte en tant qu’utilisateur d’application.</td></tr><tr><td><code>--domain-id &#x3C;id></code></td><td></td><td>Devolutions Server seulement : ID de domaine, pour l’authentification de domaine avec <code>--username</code> et une option de mot de passe.</td></tr><tr><td><code>--timeout &#x3C;seconds></code></td><td><code>15</code></td><td>Devolutions Cloud et Devolutions Server : délai des requêtes faites pendant la connexion, de 3 à 600 secondes. Toute autre valeur est refusée. La valeur n’est pas enregistrée avec le contexte : elle ne s’applique qu’à cette connexion.</td></tr><tr><td><code>--no-set-current</code></td><td>Désactivé</td><td>Enregistre le contexte sans le rendre actuel. Pour un profil local, le nouveau contexte devient quand même le contexte actuel lorsqu’aucun contexte n’est encore actuel.</td></tr><tr><td><code>--workspace &#x3C;name></code></td><td></td><td>Profil local seulement : espace de travail par défaut, enregistré avec le contexte comme indication pour les personnes et les agents. Refusé avec <code>--cloud</code> ou <code>--server</code>.</td></tr><tr><td><code>--vault &#x3C;name></code></td><td></td><td>Profil local seulement : coffre par défaut, enregistré avec le contexte comme indication pour les personnes et les agents. Refusé avec <code>--cloud</code> ou <code>--server</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Profil local seulement : description du contexte. Refusé avec <code>--cloud</code> ou <code>--server</code>.</td></tr><tr><td><code>--replace</code></td><td>Désactivé</td><td>Profil local seulement : remplace un contexte de profil local existant du même nom. Sans cette option, ce nom est refusé. Refusée avec <code>--cloud</code> ou <code>--server</code>.</td></tr></tbody></table>

### Méthodes de connexion en un coup d’œil

<table><thead><tr><th width="220">ESPACE DE TRAVAIL</th><th>CHOISISSEZ-EN EXACTEMENT UNE</th></tr></thead><tbody><tr><td>Devolutions Cloud</td><td><code>--oauth</code> (éventuellement avec <code>--use-device-code</code>), ou <code>--application-key</code> avec <code>--application-secret-env</code> ou <code>--application-secret-file</code>.</td></tr><tr><td>Devolutions Server</td><td><code>--oauth</code> (facultativement avec <code>--use-device-code</code>), <code>--api-key-env</code> ou <code>--api-key-file</code>, <code>--username</code> avec <code>--password-env</code> ou <code>--password-file</code> (facultativement avec <code>--domain-id</code> ou <code>--as-application</code>), ou <code>--windows-auth</code>. Sans méthode de connexion, ou avec plus d’une, la commande s’arrête.</td></tr><tr><td>Profil local</td><td>Sans connexion : <code>--sqlite &#x3C;folder></code>, éventuellement avec <code>--workspace</code>, <code>--vault</code>, <code>--description</code> et <code>--replace</code>.</td></tr></tbody></table>

{% hint style="info" %}
Devolutions CLI n’enregistre pas les secrets d’application, les clés d’API ni les mots de passe. Il enregistre le nom de la variable d’environnement ou le chemin du fichier, et relit la valeur chaque fois qu’une commande en a besoin. Gardez cette variable définie, ou ce fichier en place, aussi longtemps que vous utilisez le contexte. Une connexion par navigateur est conservée dans le magasin sécurisé de votre système d’exploitation.
{% endhint %}

Avant d’enregistrer un contexte Devolutions Cloud ou Devolutions Server, `devo login` vérifie la connexion auprès de l’espace de travail. Si la vérification échoue, rien n’est enregistré. Les erreurs dans les options elles-mêmes arrêtent la commande avec le code de sortie `2` ; une connexion échouée se termine avec `1`. Consultez [Codes de sortie et erreurs](/cli/fr/reference/exit-codes-and-errors.md).

## devo logout

Efface la connexion enregistrée d’un contexte Devolutions Cloud ou Devolutions Server. Le contexte lui-même est conservé : reconnectez-vous avec `devo login`, ou supprimez-le avec `devo context delete`.

**Espace de travail :** Devolutions Cloud, Devolutions Server

```bash
devo logout [<name>]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Contexte actuel</td><td>Contexte dont il faut se déconnecter. Sans lui, le contexte actuel est utilisé ; si aucun contexte n’est actuel, la commande s’arrête et demande un nom. Un contexte de profil local est refusé, parce qu’il n’a pas de connexion. Pour une connexion par navigateur, la session conservée dans le magasin sécurisé est aussi supprimée.</td></tr></tbody></table>

## devo status

Affiche l’espace de travail sélectionné : son contexte, son type, et, pour Devolutions Cloud ou Devolutions Server, si vous êtes connecté.

**Espace de travail :** Tous les types d’espace de travail

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

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Espace de travail sélectionné</td><td>Contexte à afficher. Sans lui, l’espace de travail sélectionné par <code>--source</code>, <code>--context</code> ou le contexte actuel est affiché. Un nom inconnu est une erreur. Pour un profil local, l’état affiche le contexte et son dossier de profil. Avec <code>--source cloud</code> ou <code>--source server</code> et sans nom de contexte, le contexte actuel de ce type est utilisé ; s’il n’y en a pas, l’état dit que vous n’êtes pas connecté au lieu d’échouer.</td></tr><tr><td><code>--online</code></td><td>Désactivé</td><td>Devolutions Cloud et Devolutions Server : contacte l’espace de travail pour vérifier que la connexion fonctionne encore. Si la vérification échoue, la commande signale l’erreur et se termine avec le code <code>1</code>. Sans <code>--online</code>, l’état vient de ce qui est enregistré sur votre ordinateur et rien n’est contacté. N’a aucun effet sur un profil local.</td></tr></tbody></table>

## devo info

Affiche des informations sur une instance Devolutions Cloud ou Devolutions Server, pour un contexte enregistré ou pour une adresse, sans se connecter.

**Espace de travail :** 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">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Espace de travail sélectionné</td><td>Contexte à interroger. Sans lui et sans adresse, l’espace de travail sélectionné est utilisé. Un profil local est refusé : la commande fonctionne seulement avec Devolutions Cloud et Devolutions Server. Ne peut pas être combinée avec <code>--cloud</code> ou <code>--server</code>. Avec un contexte enregistré et sans <code>--private</code>, seule l’information publique est retournée et la connexion du contexte n’est pas utilisée.</td></tr><tr><td><code>--cloud &#x3C;url></code></td><td></td><td>Adresse Devolutions Cloud à interroger sans contexte enregistré. Mêmes règles d’adresse que <code>devo login</code>. Ne peut pas être combinée avec <code>--server</code> ni avec un nom de contexte.</td></tr><tr><td><code>--server &#x3C;url></code></td><td></td><td>Adresse Devolutions Server à interroger sans contexte enregistré. Seules les informations publiques sont renvoyées. Ne peut pas être combinée avec <code>--cloud</code> ni avec un nom de contexte.</td></tr><tr><td><code>--private</code></td><td>Désactivé</td><td>Devolutions Server seulement : ajoute des informations privées, en utilisant la connexion d’un contexte enregistré. Refusée avec <code>--server &#x3C;url></code>, et refusée pour Devolutions Cloud.</td></tr></tbody></table>

## devo context list

Liste vos contextes de chaque type d’espace de travail, triés par nom, et indique lequel est actuel. Alias : `devo context ls`.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo context list
```

Cette commande n’a ni argument ni option qui lui soient propres.

## devo context use

Fait d’un contexte le contexte actuel. Chaque commande suivante l’utilise, jusqu’à ce que vous en choisissiez un autre ou que vous le remplaciez pour une commande avec l’option globale `--context <name>`.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo context use <name>
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Contexte à rendre actuel. Obligatoire. Si le même nom existe pour plus d’un genre de contexte, la commande s’arrête et vous dit d’en supprimer un avec <code>devo context delete &#x3C;name> --kind &#x3C;kind></code>.</td></tr></tbody></table>

## devo context inspect

Affiche les détails d’un contexte : son type, son adresse ou son dossier de profil et, pour un profil local, son espace de travail par défaut, son coffre par défaut et sa description.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo context inspect [<name>]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Contexte actuel</td><td>Contexte à afficher. Sans cela, le contexte actuel est affiché ; si aucun contexte n’est actuel, la commande s’arrête et demande un nom.</td></tr></tbody></table>

## devo context delete

Supprime un contexte. Alias : `devo context rm`. S’il était le contexte actuel, aucun contexte n’est actuel ensuite.

**Espace de travail :** Tous les types d’espace de travail

```bash
devo context delete <name> [--kind <kind>] [--yes]
```

<table><thead><tr><th width="300">OPTION</th><th width="130">PAR DÉFAUT</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Contexte à supprimer. Obligatoire. Supprimer un contexte de profil local ne retire que le contexte : le dossier de profil n’est pas touché.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td></td><td>Genre de contexte à supprimer, quand le même nom existe pour plus d’un genre : <code>sqlite</code> (profil local), <code>cloud</code> ou <code>server</code>. Toute autre valeur est refusée.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Désactivé</td><td>Confirme la suppression d’un contexte Devolutions Cloud ou Devolutions Server, ce qui écarte aussi sa connexion enregistrée. Sans cela, un tel contexte n’est pas supprimé. Pas nécessaire pour un contexte de profil local.</td></tr></tbody></table>

## Suivant

* [Secret commands](/cli/fr/reference/commands/secrets.md)
* [MCP, background process, and configuration commands](/cli/fr/reference/commands/mcp-daemon-config.md)
* [Global options](/cli/fr/reference/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/fr/reference/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.