UIP-Plattformgruppen

Syntax und Optionen für „UIP Platform Groups“, die gruppenbasierte Lizenzzuweisungsregeln für Benutzerpakete verwalten.

uip platform groups verwaltet gruppenbasierte Lizenzzuweisungsregeln. Eine Regel fügt eine Reihe von Benutzerpaketen (und optionale Kontingente pro Paket) an eine Verzeichnisgruppe an; Mitglieder der Gruppe automatisch die berechtigten Pakete. Verwenden Sie rules get um die Regel jeder Gruppe in der gesamten Organisation aufzulisten, rules details um die Regel einer Gruppe mit ihren Mietverträgen auf Mitgliederebene zu überprüfen, und rules set um Berechtigungen und Kontingente zu konfigurieren.

Zusammenfassung

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

Verben

Verb	Zweck
get	Listen Sie die Lizenzzuweisungsregeln der Gruppe mit der Kontingentkonfiguration und der aktuellen Nutzung auf. Paginiert.
details	Rufen Sie die Regel einer Gruppe mit der paginierten Liste der Gruppenmitglieder und den Paketen ab, die jede einzelne besitzt.
set	Legen Sie die Benutzerpaket-Zuweisungsregel und die optionalen Kontingente pro Paket für eine Gruppe fest (oder ersetzen Sie sie).

Gruppenauflösung

details und set verwenden ein <group> -Positionsargument – ein Namenspräfix. Die CLI durchsucht Verzeichnisgruppen und erfordert genau eine Übereinstimmung:

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

Abrufen von UIP-Plattformgruppenregeln

Listen Sie die Regeln für die Zuweisung von Gruppenlizenzen in der gesamten Organisation auf. Jede Zeile ist ein (group, bundle) -Paar; Gruppen mit mehreren berechtigten Paketen erzeugen eine Zeile pro Paket. Die Antwort enthält das eigene Kontingent pro Paket (quota) der Gruppe und die aktuelle Nutzung für dieses Kontingent (currentUsage) sowie ein useExternalLicense -Flag, das angibt, ob die Gruppe so konfiguriert ist, dass Pakete aus der externen Lizenzierung ausgewählt werden.

Optionen

Long	Wert	Standard	Beschreibung
--limit	Nummer	50	Maximale Anzahl der zurückzugebenden Ergebnisse.
--offset	Nummer	0	Anzahl der zu überspringenden Ergebnisse.
--sort-by	Feld	–	Feld, nach dem sortiert werden soll. Akzeptierte Werte: Id, GlobalId, GroupId, OrganizationId, UseExternalLicense, UserBundleCodesAsJson, UserBundleCodes. Alles andere gibt HTTP 400 zurück – z. B. name wird nicht akzeptiert.
--sort-order	ENUM	–	Sortierreihenfolge: Asc oder Desc.
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

Beispiel

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

Datenform (--output json)

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

Die Antwort enthält auch Paginierungsmetadaten (zurückgegeben, Grenzwert, Offset, Gesamt).

Details zu den Regeln für UIP-Plattformgruppen

Rufen Sie die Lizenzzuweisungsregel einer Gruppe mit Kontingenten ab, vereinfacht auf eine Zeile pro (user, bundle leased). Benutzer, die noch keine Mandanten haben, werden als einzelne Zeile mit Spalten mit Nullpaketen angezeigt. Die Benutzerliste ist paginiert; verwenden Sie --limit und --offset zum Durchlaufen. Eine Header-Zusammenfassung (Berechtigte Pakete, Kontingente als used/limit, useExternalLicense) wird in s Wennerr geschrieben, damit sie die JSON-Daten auf sdout nicht beeinträchtigt.

Argumente

Name	Erforderlich	Zweck
<group>	ja	Gruppenbezeichner (Namenpräfix; muss genau mit einer Verzeichnisgruppe übereinstimmen).

Optionen

Long	Wert	Standard	Beschreibung
--limit	Nummer	50	Maximale Anzahl der zurückzugebenden Benutzer.
--offset	Nummer	0	Anzahl der Benutzer, die übersprungen werden sollen.
--sort-by	Feld	–	Feld, nach dem Benutzer sortiert werden sollen. Serverseitig vom Lizenzkontoführer validiert; Ein nicht unterstütztes Feld gibt HTTP 400 zurück. Die Liste der akzeptierten Felder ist nicht in der CLI-Quelle für diesen Endpunkt aufgeführt (im Gegensatz zu rules get) – überprüfen Sie die API-Antwort, wenn eine Schätzung abgelehnt wird.
--sort-order	ENUM	–	Benutzersortierreihenfolge: Asc oder Desc.
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

Beispiel

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

Datenform (--output 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
    }
  ]
}

Die Antwort enthält auch Paginierungsmetadaten (zurückgegeben, Grenzwert, Offset, Gesamt) über die Benutzerliste, genau wie rules get.

Regeln für UIP-Plattformgruppen festgelegt

Legen Sie die Zuweisungsregel für Benutzerpakete für eine Gruppe fest, optional mit Kontingenten pro Paket. Wenn Sie quota bei einem Eintrag weglassen, bedeutet das keine Kontingenterzwingung für dieses Paket. Die neue Regel ersetzt die vorherige Paketliste der Gruppe – Pakete, die nicht in --input aufgeführt sind, werden aus der Regel entfernt.

Argumente

Name	Erforderlich	Zweck
<group>	ja	Gruppenbezeichner (Namenpräfix; muss genau mit einer Verzeichnisgruppe übereinstimmen).

Optionen

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

Beispiel

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

group-rule.json:

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

Datenform (--output json)

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

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip platform users – direkte Zuweisung von Benutzerpaketen; users licenses get zeigt, welche Pakete ein Mitglied von jeder Gruppenregel erhält.
• uip platform tenants – Zuweisung von Runtime und Verbrauchsmaterialien auf Mandantenebene.

Siehe auch

• Globale Optionen.