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-AH

Verwalten Sie Automation Hub-Automatisierungsideen, die Pipeline, die Taxonomie, den Marketplace und die Benutzer mit dem Tool „uip ah“.

uip ah ist das Automation Hub-Tool (Befehlspräfix ah, Paket @uipath/automation-hub-tool): Es verwaltet die Automatisierungsideepipeline – Ideen, die über eine Bewertung eingereicht werden, die konfigurierbaren Phasen durchlaufen, bewertet und bis zur Bereitstellung nachverfolgt werden – und die Taxonomie , Zusammenarbeit und Marketplace. Installieren Sie es mit uip tools install ah oder rufen Sie uip ah … auf und lassen Sie die automatische Installation ausführen. Das Installationsmodell finden Sie unter Tools (Plugins) .

Konzepte​

  • Jeder Schreibvorgang ist ein vollständiger Ersatz des Datensatzes, kein Patch. automations update, categories update, users update und tags set senden alle die vollständige Datensatzform des Automation Hub – Felder, die Sie nicht übergeben, werden aus dem bereits gespeicherten Inhalt übernommen (oder für categories update/tags set die gesamte Sammlung wird direkt ersetzt). Überprüfen Sie die eigenen Anmerkungen jedes Verbs, um genau zu sehen, was erhalten bzw. überschrieben wird.
  • --all-fields bei jedem Lesebefehl. Ein unformatierter Automation Hub-Datensatz enthält etwa 300 Schlüssel, einschließlich eines vorformatierten __display -Zwischendatensatzes für die meisten. Jeder list/get -Befehl wird auf ein verwaltbares Feld übertragen, das standardmäßig festgelegt ist; Übergeben Sie --all-fields für die unberührte Nutzlast.
  • Mit Seiten versehene vs. ohne Seiten erstellende Endpunkte. Die meisten list -Befehle erreichen einen ausseitigen Automation Hub-Endpunkt und akzeptieren --limit/--offset normal. Einige Endpunkte (roles, idea-flows, questionnaires list, audit-logs list, collaborators list) geben ihre gesamte Sammlung in einem Aufruf ohne serverseitiges Paginieren zurück – --limit/--offset werden clientseitig angewendet auf diesen, nachdem der vollständige Satz abgerufen wurde.
  • IDs stammen von anderen list -Befehlen, nicht von der Benutzeroberfläche. Die Web-UI von Automation Hub zeigt die meisten numerischen IDs, die diese CLI verwendet (Kategorie-IDs, Phasenstatus-IDs, Rollen-IDs) nicht an – finden Sie sie mit dem entsprechenden list --all-fields -Befehl, wie die Fehlermeldungen jedes Verbs darauf hinweisen.
  • Spezifische Fehler für dieses Tool: ein 403 bedeutet „nicht sichtbar für Ihre Automation Hub-Rolle“, nie „nicht gefunden“ – Automation Hub verwendet 404 nicht für Datensätze außerhalb des Scopes. Ein Fehler der Klasse „Automation Hub ist auf diesem Mandanten nicht bereitgestellt“ der Klasse 500 oder „noch kein eigener Mandantendatensatz“ als Result: "ConfigError" mit Anweisungen zum Mandanten-Onboarding, die sich von einem Authentifizierungsfehler unterscheiden.

Ressourcen​

Jede Ressource hat eine eigene Referenzseite. Das auf jeder Seite festgelegte Verb stimmt mit den von uip ah registrierten Befehlen überein – führen Sie uip ah --help aus, um die vollständige Oberfläche Ihrer Installation zu bestätigen.

RessourceZweck
Automatisierungen, Ideenflows, Geschäftsfälle, Phasen, Fragebögen, PipelinesDer Kernlebenszyklus von der Idee bis zur Bereitstellung: Einreichen und Lesen von Automatisierungsideen, Erkennen von Phasen-/Statusübergängen, Lesen von Kosten-Nutzen-Analysen, Verschieben von Ideen durch Phasen, Lesen des Bewertungsfragenkatalogs und Lesen der nach Nutzen eingestuften Pipelineansicht.
Anwendungen, Komponenten, Dokumente, Medien, Speicherauflistungen, SpeicherbewertungenDie Automatisierungen des Anwendungsbestands sind mit Tags versehen, wiederverwendbare Komponenten, angehängte Dokumente und Medien sowie der Automation Store Marketplace (veröffentlichte Auflistungen und deren Bewertungen).
Kategorien, Tags, Mitarbeitende, Rollen, BenutzerDie Kategorietaxonomie, Freitext-Tags, Mitarbeitende pro Automatisierung und deren Rollen, der Katalog zuweisbarer Rollen und Automation Hub-Benutzerkonten.
audit-logs, auth-infoUnten auf dieser Seite werden kleine, übergreifende Dienstressourcen behandelt.

UIP-AH-Prüfung-Protokolle​

