uip platform users

uip platform users manages per-user license-bundle allocation through the License Accountant. Allocate bundles directly to a directory user, list a user's current leases (and whether each one came from a direct allocation or a group rule), and view the account-level user-bundle availability.

Zusammenfassung

uip platform users licenses <verb> [options] [<user>]

Verben

Verb	Zweck
set	Allocate user bundle licenses directly to a directory user.
get	List the user-bundle leases currently held by a directory user, with the source of each lease.
available	Get the account-level summary of user-bundle licenses (total, allocated, available).

User resolution

set and get take a <user> positional argument — a name or email prefix. The CLI searches local and directory users with a "starts with" match and requires exactly one match:

• No match → error with "No directory user found matching '<input>'.".
• Multiple matches → error listing up to 10 candidates so you can refine the input.

uip platform users licenses set

Allocate user bundle licenses to a directory user. Bundles in --input replace the user's directly-allocated bundles; bundles inherited from group rules are unaffected by this command.

Argumente

Name	Erforderlich	Zweck
<user>	ja	User identifier (name or email prefix; must match exactly one directory user).

Optionen

Long	Wert	Standard	Beschreibung
--input	Pfad	erforderlich	Path to a JSON file with the desired user license allocation, for example [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--organization	account-id	Sitzungsstandard	Organization account GUID. Override the org resolved from the current login.

Beispiel

uip platform users licenses set "[e-mail]" \
    --input ./user-bundles.json

user-bundles.json:

[
  { "code": "RPADEVPRONU" },
  { "code": "ATTUNU" },
  { "code": "TSTNU" }
]

Datenform (--output json)

{
  "Code": "UserLicensesSet",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU" },
    { "code": "ATTUNU",      "name": "ATTUNU" },
    { "code": "TSTNU",       "name": "TSTNU" }
  ]
}

uip platform users licenses get

Get the user bundle licenses currently leased by a directory user. Each row is one leased bundle; source is "group" when the lease is inherited from a group rule, or "direct" for non-group allocations.

Argumente

Name	Erforderlich	Zweck
<user>	ja	User identifier (name or email prefix; must match exactly one directory user).

Optionen

Long	Wert	Standard	Beschreibung
--organization	account-id	Sitzungsstandard	Organization account GUID. Override the org resolved from the current login.

Beispiel

uip platform users licenses get "[e-mail]"

Datenform (--output json)

{
  "Code": "UserLicenses",
  "Data": [
    {
      "source": "direct",
      "code": "RPADEVPRONU",
      "name": "RPADEVPRONU",
      "leasedAt": "2026-04-15T10:30:00.000Z"
    },
    {
      "source": "group",
      "code": "ATTUNU",
      "name": "ATTUNU",
      "leasedAt": "2026-04-20T08:15:00.000Z"
    }
  ]
}

uip platform users licenses available

Get the account-level summary of user-bundle licenses: how many seats per bundle exist (total), how many are already allocated (allocated), and how many remain available (available). Use this before allocating to confirm capacity.

Optionen

Long	Wert	Standard	Beschreibung
--organization	account-id	Sitzungsstandard	Organization account GUID. Override the org resolved from the current login.

Beispiel

uip platform users licenses available

Datenform (--output json)

{
  "Code": "UserLicensesAvailable",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU", "total": 100, "allocated": 42, "available": 58 },
    { "code": "ATTUNU",      "name": "ATTUNU",      "total": 50,  "allocated": 50, "available": 0 }
  ]
}

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip platform groups — group rules that lease bundles to many users at once (these appear with source: "group" in users licenses get).
• uip platform tenants — tenant-level runtime and consumable allocation.

Siehe auch

• Globale Optionen.