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

Administration : utilisateurs et groupes

Cette page décrit chaque commande devo admin qui gère les personnes : les utilisateurs, les utilisateurs supprimés, l’authentification à deux facteurs, les groupes d’utilisateurs, les invitations, le propriétaire de l’organisation et les domaines Active Directory. La plupart de ces commandes fonctionnent avec un seul type d’espace de travail : Devolutions Cloud, Devolutions Server ou un profil local. La ligne Espace de travail sous chaque commande indique où elle fonctionne. Une commande exécutée sur un type d’espace de travail qu’elle ne prend pas en charge s’arrête avec operationNotSupportedBySource et nomme le type dont vous avez besoin.

Pour la liste de toutes les commandes, consultez Commandes. Pour les tâches pas à pas, consultez Gérer les utilisateurs, les groupes et l’accès. Les options que chaque commande accepte, comme --context ou --output json, sont décrites dans Options globales et ne sont pas répétées ici.

Sélection d’un utilisateur ou d’un groupe. Les commandes qui prennent un argument <user> ou <group> le lisent comme un nom. Écrivez id:<value> ou ajoutez --id pour passer un ID, et name:<value> pour forcer un nom. Certaines commandes d’utilisateur acceptent aussi email:<value> ou --email. Les commandes qui modifient quelque chose refusent de s’exécuter sans --yes (alias -y et --confirmed) et s’arrêtent avec confirmationRequired.

devo admin user list

Liste les utilisateurs de l’espace de travail sélectionné. Alias : devo admin user ls.

Espace de travail : Tous les types d’espace de travail. Un profil local énumère les utilisateurs seulement quand le profil les contient.

devo admin user list

Cette commande n’a pas d’option qui lui soit propre.

devo admin user get

Affiche un utilisateur, sélectionné par nom, courriel ou ID.

Espace de travail : Tous les types d’espace de travail. Un profil local affiche les utilisateurs seulement quand le profil les contient.

devo admin user get <user> [--id | --email]
OPTION
PAR DÉFAUT
CE QU’IL FAIT

<user>

Obligatoire. L’utilisateur à afficher : un nom d’utilisateur par défaut. Écrivez id:<value> pour un ID, email:<value> pour un courriel ou un courriel de connexion, ou name:<value> pour forcer un nom.

--id

Désactivé

Lit <user> comme un ID d’utilisateur.

--email

Désactivé

Lit <user> comme un courriel ou un courriel de connexion.

devo admin user create

Crée un utilisateur sur Devolutions Server.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Obligatoire. Nom d’utilisateur (connexion) du nouvel utilisateur. Il ne peut pas être vide.

--email <email>

Adresse de courriel de l’utilisateur.

--password-env <variable>

Nom de la variable d’environnement qui contient le mot de passe initial. Utilisez cette option ou --password-file, pas les deux. Un mot de passe est obligatoire quand --authentication vaut builtin (la valeur par défaut), et il ne peut pas être vide. Les sauts de ligne à la fin de la valeur sont retirés.

--password-file <path>

Fichier qui contient le mot de passe initial. Utilisez cette option ou --password-env, pas les deux.

--first-name <name>

Prénom de l’utilisateur.

--last-name <name>

Nom de famille de l’utilisateur.

--authentication <type>

builtin

Façon dont l’utilisateur se connecte : builtin (compte Devolutions Server ; custom et devolutions sont aussi acceptés), domain (Active Directory ; ad et active-directory sont aussi acceptés) ou azure-ad (Microsoft Entra ID ; azuread, entra-id et entraid sont aussi acceptés). Pour domain et azure-ad, le mot de passe est facultatif.

--user-type <type>

user

Type d’utilisateur : admin (ou administrator), user, restricted ou read-only (ou readonly). Quand vous l’omettez, le type est admin si vous ajoutez --administrator, sinon user.

--administrator

Désactivé

