groupes de la plate-forme uip

Syntaxe et options pour `Uip Platform Groups`, qui gère les règles d'attribution de licence basées sur des groupes pour les bundles d'utilisateurs.

uip platform groups gère les règles d’attribution de licence basées sur les groupes. Une règle attache un ensemble de bundles d'utilisateurs (et des quotas facultatifs par bundle) à un groupe d'annuaire; les membres du groupe louent automatiquement les bundles autorisés. Utilisez rules get pour répertorier la règle de chaque groupe au sein de l'organisation, rules details pour inspecter la règle d'un groupe avec ses baux au niveau des membres, et rules set pour configurer les droits et les quotas.

Synthèse

uip platform groups rules <verb> [options] [<group>]

Verbes

Verbe	Objectif
get	Répertoriez les règles d’attribution des licences de groupe avec la configuration de quota et l’utilisation actuelle. Paginé.
details	Obtenez la règle d'un groupe, avec la liste pagination des membres du groupe et les bundles que chacun locataire.
set	Définir (ou remplacer) la règle d'attribution de bundle de l'utilisateur et les quotas facultatifs par bundle pour un groupe.

Résolution de groupe

details et set prennent un argument positionnel <group> - un préfixe de nom. La CLI recherche les groupes du répertoire et requiert exactement une correspondance:

• Aucune correspondance → erreur avec "No directory group found matching '<input>'.".
• Correspondances multiples → erreurs de liste de candidats pour que vous puissiez affiner l'entrée.

règles de groupes uip platform - Obtenir

Répertoriez les règles d’attribution de licences de groupe dans l’ensemble de l’organisation. Chaque ligne constitue une (group, bundle) paire; les groupes ayant plusieurs bundles autorisés produisent une ligne par bundle. La réponse inclut le quota par bundle du groupe (quota) et l'utilisation actuelle par rapport à ce quota (currentUsage), plus un indicateur useExternalLicense indiquant si le groupe est configuré pour louer des bundles à partir de licences externes.

Options

Long	Valeur (Value)	Default	Description
--limit	Numérique	50	Le nombre maximal de résultats à renvoyer.
--offset	Numérique	0	Nombre de résultats à ignorer.
--sort-by	Champ	—	Champ par lequel trier. Valeurs acceptées: Id, GlobalId, GroupId, OrganizationId, UseExternalLicense, UserBundleCodesAsJson, UserBundleCodes. Tout autre élément renvoie HTTP 400, par exemple name, ce qui n’est pas accepté.
--sort-order	ENUM	—	Ordre de tri: Asc ou Desc
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation. Remplacer l’organisation résolue à partir de la connexion actuelle.

Exemple

uip platform groups rules get --limit 50
uip platform groups rules get --sort-by GroupId --sort-order Asc

Format des données (--sortie json)

{
  "Code": "GroupRules",
  "Data": [
    {
      "groupId": "35551807-06b1-4cda-90a1-2fb84851eee7",
      "groupName": "RPA Developers",
      "code": "RPADEVPRONU",
      "name": "RPADEVPRONU",
      "quota": 25,
      "currentUsage": 12,
      "useExternalLicense": false
    }
  ]
}

La réponse inclut également les métadonnées de pagination (renvoyées, limite, décalage, total).

détails des règles des groupes uip platform

Obtenez la règle d’attribution de licences d’un groupe avec des quotas, aplatir à une ligne par (user, bundle leased). Les utilisateurs sans baux apparaissent encore sous la forme d’une même ligne avec des colonnes de bundle nulles. La liste des utilisateurs est paginée; utilisez --limit et --offset pour le parcourir. Un résumé d'en-tête ( bundles intitulés, quotas en tant que used/limit, useExternalLicense) est écrit dans stderr afin de ne pas interférer avec les données JSON sur stdout.

Arguments

Nom	Requis	Objectif
<group>	oui	Identifiant de groupe (préfixe du nom; doit correspondre exactement à un groupe de répertoire).

Options

Long	Valeur (Value)	Default	Description
--limit	Numérique	50	Nombre maximal d'utilisateurs à renvoyer.
--offset	Numérique	0	Nombre d'utilisateurs à ignorer.
--sort-by	Champ	—	Champ par lequel trier les utilisateurs. Validé côté serveur par le Comptabilité de licence; un champ non pris en charge renvoie HTTP 400. La liste des champs acceptés n'est pas énumérée dans la source CLI pour ce point de terminaison (contrairement à rules get) — vérifiez la réponse de l'API si une supposition est rejetée.
--sort-order	ENUM	—	Ordre de tri des utilisateurs: Asc ou Desc
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation. Remplacer l’organisation résolue à partir de la connexion actuelle.

Exemple

uip platform groups rules details "RPA Developers" --limit 100

Format des données (--sortie json)

{
  "Code": "GroupRuleDetails",
  "Data": [
    {
      "userDisplayName": "Dan Dinu",
      "email": "[e-mail]",
      "lastInUse": "2026-05-10T08:15:00.000Z",
      "orphan": false,
      "bundleCode": "RPADEVPRONU",
      "bundleName": "RPADEVPRONU",
      "quota": 25,
      "currentUsage": 12
    }
  ]
}

La réponse inclut également les métadonnées de pagination (renvoyées, limite, décalage, total) sur la liste des utilisateurs, exactement comme rules get.

ensemble de règles de groupes uip platform

Définissez la règle d'attribution de bundle de l'utilisateur pour un groupe, éventuellement avec des quotas par bundle. L'absence de quota sur une entrée signifie l'application de quota pour ce bundle. La nouvelle règle remplace la liste de bundles précédente du groupe - les bundles non répertoriés dans --input sont supprimés de la règle.

Arguments

Nom	Requis	Objectif
<group>	oui	Identifiant de groupe (préfixe du nom; doit correspondre exactement à un groupe de répertoire).

Options

Long	Valeur (Value)	Default	Description
--input	Chemin d'accès	requis	Chemin d’accès à un fichier JSON avec la règle, par exemple [{"code":"RPADEVPRONU"},{"code":"ATTUNU","quota":10}].
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation. Remplacer l’organisation résolue à partir de la connexion actuelle.

Exemple

uip platform groups rules set "RPA Developers" \
    --input ./group-rule.json

group-rule.json :

[
  { "code": "RPADEVPRONU", "quota": 25 },
  { "code": "ATTUNU" }
]

Format des données (--sortie json)

{
  "Code": "GroupRuleSet",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU", "quota": 25, "currentUsage": 12 },
    { "code": "ATTUNU",      "name": "ATTUNU",      "quota": null, "currentUsage": null }
  ]
}

Codes de sortie

Voir Codes de sortie. Aucun remplacement spécifique au verbe.

Commandes associées

• uip platform users — attribution directe aux packages d'utilisateurs; users licenses get affiche les bundles qu’un membre loue à partir de chaque règle de groupe.
• uip platform tenants — Runtime au niveau du locataire et affectation des consommables.

Voir également

• Options globales.