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 verwaltet die Zuweisung von Lizenzpaketen pro Benutzer über den Lizenzkontoführer sowie die Aufstockungen pro Benutzer und die Berichte zur Lizenz-/Verbrauchsmaterialien. Hier finden Sie drei unabhängige Befehlsgruppen: licenses (direkte/Gruppenpaketzuweisung), top-ups (Gewährung und Nachverfolgung von Verbrauchsmaterialien) und usage (Lizenzverbrauch pro Benutzer).

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	Gewähren Sie einem Benutzer eine Aufstockung aus dem aktiven Verbrauchspool der Organisation.
top-ups	get	Überprüfen Sie den Status eines Auftrags zur Aufstockungsgewährung.
top-ups	request	Aufstockung für sich selbst anfordern; benachrichtigt die Administratoren der Organisation.
usage	list	Listen Sie Benutzer mit Lizenzverbrauch in der Organisation auf.
usage	get	Anzeigen des Lizenzverbrauchs pro Benutzer (Ihre eigene oder ein Administrator, der den eines anderen Benutzers anzeigt).

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

Top-ups für UIP-Plattformbenutzer

Gewähren und nachverfolgen von Verbrauchsmaterialien pro Benutzer. Der Quellpool wird automatisch aus den aktiven Verbrauchsmaterialien der Organisation aufgelöst (PLTU bevorzugt, andernfalls AGU) – Sie übergeben den Pool nie explizit.

UIP-Plattformbenutzer erstellen Top-ups

Gewähren Sie einem Benutzer eine Aufstockung.

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	Warten Sie, bis der Aufstockungsauftrag abgeschlossen ist, und melden Sie, ob er gewährt wurde.
--count	Integer (1–100)	1	Anzahl der zu gewährenden Top-up-Units.
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos.

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-Plattformbenutzer erhalten Top-ups

Überprüfen Sie den Status eines Auftrags zur Aufstockungsgewährung.

Argumente

Name	Erforderlich	Zweck
<job-id>	ja	Aufstockungsauftrags-ID, die von top-ups create zurückgegeben wird.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos.

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

Top-ups-Anforderung für UIP-Plattformbenutzer

Fordern Sie eine Aufstockung für sich selbst an (den angemeldeten Benutzer). Dadurch werden die Administratoren Ihrer Organisation benachrichtigt – es wird nichts direkt gewährt.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos.

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

Ein Nicht-NotificationSent -Ergebnis (z. B. NotEligible oder NoActiveDistribution) wird als Fehler mit der Meldung des Servers zurückgegeben.

Nutzung der UIP-Plattform durch Benutzer

Zeigen Sie den Lizenzverbrauch pro Benutzer an: monatlicher Pool in Prozent (in Prozent) und Aufstockungsportfolio in Prozent (in Prozent).

Nutzungsliste der UIP-Plattformbenutzer

Listen Sie Benutzer mit Lizenzverbrauch in der Organisation auf.

Optionen

Long	Wert	Standard	Beschreibung
--limit	Integer	Standardseitengröße	Maximale Anzahl der zurückzugebenden Benutzer.
--offset	Integer	0	Anzahl der Benutzer, die übersprungen werden sollen.
--sort-by	Feld	–	Sortieren nach einem Feld der Zeile der Benutzernutzung (z. B. email, displayName).
--sort-order	asc	desc	–
--license-codes	durch Leerzeichen getrennte Codes	–	Filtern Sie nach Benutzern, die über bestimmte Lizenzpakete verfügen (z. B. RPADEVPRONU ATTUNU).
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos.

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 ist null (nicht 0), wenn der Benutzer keine monatliche Zulage hat. status ist einer von MonthlyLimit, TopUp, PaidUnits.

Abrufen der Nutzung der UIP-Plattformbenutzer

Zeigt den Lizenzverbrauch pro Benutzer an: den monatlichen Prozentsatz jedes Verbrauchsmaterials, das Zurücksetzungsdatum, die Aufschlüsselung pro Dienst und den Aufstockungsbetrag, wenn vorhanden.

Argumente

Name	Erforderlich	Zweck
[user]	nein	Benutzerbezeichner (Name oder E-Mail-Präfix). Auslassen, um die eigene Nutzung des angemeldeten Benutzers anzuzeigen; Übergeben Sie einen (Administratorpfad), um den anderen Benutzer anzuzeigen.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos.

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.