utilisateurs administrateurs UiP

Syntaxe et options pour `uip admin users` et `uip admin units`, qui gèrent les utilisateurs, les groupes et l'appartenance à un groupe du répertoire Identity Server.

uip admin users et uip admin groups gèrent les utilisateurs et les groupes locaux d'Identity Server au sein de la partition de votre organisation — les identités au niveau du répertoire derrière la connexion, et non les attributions de rôle au niveau d'Orchestrator. Deux groupes de commande indépendants se trouvent ici: users (création/lecture/mise à jour/suppression/invitation utilisateurs du répertoire) et groups (création/lecture/mise à jour/suppression des groupes, plus la gestion des adhésions).

--organization est accepté sur la plupart des verbes dans les deux groupes, mais est obsolète et ignoré — l'organisation est toujours dérivée de votre contexte de connexion actuel. Le transmettre imprime un avertissement (--organization is deprecated and ignored; organization is derived from login context), mais n'a aucun effet.

Synthèse

uip admin users list [--search <term>] [--sort-by <field>] [--sort-order asc|desc] [--limit <n>] [--offset <n>]
uip admin users get <user-id>
uip admin users create <username> --email <email> [--name <name>] [--surname <surname>]
uip admin users update <user-id> [--email <email>] [--name <name>] [--surname <surname>]
uip admin users delete <user-id>
uip admin users invite --email <emails> [--name <name>] [--surname <surname>]

uip admin groups list
uip admin groups get <group-id>
uip admin groups create <name>
uip admin groups update <group-id> --name <name>
uip admin groups delete <group-id>
uip admin groups members list <group-id> [--limit <n>] [--offset <n>]
uip admin groups members add <group-id> --user-ids <ids>
uip admin groups members revoke <group-id> --user-ids <ids>

Verbes

Groupe	Verbe	Objectif
users	list	Lister les utilisateurs dans la partition (interrogeables, triables, paginés).
users	get	Obtenir les détails complets d'un utilisateur par ID.
users	create	Créez un nouvel utilisateur local.
users	update	Mettez à jour l'adresse e-mail, le prénom ou le nom d'un utilisateur.
users	delete	Supprimez un utilisateur par ID.
users	invite	Invitez un ou plusieurs utilisateurs par e-mail.
groups	list	Répertorie tous les groupes de la partition.
groups	get	Récupérer les détails d'un groupe par ID.
groups	create	Créez un nouveau groupe local.
groups	update	Renommez un groupe.
groups	delete	Supprimer un groupe par ID.
groups members	list	Répertorier les membres d'un groupe.
groups members	add	Ajoutez un ou plusieurs utilisateurs à un groupe.
groups members	revoke	Supprimez un ou plusieurs utilisateurs d'un groupe.

liste des utilisateurs administrateurs UiP

Répertorier les utilisateurs dans la partition. Renvoie l’ID utilisateur, le nom d’utilisateur, l’e-mail, le nom et l’heure de création.

Options

Long	Short	Valeur (Value)	Default	Description
--search <term>	-s	string	—	Recherchez des utilisateurs par nom ou par e-mail.
--sort-by <field>		string	—	Champ de tri, par exemple UserName, Email.
--sort-order <direction>		asc|desc	asc	Choisir l'ordre de tri.
--limit <number>	-l	Integer	50 (DEFAULT_PAGE_SIZE)	Nombre d'éléments à renvoyer.
--offset <number>		Integer	0	Nombre d'éléments à ignorer.
--login-validity <minutes>		Integer	—	Remplacez la validité du jeton pour cet appel.

Exemple

uip admin users list --limit 5

Format des données (--sortie json)

{
  "Code": "UserList",
  "Data": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "userName": "[e-mail]",
      "email": "[e-mail]",
      "name": "Admin",
      "surname": "User",
      "displayName": "Admin User",
      "creationTime": "2026-01-15T10:00:00.000Z"
    }
  ]
}

utilisateurs administrateurs uip - obtenir

Obtenir les détails de l’utilisateur par ID.

Arguments

Nom	Requis	Objectif
<user-id>	oui	ID d’utilisateur. Trouvez-le avec users list.

Exemple

uip admin users get a1b2c3d4-0000-0000-0000-000000000001

Format des données (--sortie json)

{
  "Code": "UserDetails",
  "Data": {
    "id": "a1b2c3d4-0000-0000-0000-000000000001",
    "userName": "[e-mail]",
    "email": "[e-mail]",
    "name": "Admin",
    "surname": "User",
    "displayName": "Admin User",
    "creationTime": "2026-01-15T10:00:00.000Z"
  }
}

création d'utilisateurs administrateurs uip

Créez un nouvel utilisateur local.

Arguments

Nom	Requis	Objectif
<username>	oui	Nom d’utilisateur du nouvel utilisateur.

Options

Long	Short	Valeur (Value)	Requis	Description
--email <email>	-e	E-mail	oui	« [e-mail] ».
--name <name>	-n	string	non	Prénom.
--surname <surname>		string	non	Nom de famille.

Exemple

uip admin users create newuser --email "[e-mail]" --name "John" --surname "Doe"

Format des données (--sortie json)

{ "Code": "UserCreated", "Data": { "Succeeded": true } }

mise à jour des utilisateurs administrateurs de l’UiP

Mettez à jour l'adresse e-mail, le prénom ou le nom d'un utilisateur existant. Au moins un champ est requis — l'appel avec aucun échoue côté client ("No fields to update") avant tout appel réseau.

Arguments

Nom	Requis	Objectif
<user-id>	oui	ID d’utilisateur.

Options

Long	Short	Valeur (Value)	Description
--email <email>	-e	E-mail	Nouvelle adresse e-mail.
--name <name>	-n	string	Nouveau prénom.
--surname <surname>		string	Nouveau nom de famille.

Exemple

uip admin users update a1b2c3d4-0000-0000-0000-000000000001 --name "Jane" --surname "Doe" --email "[e-mail]"

Format des données (--sortie json)

{ "Code": "UserUpdated" }

utilisateurs administrateurs uip - supprimer

Supprimez un utilisateur par ID.

Arguments

Nom	Requis	Objectif
<user-id>	oui	ID d’utilisateur.

Exemple

uip admin users delete a1b2c3d4-0000-0000-0000-000000000001

Format des données (--sortie json)

{ "Code": "UserDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Deleted successfully" } }

invitation des utilisateurs administrateurs de l’UIP

Invitez un ou plusieurs utilisateurs par e-mail. Envoie une invitation à rejoindre l'organisation.

Options

Long	Short	Valeur (Value)	Requis	Description
--email <emails>	-e	Séparé par des virgules	oui	Une ou plusieurs adresses e-mail à inviter.
--name <name>	-n	string	non	Prénom appliqué à chaque utilisateur invité.
--surname <surname>		string	non	Nom appliqué à chaque utilisateur invité.

Exemple

uip admin users invite --email "[e-mail]"

Format des données (--sortie json)

{ "Code": "UsersInvited", "Data": { "succeeded": true } }

liste des groupes d’administrateurs uip

Répertorie tous les groupes de la partition. Renvoie l’ID, le nom, le type et l’heure de création du groupe. Aucune option de filtrage/pagination — renvoie tout en un seul appel.

Exemple

uip admin groups list

Format des données (--sortie json)

{
  "Code": "GroupList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Administrators", "displayName": "Administrators", "type": "BuiltIn", "creationTime": "2026-01-15T10:00:00.000Z" }
  ]
}

groupes d'administrateurs uip - obtenir

Récupérez les détails du groupe par ID.

Arguments

Nom	Requis	Objectif
<group-id>	oui	ID de groupe. Trouvez-le avec groups list.

Exemple

uip admin groups get a1b2c3d4-0000-0000-0000-000000000001

Format des données (--sortie json)