Crée un administrateur. Identique à --user-type admin ; ignoré quand vous passez aussi --user-type.

--disabled

Désactivé

Crée l’utilisateur désactivé. Sans cette option, l’utilisateur est activé.

--force-password-change

Désactivé

Oblige l’utilisateur à changer le mot de passe à la prochaine connexion.

--display-name <name>

Non accepté par Devolutions Server : la commande s’arrête avec operationNotSupportedBySource. Utilisez --first-name et --last-name.

--login-email <email>

Non accepté par Devolutions Server : la commande s’arrête avec operationNotSupportedBySource. Utilisez --email.

--yes (-y, --confirmed)

Désactivé

Confirme la création. Obligatoire.

devo admin user update

Modifie un utilisateur. Les options que vous omettez gardent leur valeur actuelle, et vous devez passer au moins un changement. Certaines options appartiennent à un seul type d’espace de travail : vous ne pouvez pas combiner des options Devolutions Cloud avec des options Devolutions Server dans une même commande, et une option que l’espace de travail sélectionné n’accepte pas arrête la commande avec operationNotSupportedBySource.

Espace de travail : Devolutions Cloud, Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<user>

Obligatoire. L’utilisateur à modifier : un nom d’utilisateur par défaut, ou id:<value>. L’utilisateur doit correspondre à exactement un compte.

--id

Désactivé

Lit <user> comme un ID d’utilisateur.

--name <name>

Nouveau nom d’utilisateur. Sur Devolutions Cloud, --name et --display-name changent tous les deux le nom de l’utilisateur : n’en passez qu’un. Non accepté par Devolutions Server : utilisez --first-name et --last-name.

--display-name <name>

Nouveau nom affiché. Sur Devolutions Cloud, il change le nom de l’utilisateur, comme --name. Non accepté par Devolutions Server : utilisez --first-name et --last-name.

--email <email>

Nouvelle adresse de courriel. Sur Devolutions Cloud, passez une adresse de courriel valide.

--login-email <email>

Nouveau courriel de connexion. Non accepté par Devolutions Cloud ni par Devolutions Server.

--administrator <true|false>

Fait de l’utilisateur un administrateur (true) ou non (false). Sur Devolutions Server, true définit le type d’utilisateur à admin et false à user, sauf si vous passez aussi --user-type. Toute autre valeur est refusée.

--enabled <true|false>

Active (true) ou désactive (false) l’utilisateur. Toute autre valeur est refusée.

--description <text>

Devolutions Cloud seulement. Nouvelle description. Passez une valeur vide pour l’effacer.

--locale <locale>

Devolutions Cloud seulement. Nouvelle locale de l’utilisateur. Elle ne peut pas être vide.

--workspace-access <true|false>

Devolutions Cloud seulement. Donne (true) ou retire (false) l’accès à Workspace.

--web-login <true|false>

Devolutions Cloud seulement. Autorise (true) ou bloque (false) la connexion web Devolutions pour l’utilisateur.

--user-vaults <true|false>

Devolutions Cloud seulement. Donne (true) ou retire (false) l’accès aux coffres utilisateur.

--first-name <name>

Devolutions Server seulement. Nouveau prénom.

--last-name <name>

Devolutions Server seulement. Nouveau nom de famille.

--user-type <type>

Devolutions Server seulement. Nouveau type d’utilisateur : admin (ou administrator), user, restricted ou read-only (ou readonly).

--password-env <variable>

Devolutions Server seulement. Nom de la variable d’environnement qui contient le nouveau mot de passe. Utilisez cette option ou --password-file, pas les deux. Le mot de passe ne peut pas être vide.

--password-file <path>

Devolutions Server seulement. Fichier qui contient le nouveau mot de passe.

--force-password-change

Désactivé

Devolutions Server seulement. Force l’utilisateur à changer le mot de passe à la prochaine connexion.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

Sur Devolutions Cloud, les utilisateurs synchronisés depuis l’annuaire de votre organisation sont gérés par cet annuaire, et Devolutions CLI refuse de les modifier avec cloudUserSynchronized. Un profil local ne peut pas modifier les utilisateurs : la commande signale que la modification n’est pas disponible pour le profil.

devo admin user delete

Supprime un utilisateur. Devolutions Cloud et Devolutions Server suppriment un utilisateur par ID, donc un nom est d’abord associé à un seul utilisateur. Sur Devolutions Server, un utilisateur supprimé va à la corbeille, où vous pouvez le restaurer ou le purger avec les commandes devo admin user trash. Alias : devo admin user rm.

Espace de travail : Devolutions Cloud, Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<user>

Obligatoire. L’utilisateur à supprimer : un nom d’utilisateur par défaut, ou id:<value>.

--id

Désactivé

Lit <user> comme un ID d’utilisateur.

--delete-sql-login

Désactivé

Destiné aussi à retirer la connexion SQL de l’utilisateur. Cela n’a aucun effet sur Devolutions Cloud ni sur Devolutions Server.

--yes (-y, --confirmed)

Désactivé

Confirme la suppression. Obligatoire.

Sur Devolutions Cloud, les utilisateurs synchronisés depuis l’annuaire de votre organisation ne peuvent pas être supprimés avec Devolutions CLI : la commande s’arrête avec cloudUserSynchronized. Un profil local ne peut pas supprimer des utilisateurs : la commande signale que la modification n’est pas disponible pour le profil.

devo admin user groups list

Liste les groupes d’utilisateurs auxquels un utilisateur appartient. Alias : devo admin user groups ls.

Espace de travail : Devolutions Cloud, profil local (lecture seule, quand le profil contient des groupes).

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<user>

Obligatoire. L’utilisateur : un nom d’utilisateur par défaut, id:<value> pour un ID ou email:<value> pour un courriel ou un courriel de connexion.

--id

Désactivé

Lit <user> comme un ID d’utilisateur.

--email

Désactivé

Lit <user> comme un courriel ou un courriel de connexion.

devo admin user trash list

Liste les utilisateurs supprimés qui sont encore dans la corbeille. Alias : devo admin user trash ls.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

[<user>]

Filtre facultatif sur le nom d’utilisateur. Devolutions Server ne filtre pas les utilisateurs supprimés par nom : omettez-le, ou la commande s’arrête avec invalidParameterValue.

--id

Désactivé

Lit <user> comme un ID d’utilisateur. Non utilisé par Devolutions Server, puisque l’argument utilisateur n’est pas accepté.

--case-sensitive

Désactivé

Fait correspondre le nom d’utilisateur en tenant compte de la casse. Non utilisé par Devolutions Server.

--page-number <number>

1

Page d’utilisateurs supprimés à récupérer, à partir de 1.

--page-size <size>

10000

Nombre d’utilisateurs supprimés par page. Devolutions Server renvoie au plus 500 par page : une valeur plus grande est ramenée à 500. La valeur doit être d’au moins 1.

devo admin user trash restore

Restaure un utilisateur supprimé depuis la corbeille.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<user>

Obligatoire. L’utilisateur supprimé. Devolutions Server sélectionne les utilisateurs supprimés par ID seulement : écrivez id:<value> ou ajoutez --id. L’ID doit être un GUID. Obtenez-le avec devo admin user trash list.

--id

Désactivé

Lit <user> comme un ID d’utilisateur.

--yes (-y, --confirmed)

Désactivé

Confirme la restauration. Obligatoire.

devo admin user trash purge

Supprime définitivement un utilisateur de la corbeille. Cette action ne peut pas être annulée. Alias : devo admin user trash rm.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<user>

Obligatoire. L’utilisateur supprimé. Devolutions Server sélectionne les utilisateurs supprimés par ID seulement : écrivez id:<value> ou ajoutez --id. L’ID doit être un GUID.

--id

Désactivé

Lit <user> comme un ID d’utilisateur.

--yes (-y, --confirmed)

Désactivé

Confirme la suppression définitive. Obligatoire.

devo admin user 2fa set

Configure à l’avance la méthode d’authentification à deux facteurs d’un utilisateur Devolutions Server. Devolutions CLI lit d’abord la configuration à deux facteurs du serveur et refuse une méthode que le serveur n’offre pas.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--user-security-id <id>

Obligatoire. ID de l’utilisateur Devolutions Server, sous forme de GUID : l’ID d’utilisateur que devo admin user list et devo admin user get affichent. Vous avez besoin du droit de modifier les utilisateurs, sauf s’il s’agit de votre propre compte.

--type <method>

Obligatoire. Méthode à deux facteurs : google-authenticator (aussi googleauthenticator, totp, authenticator), yubikey (aussi yubi-key), email, sms, duo, azure-mfa (aussi azuremfa) ou radius. Consultez les méthodes que votre serveur offre avec devo admin settings two-factor get.

--account-name <name>

Nom de compte enregistré avec la méthode.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

devo admin user 2fa clear

Retire la méthode d’authentification à deux facteurs définie pour un utilisateur Devolutions Server.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--user-security-id <id>

Obligatoire. ID de l’utilisateur Devolutions Server, sous forme de GUID : l’ID d’utilisateur que devo admin user list et devo admin user get affichent. Vous avez besoin du droit de modifier les utilisateurs, sauf s’il s’agit de votre propre compte.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

devo admin group list

Liste les groupes d’utilisateurs. Alias : devo admin group ls.

Espace de travail : Devolutions Cloud, profil local (lecture seule, quand le profil contient des groupes).

Cette commande n’a pas d’option qui lui soit propre.

devo admin group get

Affiche un groupe d’utilisateurs, par nom ou par ID.

Espace de travail : Devolutions Cloud, profil local (lecture seule, quand le profil contient des groupes).

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<group>

Obligatoire. Le groupe : un nom de groupe par défaut, ou id:<value>.

--id

Désactivé

Lit <group> comme un ID de groupe.

devo admin group create

Crée un groupe d’utilisateurs.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<name>

Obligatoire. Nom du nouveau groupe.

--description <text>

Description du groupe.

--yes (-y, --confirmed)

Désactivé

Confirme la création. Obligatoire.

devo admin group update

Renomme un groupe d’utilisateurs ou change sa description. Les options que vous omettez gardent leur valeur ; passez au moins --name ou --description.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<group>

Obligatoire. Le groupe à modifier : un nom de groupe par défaut, ou id:<value>.

--id

Désactivé

Lit <group> comme un ID de groupe.

--name <new-name>

Nouveau nom du groupe. Une valeur vide est traitée comme « aucun changement ».

--description <text>

Nouvelle description. Passez une valeur vide (--description "") pour l’effacer.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

devo admin group delete

Supprime un groupe d’utilisateurs et ses attributions. Un nom de groupe est d’abord associé à exactement un groupe. Les groupes synchronisés depuis l’annuaire de votre organisation ne peuvent pas être supprimés. Alias : devo admin group rm.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<group>

Obligatoire. Le groupe à supprimer : un nom de groupe par défaut, ou id:<value>.

--id

Désactivé

Lit <group> comme un ID de groupe.

--yes (-y, --confirmed)

Désactivé

Confirme la suppression. Obligatoire.

devo admin group members list

Liste les utilisateurs qui appartiennent à un groupe d’utilisateurs. Alias : devo admin group members ls.

Espace de travail : Devolutions Cloud, profil local (lecture seule, quand le profil contient des groupes).

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<group>

Obligatoire. Le groupe : un nom de groupe par défaut, ou id:<value>.

--id

Désactivé

Lit <group> comme un ID de groupe.

devo admin group members add

Ajoute un utilisateur à un groupe d’utilisateurs.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<group>

