UIP-Administratorprüfung

Syntax und Optionen für „uip admin Audit“, die UiPath Admin Audit-Ereignisse im Organisations- und Mandanten-Scope abfragt und exportiert.

uip admin audit fragt und exportiert UiPath-Prüfungsereignisse – den Administratorprüfungspfad auf Plattformebene (unterschied sich von uip or audit-logs, der Änderungen an der Orchestrator-Entität abdeckt). Teil von uip admin (Übersicht), dem UiPath-Administratortool.

Zwei Scope-Untergruppen registrieren die identische Drei-Verb-Form:

• org – organisationsbezogene Prüfung (Administratorereignisse, die mandantenagnostisch sind).
• tenant – Mandantenbezogene Prüfung (Ereignisse im Scope des aktiven Anmeldemandanten oder --tenant-id).

Typischer Workflow: audit <scope> sources (Quell-IDs erkennen) → audit <scope> events --source <guid> --from-date … --to-date … (Zeilen finden) → audit <scope> export --from-date … --to-date … --output-path … (herunterladen).

Zusammenfassung

uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

tenant Verben akzeptieren zusätzlich --tenant-id <guid>, um den Mandanten aus Ihrem Anmeldekontext zu überschreiben; org Verben nicht (Organisations-Scope hat keinen Mandanten zum Überschreiben).

UIP-Administratorprüfung: Organisationsquellen/Mandantenquellen für UIP-Administratorprüfung

Listen Sie die in diesem Scope sichtbaren Prüfungsereignisquellen auf – jede Quelle ist eine Ereigniskategorie der obersten Ebene (z. B. Identity, Tenant, Robot). Verwenden Sie die zurückgegebenen id -Werte mit events --source <guid>.

Optionen

Long	Wert	Beschreibung
--tenant-id <guid>	GUID	(Nur tenant -Scope.) Überschreiben Sie den Mandanten im Anmeldekontext.
--login-validity <minutes>	Integer	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens für diesen Aufruf. Selten erforderlich.

Beispiel

uip admin audit org sources

Datenform (--output json)

{
  "Code": "AuditOrgSources",
  "Data": [
    { "id": "11111111-1111-1111-1111-111111111111", "name": "Identity", "eventTargets": [] }
  ]
}

Code ist AuditTenantSources unter tenant.

UIP-Administratorprüfung für Organisationsereignisse/Uip-Administratorprüfung für Mandantenereignisse

Abfragenprüfungsereignisse in diesem Scope, paginiert. Gibt { auditEvents, next, previous } zurück – kein Bar-Array. Die Benennung von Cursorn ist chronologisch: next ist neuere Ereignisse, previous ist älter. Wenn --limit 200 überschreitet, paginiert die CLI intern (gefolgt von previous), da der Server jeden Aufruf auf 200 Zeilen begrenzt.

Optionen

Long	Wert	Beschreibung
--from-date <iso>	ISO 8601	Beginn des Zeitintervalls. Inklusive.
--to-date <iso>	ISO 8601	Ende des Zeitintervalls. Inklusive.
--source <guid>	GUID, wiederholbar	Filtern Sie nach Ereignisquellen-IDs. Mit sources erkennen.
--target <guid>	GUID, wiederholbar	Filtern Sie nach Ereignisziel-IDs.
--type <guid>	GUID, wiederholbar	Filtern Sie nach Ereignistyp-IDs.
--user-id <guid>	GUID, wiederholbar	Filtern Sie nach handelnden Benutzer-IDs.
--search <term>	string	Serverseitige Teilzeichenfolgesuche.
--status <status>	Success | Failure	Ereignis-Status-Filter ohne Groß-/Kleinschreibung.
--limit <n>	Integer	Gesamtzahl der zurückzugebenden Ereignisse, 1–10.000. Werte über 200 werden clientseitig paginiert (Server fasst jeden Aufruf auf 200 zusammen).
--tenant-id <guid>	GUID	(Nur tenant -Scope.) Überschreiben Sie den Mandanten im Anmeldekontext.
--login-validity <minutes>	Integer	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens für diesen Aufruf. Selten erforderlich.

Beispiele

# Fetch the latest 50 org audit events
uip admin audit org events --limit 50

# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
  --from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z

Datenform (--output json)

{
  "Code": "AuditOrgEvents",
  "Data": { "auditEvents": [], "next": null, "previous": null }
}

Code ist AuditTenantEvents unter tenant.

uip admin Audit Org Export/uip Admin Audit Mandantenexport

Exportieren Sie Prüfungsereignisse aus dem Langzeitspeicher. Gibt einen HTTP-Aufruf pro UTC-Tag innerhalb von [--from-date, --to-date] aus und aggregiert die Ergebnisse im Speicher, bevor etwas ausgeschrieben wird – zuerst wird das vollständige Fenster abgerufen und bei einem Fehlschlag eines einzelnen Tages wird der Export atomar abgebrochen (es wird nichts geschrieben; der Fehler benennt den Tag, der durchgeführt wird). fehlgeschlagen).

--output-path ist ein Basisverzeichnis, kein Dateipfad – übergeben Sie einen Ordner, und die CLI generiert darin eine eindeutig benannte Ausgabe, die mit dem Fenster und der Generierungszeit gestempelt ist (z. B audit_2026-01-01_2026-02-01_20260617T112630), sodass wiederholte Exporte desselben Fensters nie kollaborieren:

• --file-format json (Standard) – Ein Ordner mit einer JSON-Datei pro UTC-Tag.
• --file-format csv – Eine einzelne CSV-Datei, in der jedes Ereignis unter einem gemeinsamen Header zusammengeführt wird.

Optionen

Long	Wert	Erforderlich	Beschreibung
--from-date <iso>	ISO 8601	ja	Beginn des Zeitintervalls.
--to-date <iso>	ISO 8601	ja	Ende des Zeitintervalls.
--output-path <dir>	Pfad	bedingt	Basisverzeichnis für den Export (erstellt, wenn fehlend). Übergeben Sie nur ein Verzeichnis, niemals einen Dateinamen – die CLI benennt die Ausgabe für Sie. Erforderlich, es sei denn, stattdessen wird --output-file (veraltetes Alias) übergeben.
--output-file <dir>	Pfad	nein	Veralteter Alias für --output-path, wurde für die Abwärtskompatibilität beibehalten. Trotz des Namens wird es immer noch als Basisverzeichnis behandelt. Wenn beide übergeben sind, gewinnt --output-path und es wird eine Veraltungswarnung protokolliert.
--file-format <format>	json | csv	nein	Ausgabeform. Der Standardwert ist json.
--tenant-id <guid>	GUID	nein	(Nur tenant -Scope.) Überschreiben Sie den Mandanten im Anmeldekontext.
--login-validity <minutes>	Integer	nein	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens für diesen Aufruf. Selten erforderlich.

Beispiele

# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports

# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
  --file-format csv --output-path ./audit-exports

Datenform (--output json)

JSON-Format:

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
    "Format": "json",
    "Files": 27,
    "Bytes": 12345,
    "Days": 31,
    "NonEmptyDays": 27,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

Das CSV-Format fügt eine Events -Anzahl anstelle von Files hinzu:

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
    "Format": "csv",
    "Bytes": 98765,
    "Days": 31,
    "NonEmptyDays": 27,
    "Events": 1234,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

Code ist AuditTenantExport unter tenant.

Fehlersuche und ‑behebung

• HTTP 401 – Beim Token fehlt wahrscheinlich der Scope Audit.Read . Führen Sie uip logout && uip login aus, um ein neues Token zu Mining.
• HTTP 403 – Dem angemeldeten Benutzer fehlt die Prüfungs-Lese-Berechtigung für diesen Mandanten; Überprüfen Sie die Rollenzuweisungen in der Automation Cloud.
• Tenant ID required (Mandanten-Scope) – übergeben Sie --tenant-id <guid> oder melden Sie sich an und wählen Sie zuerst einen Mandanten aus.
• HTTP 504 beim Export oder „Prüfungsexport für <date>fehlgeschlagen“ – bei einem einzelnen Tagesblock ist eine Zeitüberschreitung aufgetreten. Erneut ausführen – der Export ist idempotent. Wenn der Fehler weiterhin besteht, grenzen Sie --from-date/--to-date ein, um den fehlgeschlagenen Tag zu überspringen.
• „löst außerhalb des Ausgabeordners auf“/unsicherer Dateiname beim Export – zeigt eine falsch formatierte Serverantwort an; erneut ausführen und melden, wenn das Problem weiterhin besteht.

Zugehörig

• uip admin – Übersicht über das gesamte uip admin -Tool.
• uip or audit-logs – Der Prüfungspfad der Orchestrator-Entität, eine andere Oberfläche von dieser Prüfung auf Administratorebene.

Siehe auch

• Globale Optionen
• Exitcodes