Benutzer der UIP-Plattform

Syntax und Optionen für „UIP-Plattformbenutzer“, die die Zuweisung von Lizenzpaketen pro Benutzer über den Lizenzkontoführer verwalten.

uip platform users manages per-user license-bundle allocation through the License Accountant, plus per-user consumable top-ups and license/consumable usage reporting. Three independent command groups live here: licenses (direct/group bundle allocation), top-ups (grant and track consumable top-ups), and usage (per-user license consumption).

Zusammenfassung

uip platform users licenses <verb> [options] [<user>]
uip platform users top-ups <verb> [options]
uip platform users usage <verb> [options] [<user>]

Verben

„Gruppieren“ (Group)	Verb	Zweck
licenses	set	Weisen Sie Benutzerpaketlizenzen direkt einem Verzeichnisbenutzer zu.
licenses	get	Listen Sie die Benutzerpaketverträge auf, die derzeit von einem Verzeichnisbenutzer verwaltet werden, mit der Quelle jeder Mandant.
licenses	available	Rufen Sie die Zusammenfassung der Benutzerpaketlizenzen auf Kontoebene ab (insgesamt, zugewiesen, verfügbar).
top-ups	create	Grant a top-up to a user from the organization's active consumable pool.
top-ups	get	Check the status of a top-up grant job.
top-ups	request	Request a top-up for yourself; notifies the organization's admins.
usage	list	List users with license consumption in the organization.
usage	get	Show per-user license consumption (your own, or an admin viewing another user's).

Benutzerauflösung

set und get verwenden ein <user> -Positionsargument – einen Namen oder ein E-Mail-Präfix. Die CLI sucht lokale und Verzeichnisbenutzer mit einer Übereinstimmung „beginnt mit“ und erfordert genau eine Übereinstimmung:

• Keine Übereinstimmung → Fehler mit "No directory user found matching '<input>'.".
• Mehrere Übereinstimmungen → Fehler beim Auflisten von bis zu 10 Kandidaten, sodass Sie die Eingabe optimieren können.

UIP-Plattformbenutzerlizenzen festgelegt

Weisen Sie einem Verzeichnisbenutzer Benutzerpaketlizenzen zu. Pakete in --input ersetzen die direkt zugewiesenen Pakete des Benutzers; von Gruppenregeln geerbte Pakete sind von diesem Befehl nicht betroffen.

Argumente

Name	Erforderlich	Zweck
<user>	ja	Benutzerbezeichner (Name oder E-Mail-Präfix; muss genau mit einem Verzeichnisbenutzer übereinstimmen).

Optionen

Long	Wert	Standard	Beschreibung
--input	Pfad	erforderlich	Pfad zu einer JSON-Datei mit der gewünschten Benutzerlizenzzuweisung, z. B. [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

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" }
  ]
}

Abrufen von Lizenzen für UIP-Plattformbenutzer

Rufen Sie die Benutzerpaketlizenzen ab, die derzeit von einem Verzeichnisbenutzer geleert werden. Jede Zeile ist ein gemeinsam genutztes Paket. source ist "group" wenn der Mandant von einer Gruppenregel geerbt wird, oder "direct" für Zuweisungen ohne Gruppenregel.

Argumente

Name	Erforderlich	Zweck
<user>	ja	Benutzerbezeichner (Name oder E-Mail-Präfix; muss genau mit einem Verzeichnisbenutzer übereinstimmen).

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

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"
    }
  ]
}

Lizenzen für UIP-Plattformbenutzer verfügbar

Rufen Sie die Zusammenfassung der Benutzerpaketlizenzen auf Kontoebene ab: wie viele Plätze pro Paket vorhanden sind (total), wie viele bereits zugewiesen sind (allocated) und wie viele noch verfügbar sind (available). Verwenden Sie dies vor der Zuweisung, um die Kapazität zu bestätigen.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

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 }
  ]
}

uip platform users top-ups

Grant and track per-user consumable top-ups. The source pool is resolved automatically from the organization's active consumables (PLTU preferred, else AGU) — you never pass the pool explicitly.

uip platform users top-ups create

Grant a top-up to a user.

Argumente

Name	Erforderlich	Zweck
<user>	ja	Benutzerbezeichner (Name oder E-Mail-Präfix; muss genau mit einem Verzeichnisbenutzer übereinstimmen).

Optionen

Long	Wert	Standard	Beschreibung
--wait	Markieren	aus	Wait until the top-up job finishes and report whether it was granted.
--count	integer (1-100)	1	Number of top-up units to grant.
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiele

uip platform users top-ups create "[e-mail]"
uip platform users top-ups create "[e-mail]" --wait
uip platform users top-ups create "[e-mail]" --count 5

Datenform (--output json)

Ohne --wait:

{
  "Code": "TopUpStarted",
  "Data": {
    "jobId": "b3f1c2d4-0000-0000-0000-000000000009",
    "status": "started",
    "pool": "AGU",
    "poolPercentConsumed": 42
  }
}

Mit --wait:

{
  "Code": "TopUpCompleted",
  "Data": {
    "jobId": "b3f1c2d4-0000-0000-0000-000000000009",
    "status": "completed",
    "pool": "AGU",
    "poolPercentConsumed": 42,
    "granted": true,
    "rejectionReason": null
  }
}

uip platform users top-ups get

Check the status of a top-up grant job.

Argumente

Name	Erforderlich	Zweck
<job-id>	ja	Top-up job id returned by top-ups create.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiel

uip platform users top-ups get b3f1c2d4-0000-0000-0000-000000000009

Datenform (--output json)

{
  "Code": "TopUpStatus",
  "Data": {
    "jobId": "b3f1c2d4-0000-0000-0000-000000000009",
    "status": "completed",
    "granted": true,
    "rejectionReason": null
  }
}

uip platform users top-ups request

Request a top-up for yourself (the logged-in user). This notifies your organization's admins — it does not grant anything directly.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiel

uip platform users top-ups request

Datenform (--output json)

{
  "Code": "TopUpRequested",
  "Data": {
    "userId": "11111111-1111-1111-1111-111111111111",
    "outcome": "NotificationSent",
    "message": "Your administrators have been notified."
  }
}

A non-NotificationSent outcome (for example NotEligible or NoActiveDistribution) is returned as a failure with the server's message.

uip platform users usage

View per-user license consumption: monthly pool percent-consumed and top-up wallet percent-consumed.

uip platform users usage list

List users with license consumption in the organization.

Optionen

Long	Wert	Standard	Beschreibung
--limit	Integer	default page size	Maximale Anzahl der zurückzugebenden Benutzer.
--offset	Integer	0	Anzahl der Benutzer, die übersprungen werden sollen.
--sort-by	Feld	–	Sort by a field of the user usage row (for example email, displayName).
--sort-order	asc	desc	–
--license-codes	space-separated codes	–	Filter to users holding specific license bundles (for example RPADEVPRONU ATTUNU).
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiele

uip platform users usage list
uip platform users usage list --limit 50 --offset 50 --sort-by email --sort-order asc --license-codes RPADEVPRONU ATTUNU

Datenform (--output json)

{
  "Code": "UserUsageList",
  "Data": [
    {
      "userId": "11111111-1111-1111-1111-111111111111",
      "email": "[e-mail]",
      "displayName": "Jane Doe",
      "licenses": ["RPADEVPRONU"],
      "strongestLicense": "RPADEVPRONU",
      "monthlyPercentConsumed": 64,
      "topUpWalletPercentConsumed": 20,
      "topups": 2,
      "status": "TopUp"
    }
  ]
}

monthlyPercentConsumed is null (not 0) when the user has no monthly allowance. status is one of MonthlyLimit, TopUp, PaidUnits.

uip platform users usage get

Show per-user license consumption: each consumable's monthly percent consumed, reset date, per-service breakdown, and top-up wallet when present.

Argumente

Name	Erforderlich	Zweck
[user]	nein	User identifier (name or email prefix). Omit to show the logged-in user's own usage; pass one (admin path) to see another user's.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiele

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

Datenform (--output json)

{
  "Code": "UserUsage",
  "Data": {
    "userId": "11111111-1111-1111-1111-111111111111",
    "consumables": [
      {
        "entitlement": "AgenticPool",
        "monthlyPercentConsumed": 64,
        "resetsOn": "2026-08-01T00:00:00.000Z",
        "services": [
          { "service": "AgentDevelopment", "serviceName": "Agent Development", "percentOfPool": 40 }
        ],
        "topUpWallet": {
          "monthlyPercentConsumed": 20,
          "topups": 2,
          "firstGrantedOn": "2026-07-10T09:00:00.000Z",
          "services": [],
          "topupCountPerMonth": [
            { "month": "2026-07-01T00:00:00.000Z", "topupCount": 2 }
          ]
        }
      }
    ]
  }
}

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip platform groups – Gruppenregeln, die Pakete an viele Benutzer gleichzeitig Leasing geben (diese werden mit source: "group" in users licenses get angezeigt).
• uip platform tenants – Zuweisung von Runtime und Verbrauchsmaterialien auf Mandantenebene.

Siehe auch

• Globale Optionen.