Obligatoire. Le groupe : un nom de groupe par défaut, ou id:<value>.

<user>

Obligatoire. L’utilisateur à ajouter : un nom d’utilisateur par défaut, id:<value> pour un ID ou email:<value> pour un courriel ou un courriel de connexion.

--group-id

Désactivé

Lit <group> comme un ID de groupe.

--user-id

Désactivé

Lit <user> comme un ID d’utilisateur.

--user-email

Désactivé

Lit <user> comme un courriel ou un courriel de connexion.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

devo admin group members remove

Retire un utilisateur d’un groupe d’utilisateurs. Alias : devo admin group members rm.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

<group>

Obligatoire. Le groupe : un nom de groupe par défaut, ou id:<value>.

<user>

Obligatoire. L’utilisateur à retirer : un nom d’utilisateur par défaut, id:<value> pour un ID ou email:<value> pour un courriel ou un courriel de connexion.

--group-id

Désactivé

Lit <group> comme un ID de groupe.

--user-id

Désactivé

Lit <user> comme un ID d’utilisateur.

--user-email

Désactivé

Lit <user> comme un courriel ou un courriel de connexion.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

devo admin invitation list

Liste les invitations d’utilisateurs en attente de l’organisation, sans leurs secrets. Alias : devo admin invitation ls.

Espace de travail : Devolutions Cloud.

Cette commande n’a pas d’option qui lui soit propre.

devo admin invitation get

Affiche une invitation d’utilisateur, sans ses secrets.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--invitation-id <id> (--id)

Obligatoire. ID de l’invitation, sous forme de GUID. Obtenez-le avec devo admin invitation list.

devo admin invitation delete

Supprime une invitation d’utilisateur. Alias : devo admin invitation rm.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--invitation-id <id> (--id)

Obligatoire. ID de l’invitation, sous forme de GUID.

--yes (-y, --confirmed)

Désactivé

Confirme la suppression. Obligatoire.

devo admin invitation remove-email

Retire une adresse de courriel d’une invitation d’utilisateur, pour que cette personne ne soit plus invitée.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--invitation-id <id> (--id)

Obligatoire. ID de l’invitation, sous forme de GUID.

--email <email>

Obligatoire. Adresse de courriel à retirer. Ce doit être une seule adresse de courriel valide, sans nom d’affichage.

--yes (-y, --confirmed)

Désactivé

Confirme la modification. Obligatoire.

devo admin owner get

Affiche le propriétaire de l’organisation Devolutions Cloud.

Espace de travail : Devolutions Cloud.

Cette commande n’a pas d’option qui lui soit propre.

devo admin owner set

Fait d’un autre utilisateur le propriétaire de l’organisation Devolutions Cloud.

Espace de travail : Devolutions Cloud.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--user-id <id>

Obligatoire. ID de l’utilisateur qui devient le propriétaire, sous forme de GUID. Obtenez-le avec devo admin user list.

--yes (-y, --confirmed)

Désactivé

Confirme le changement de propriétaire. Obligatoire.

devo admin domain list

Liste les domaines Active Directory configurés sur Devolutions Server, sans leurs secrets de liaison. Alias : devo admin domain ls.

Espace de travail : Devolutions Server.

Cette commande n’a pas d’option qui lui soit propre.

devo admin domain users

Liste les utilisateurs que Devolutions Server trouve dans un domaine Active Directory.

Espace de travail : Devolutions Server.

OPTION
PAR DÉFAUT
CE QU’IL FAIT

--domain <domain-name> (--domain-name)

Obligatoire. Nom du domaine Active Directory à interroger. Il ne peut pas être vide. Voyez les domaines configurés avec devo admin domain list.

--group <group-name>

N’énumère que les utilisateurs de ce groupe Active Directory.

--no-cache

Désactivé

Demande à Devolutions Server d’interroger de nouveau le domaine au lieu d’utiliser sa liste mise en cache des utilisateurs du domaine.

Mis à jour

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