UIP Insights-Benutzer

Syntax und Optionen für „UIP Insights Users“, wodurch die Insights-Benutzer des aktiven Mandanten und ihre Insights-Rollennamen gelesen werden.

uip insights users liest die für den aktuellen Aufrufer sichtbaren Mandantenbenutzer zusammen mit ihren Insights-Rollennamen. Dies ist eine schreibgeschützte Oberfläche – es gibt kein Verb zum Erstellen, Aktualisieren oder Löschen.

Wichtig:

Das Lesen von Insights-Benutzern erfordert die Berechtigung zur Insights-Verwaltungsansicht im aktiven Mandanten. Eine Sitzung ohne Benutzeridentität (z. B. eine, die mit Client-Anmeldeinformationen angemeldet ist) kann diese Daten überhaupt nicht lesen und erhält einen 403-Fehler.

Zusammenfassung

uip insights users list [--include-email] [-l <n>] [-o <n>]

Dieses Verb berücksichtigt die globalen Optionen und die Standardaustrittscodes. Er akzeptiert -t, --tenant nicht – es verwendet den während uip login ausgewählten Mandanten.

UIP Insights-Benutzerliste

Listen Sie Mandantenbenutzer auf, die für den aktuellen Aufrufer sichtbar sind, mit ihren Insights-Rollennamen.

Optionen

Markieren	Beschreibung
--include-email	Fügen Sie E-Mail-Adressen und die geschachtelten Rollen-IDs in die Ausgabe ein. Standardmäßig deaktiviert – die Standardansicht lässt beides weg.
-l, --limit <number>	Maximale Anzahl zurückzugebender Zeilen. Die Standardeinstellung ist 50.
-o, --offset <number>	Zeilen, die übersprungen werden sollen, bevor Ergebnisse zurückgegeben werden.

Die Paginierung ist clientseitig: Das Back-End gibt die vollständige unpaginierte Liste zurück und die CLI schneidet sie nach dem Abrufen ab.

Beispiele

uip insights users list

uip insights users list --include-email --limit 100

Datenform – Standardansicht

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "id": "b2c3d4e5-0000-0000-0000-000000000001",
      "name": "Jane Doe",
      "roles": [{ "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Roles shown are the user's Insights roles in the active tenant, by name. A user's row is kept even when directory enrichment fails."
}

Datenform – mit --include-email

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "id": "b2c3d4e5-0000-0000-0000-000000000001",
      "name": "Jane Doe",
      "email": "[e-mail]",
      "roles": [{ "id": 3, "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

Die Zeile eines Benutzers wird in der Liste beibehalten, auch wenn die Verzeichnisanreicherung (Auflösen von Anzeigedaten) für diesen Benutzer fehlschlägt – eine unvollständige Zeile wird nicht verworfen.

Siehe auch

• Insights-Übersicht
• Alerts, Alert-History – andere Mandanten-Scope-Leseoberflächen.