{ "Code": "GroupDetails", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Administrators", "displayName": "Administrators", "type": "BuiltIn", "creationTime": "2026-01-15T10:00:00.000Z" } }

création de groupes d'administrateurs uip

Créez un nouveau groupe local.

Arguments

Nom	Requis	Objectif
<name>	oui	Nom du groupe.

Exemple

uip admin groups create "DevOps Team"

Format des données (--sortie json)

{ "Code": "GroupCreated", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000002", "name": "DevOps Team", "displayName": "DevOps Team", "type": "Custom" } }

La commande génère un UUID côté client pour le id du groupe avant d'appeler l'API — le serveur rejette la création du groupe avec un 409 si aucun ID n'est fourni.

mise à jour des groupes d’administrateurs uip

Renommez un groupe. --name est le seul champ modifiable et est obligatoire - l'omettre échoue côté client ("No fields to update").

Arguments

Nom	Requis	Objectif
<group-id>	oui	ID de groupe.

Options

Long	Short	Valeur (Value)	Requis	Description
--name <name>	-n	string	oui	Nouveau nom de groupe.

Exemple

uip admin groups update a1b2c3d4-0000-0000-0000-000000000001 --name "Renamed Group"

Format des données (--sortie json)

{ "Code": "GroupUpdated" }

suppression des groupes d’administrateurs uip

Supprimer un groupe par ID.

Arguments

Nom	Requis	Objectif
<group-id>	oui	ID de groupe.

Exemple

uip admin groups delete a1b2c3d4-0000-0000-0000-000000000002

Format des données (--sortie json)

{ "Code": "GroupDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000002", "Status": "Deleted successfully" } }

Liste des membres des groupes d'administrateurs UIP

Répertorier les membres d'un groupe.

Arguments

Nom	Requis	Objectif
<group-id>	oui	ID de groupe.

Options

Long	Short	Valeur (Value)	Default	Description
--limit <number>	-l	Integer	50	Nombre d'éléments à renvoyer.
--offset <number>		Integer	0	Nombre d'éléments à ignorer.

Exemple

uip admin groups members list a1b2c3d4-0000-0000-0000-000000000001

Format des données (--sortie json)

{ "Code": "GroupMembers", "Data": [] }

Groupes d'administrateurs uip - Ajouter des membres

Ajoutez un ou plusieurs utilisateurs à un groupe.

Remarque :

Implémenté en tant que lecture-modification-écriture: la commande récupère le nom actuel du groupe, puis appelle l'API de mise à jour du groupe avec directoryUserIDsToAdd — la même opération sous-jacente que groups update, mais avec un champ de charge utile différent. Il n’y a pas de message « ajouter un membre » dédié. Appel d’API.

Arguments

Nom	Requis	Objectif
<group-id>	oui	ID de groupe.

Options

Long	Valeur (Value)	Requis	Description
--user-ids <ids>	Séparé par des virgules	oui	ID d'utilisateur à ajouter. Recherchez-les avec users list.

Exemple

uip admin groups members add a1b2c3d4-0000-0000-0000-000000000001 --user-ids "user-id-1,user-id-2"

Format des données (--sortie json)

{ "Code": "GroupMembersAdded" }

Groupes d'administrateurs UIP révocation des membres

Supprimez un ou plusieurs utilisateurs d'un groupe. Même mécanisme de lecture-modification-écriture que members add, à l'aide de directoryUserIDsToRemove.

Arguments

Nom	Requis	Objectif
<group-id>	oui	ID de groupe.

Options

Long	Valeur (Value)	Requis	Description
--user-ids <ids>	Séparé par des virgules	oui	ID d'utilisateur à supprimer. Doit être un membre actuel.

Exemple

uip admin groups members revoke a1b2c3d4-0000-0000-0000-000000000001 --user-ids "user-id-1"

Format des données (--sortie json)

{ "Code": "GroupMembersRevoked" }

Associé

• uip admin robot-accounts — identités non humaines, jetons d'accès personnels et référence d'étendue OAuth.
• uip admin external-apps — Inscriptions du client OAuth2 et informations d'identification fédérées.
• uip admin smtp — configuration des e-mails de l'organisation.
• uip platform users — attribution de licence (une interface utilisateur différente basée sur la licence).

Voir également

• Options globales
• Codes de sortie