For the complete documentation index, see llms.txt. This page is also available as Markdown.

Commandes de connexion et de contexte

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. Pour une aide étape par étape, consultez Se connecter à Devolutions Cloud, Se connecter à Devolutions Server, Utiliser un profil local Devolutions Remote Desktop Manager et Basculer entre les espaces de travail.

Les options que chaque commande accepte, telles que --context, --source ou --output json, se trouvent dans Options globales.

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.

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

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.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

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.

--cloud <url>

Adresse Devolutions Cloud, par exemple https://example.devolutions.app. Elle doit être une adresse https absolue sans nom d’utilisateur ni mot de passe ; le http simple n’est accepté que pour une adresse de bouclage comme localhost. Se connecter de nouveau avec le nom d’un contexte Devolutions Cloud existant le remplace.

--server <url>

Adresse de Devolutions Server. Mêmes règles que --cloud : adresse https absolue, http seulement pour une adresse de bouclage, sans nom d’utilisateur ni mot de passe.

--sqlite <folder>

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 --sqlite.

--oauth

Désactivé

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 --use-device-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).

--use-device-code

Désactivé

Avec --oauth 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 DEVO_CLI_USE_DEVICE_CODE a le même effet. Avec Devolutions Cloud, une connexion par code d’appareil n’obtient pas de clé de compte, donc seuls devo status et devo logout fonctionnent : connectez-vous sans --use-device-code pour un accès complet. Refusé sans --oauth.

--application-key <key> (--app-key)

Devolutions Cloud seulement : clé d’application. Obligatoire pour une connexion Devolutions Cloud sans --oauth. Elle ne peut pas contenir de caractères de contrôle. Refusée avec --oauth et avec --server.

--application-secret-env <variable> (--app-secret-env)

Devolutions Cloud seulement : nom de la variable d’environnement qui contient le secret d’application. Utilisez cette option ou --application-secret-file, pas les deux. La variable doit exister et sa valeur ne peut pas être vide.

--application-secret-file <path> (--app-secret-file)

Devolutions Cloud seulement : fichier qui contient le secret d’application. Les sauts de ligne à la fin du fichier sont ignorés.

--api-key-env <variable>

Devolutions Server seulement : nom de la variable d’environnement qui contient la clé d’API. Utilisez cette option ou --api-key-file, pas les deux. Ne peut pas être combinée avec --username, une option de mot de passe, --domain-id ou --as-application.

--api-key-file <path>

Devolutions Server seulement : fichier qui contient la clé d’API.

--username <username>

Devolutions Server seulement : nom d’utilisateur, pour une connexion par nom d’utilisateur et mot de passe. Nécessite --password-env ou --password-file.

--password-env <variable>

Devolutions Server seulement : nom de la variable d’environnement qui contient le mot de passe. Utilisez cette option ou --password-file, pas les deux. Nécessite --username.

--password-file <path>

Devolutions Server seulement : fichier qui contient le mot de passe. Nécessite --username.

--windows-auth

Désactivé

Devolutions Server seulement : se connecte avec l’authentification Windows. Fonctionne sur Windows seulement. Ne peut pas être combiné avec --username, une option de mot de passe, --domain-id ou --as-application.

--as-application

Désactivé

Devolutions Server seulement : avec --username et une option de mot de passe, se connecte en tant qu’utilisateur d’application.

--domain-id <id>

Devolutions Server seulement : ID de domaine, pour l’authentification de domaine avec --username et une option de mot de passe.

--timeout <seconds>

15

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.

--no-set-current

Désactivé

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.

--workspace <name>

Profil local seulement : espace de travail par défaut, enregistré avec le contexte comme indication pour les personnes et les agents. Refusé avec --cloud ou --server.

--vault <name>

Profil local seulement : coffre par défaut, enregistré avec le contexte comme indication pour les personnes et les agents. Refusé avec --cloud ou --server.

--description <text>

Profil local seulement : description du contexte. Refusé avec --cloud ou --server.

--replace

Désactivé

Profil local seulement : remplace un contexte de profil local existant du même nom. Sans cette option, ce nom est refusé. Refusée avec --cloud ou --server.

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

ESPACE DE TRAVAIL
CHOISISSEZ-EN EXACTEMENT UNE

Devolutions Cloud

--oauth (éventuellement avec --use-device-code), ou --application-key avec --application-secret-env ou --application-secret-file.

Devolutions Server

--oauth (facultativement avec --use-device-code), --api-key-env ou --api-key-file, --username avec --password-env ou --password-file (facultativement avec --domain-id ou --as-application), ou --windows-auth. Sans méthode de connexion, ou avec plus d’une, la commande s’arrête.

Profil local

Sans connexion : --sqlite <folder>, éventuellement avec --workspace, --vault, --description et --replace.

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.

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.

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

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Contexte actuel

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.

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

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Espace de travail sélectionné

Contexte à afficher. Sans lui, l’espace de travail sélectionné par --source, --context 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 --source cloud ou --source server 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.

--online

Désactivé

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 1. Sans --online, l’état vient de ce qui est enregistré sur votre ordinateur et rien n’est contacté. N’a aucun effet sur un profil local.

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

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Espace de travail sélectionné

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 --cloud ou --server. Avec un contexte enregistré et sans --private, seule l’information publique est retournée et la connexion du contexte n’est pas utilisée.

--cloud <url>

Adresse Devolutions Cloud à interroger sans contexte enregistré. Mêmes règles d’adresse que devo login. Ne peut pas être combinée avec --server ni avec un nom de contexte.

--server <url>

Adresse Devolutions Server à interroger sans contexte enregistré. Seules les informations publiques sont renvoyées. Ne peut pas être combinée avec --cloud ni avec un nom de contexte.

--private

Désactivé

Devolutions Server seulement : ajoute des informations privées, en utilisant la connexion d’un contexte enregistré. Refusée avec --server <url>, et refusée pour Devolutions Cloud.

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

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

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

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 devo context delete <name> --kind <kind>.

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

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Contexte actuel

Contexte à afficher. Sans cela, le contexte actuel est affiché ; si aucun contexte n’est actuel, la commande s’arrête et demande un nom.

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

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Contexte à supprimer. Obligatoire. Supprimer un contexte de profil local ne retire que le contexte : le dossier de profil n’est pas touché.

--kind <kind>

Genre de contexte à supprimer, quand le même nom existe pour plus d’un genre : sqlite (profil local), cloud ou server. Toute autre valeur est refusée.

--yes (-y, --confirmed)

Désactivé

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.

Suivant

Mis à jour

Ce contenu vous a-t-il été utile ?