Lesen Sie den Automation Hub-Prüfungspfad. Automation Hub gruppiert den Pfad in wöchentliche CSV-Pakete anstatt in einem flaches Protokoll.

UIP-AH-Prüfungsprotokollliste​

Listen Sie Prüfungsprotokollpakete für einen Datumsbereich auf.

Optionen​
LongWertBeschreibung
--start-date <date>YYYY-MM-DDAnfang des Bereichs.
--end-date <date>YYYY-MM-DDEnde des Bereichs.
--limit <n>IntegerMaximale Anzahl der zurückzugebenden Pakete. Der Standardwert ist 20.
--offset <n>IntegerAnzahl der zu überspringenden Pakete. Der Standardwert ist 0.
--all-fieldsMarkierenGeben Sie die unformatierte Nutzlast anstelle der prognostizierten Felder Name/EntryCount zurück.

Endpunkt ohne Seiten – die gesamte Sammlung für den Datumsbereich wird abgerufen und dann auf Clientseite geöffnet. Ein leerer Pfad (ein 404 „Kein Prüfungsprotokoll wurde gefunden“) wird in ein leeres Data -Array eingebettet, anstatt als Fehler angezeigt zu werden.

Beispiel​
uip ah audit-logs list --start-date 2026-07-01 --end-date 2026-08-04
uip ah audit-logs list --start-date 2026-07-01 --end-date 2026-08-04
Datenform (--output json)​
{
  "Code": "AhAuditLogsList",
  "Data": [
    { "Name": "tenant-service-audit-log-(2026-08-02)-to-(2026-08-08).csv", "EntryCount": 12 }
  ]
}
{
  "Code": "AhAuditLogsList",
  "Data": [
    { "Name": "tenant-service-audit-log-(2026-08-02)-to-(2026-08-08).csv", "EntryCount": 12 }
  ]
}

Ein Paket, das von einem Objektreferenzblob anstelle von Inline-Einträgen unterstützt wird, gibt Uri (der Wert download --uri wird) anstelle von EntryCount zurück.

UIP-AH-Prüfung-Protokolle herunterladen​

Speichern Sie ein Prüfungsprotokollpaket als lokale CSV-Datei.

Optionen​
LongWertErforderlichBeschreibung
--uri <name>stringjaBundlename, genau wie das Feld Name von audit-logs list.
--destination <path>PfadjaLokaler Pfad, in den die CSV-Datei geschrieben werden soll.
Beispiel​
uip ah audit-logs download --uri <name> --destination ./audit.csv
uip ah audit-logs download --uri <name> --destination ./audit.csv
Datenform (--output json)​
{ "Code": "AhAuditLogsDownload", "Data": { "Destination": "./audit.csv", "Bytes": 4096, "Rows": 20 } }
{ "Code": "AhAuditLogsDownload", "Data": { "Destination": "./audit.csv", "Bytes": 4096, "Rows": 20 } }

uip-ah-auth-info​

Eindeutige Massen-Noun-Ressource – es gibt genau eine Identität pro Sitzung, sodass es nichts zu auflisten gibt.

UIP-AH-Auth-Infos abrufen​

Anzeigen des Automation Hub-Mandanten und Ihrer Identität darin – die schnellste Überprüfung, ob Automation Hub für den aktiven Mandanten aktiviert und integriert ist.

Optionen​
LongBeschreibung
--all-fieldsGeben Sie die unformatierte Nutzlast anstelle der zusammengefassten Felder Type/Tenant/User zurück.
Beispiel​
uip ah auth-info get
uip ah auth-info get
Datenform (--output json)​
{
  "Code": "AhAuthInfoGet",
  "Data": {
    "Type": "automation-cloud",
    "Tenant": { "Uuid": "...", "CompanyName": "acme - finance", "Url": "..." },
    "User": {
      "Id": 3, "Email": "jane@acme.com", "FirstName": "Jane", "LastName": "Doe",
      "JobTitle": "Analyst", "Department": "Finance", "BusinessUnit": "EMEA",
      "IsAdmin": 1, "IsActive": 1, "Roles": ["ah-system-admin"]
    }
  }
}
{
  "Code": "AhAuthInfoGet",
  "Data": {
    "Type": "automation-cloud",
    "Tenant": { "Uuid": "...", "CompanyName": "acme - finance", "Url": "..." },
    "User": {
      "Id": 3, "Email": "jane@acme.com", "FirstName": "Jane", "LastName": "Doe",
      "JobTitle": "Analyst", "Department": "Finance", "BusinessUnit": "EMEA",
      "IsAdmin": 1, "IsActive": 1, "Roles": ["ah-system-admin"]
    }
  }
}

Zusammenfassung​

uip ah audit-logs list [--start-date <date>] [--end-date <date>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah audit-logs download --uri <name> --destination <path>
uip ah auth-info get [--all-fields]
uip ah audit-logs list [--start-date <date>] [--end-date <date>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah audit-logs download --uri <name> --destination <path>
uip ah auth-info get [--all-fields]

Siehe auch​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben