UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

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>]
uip insights users get <user-id> [--include-email]
uip insights users list [--include-email] [-l <n>] [-o <n>]
uip insights users get <user-id> [--include-email]

Beide Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes. Keiner von beiden akzeptiert -t, --tenant – sie verwenden 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​

MarkierenBeschreibung
--include-emailFü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
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; 'uip insights roles list' maps a role name to its role GUID and back. A user's row is kept even when directory enrichment fails. This view omits email and the nested role IDs. Pass --include-email to include them."
}
{
  "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; 'uip insights roles list' maps a role name to its role GUID and back. A user's row is kept even when directory enrichment fails. This view omits email and the nested role IDs. Pass --include-email to include them."
}

Datenform – mit --include-email​

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Jane Doe",
      "Roles": [{ "Id": "c1d2e3f4-0000-0000-0000-000000000001", "Name": "Viewer" }],
      "Email": "jane.doe@example.com"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}
{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Jane Doe",
      "Roles": [{ "Id": "c1d2e3f4-0000-0000-0000-000000000001", "Name": "Viewer" }],
      "Email": "jane.doe@example.com"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

Mit --include-email enthält Instructions dieselbe Anmerkung ohne die letzten beiden Sätze. 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.

UIP-Erkenntnisse​

Rufen Sie einen Insights-Benutzer anhand seiner GUID ab.

Argumente​

NameErforderlichZweck
<user-id>jaBenutzer-GUID. Ein Wert, der keine GUID ist, schlägt auf der Clientseite mit Run 'uip insights users list' to find a user ID. vor einem Netzwerkaufruf fehl.

Optionen​

MarkierenBeschreibung
--include-emailFügen Sie die E-Mail-Adresse und die geschachtelten Rollen-IDs in die Ausgabe ein. Standardmäßig deaktiviert.

Beispiel​

uip insights users get b2c3d4e5-0000-0000-0000-000000000001
uip insights users get b2c3d4e5-0000-0000-0000-000000000001

Datenform (--output json)​

{
  "Code": "InsightsUserGet",
  "Data": { "Id": "b2c3d4e5-0000-0000-0000-000000000001", "Name": "Jane Doe", "Roles": [{ "Name": "Viewer" }] }
}
{
  "Code": "InsightsUserGet",
  "Data": { "Id": "b2c3d4e5-0000-0000-0000-000000000001", "Name": "Jane Doe", "Roles": [{ "Name": "Viewer" }] }
}

Mit --include-email erhält die gleiche Form Email und die verschachtelte Roles[].Id wie bei der Listenansicht. Wie in der Liste kann der Name des Benutzers leer oder veraltet sein, wenn die Verzeichnisanreicherung fehlschlägt.

Ein 404er Fehler schlägt mit User <id> was not found in the active Insights tenant, or is not visible there. fehl. Derselbe Benutzer kann in einem anderen Mandanten vorhanden sein. Wenn jeder Insights RBAC-Befehl 404 zurückgibt, ist der Insights Portal-Dienst möglicherweise nicht für den Mandanten bereitgestellt.

Siehe auch​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben