- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- scopes
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
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.
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
| 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
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
| Name | Erforderlich | Zweck |
|---|---|---|
<user-id> | ja | Benutzer-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
| Markieren | Beschreibung |
|---|---|
--include-email | Fü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
- Insights-Übersicht
- Rollen, Gruppen – die anderen RBAC-Leseoberflächen;
rolesordnet die hier angezeigten Rollennamen ihren GUIDs und zurück zu. - Alerts, Alert-History – andere Mandanten-Scope-Leseoberflächen.