UIP-Administratorroboterkonten

Syntax und Optionen für „uip admin robot-accounts“, „uip admin pat“ und „uip admin Scopes“ – nicht-menschliche Identitäten, persönliche Zugriffstoken und die OAuth2-Scope-Referenz.

Drei verwandte, unabhängige Befehlsgruppen: robot-accounts (nicht-menschliche Verzeichnisidentitäten, die für die Unattended-Automatisierung verwendet werden), pat (persönliche Zugriffstoken für die API-Authentifizierung) und scopes (eine schreibgeschützte Referenz jedes OAuth2-Scope externe Apps und PATs).

Zusammenfassung

uip admin robot-accounts list [--search <term>] [--sort-by <field>] [--sort-order asc|desc] [--limit <n>] [--offset <n>]
uip admin robot-accounts get <robot-account-id>
uip admin robot-accounts create <name> [--display-name <name>]
uip admin robot-accounts update <robot-account-id> --display-name <name>
uip admin robot-accounts delete <robot-account-id>

uip admin pat list [--scope all] [--search <term>] [--limit <n>] [--offset <n>]
uip admin pat create --description <text> --expiration <date> --scope <scopes>
uip admin pat revoke <id>
uip admin pat regenerate <id> --expiration <date>

uip admin scopes list

Verben

„Gruppieren“ (Group)	Verb	Zweck
robot-accounts	list	Listen Sie Roboterkonten in der Partition auf.
robot-accounts	get	Rufen Sie die Details eines Roboterkontos nach ID ab.
robot-accounts	create	Ein neues Roboterkonto erstellen.
robot-accounts	update	Aktualisieren Sie den Anzeigenamen eines Roboterkontos.
robot-accounts	delete	Löschen Sie ein Roboterkonto nach ID.
pat	list	Listen Sie persönliche Zugriffstoken auf (Ihre oder die der Organisation mit --scope all).
pat	create	Erstellen Sie ein neues persönliches Zugriffstoken.
pat	revoke	Ein Token widerrufen.
pat	regenerate	Generieren Sie ein Token mit einem neuen Ablaufdatum erneut.
scopes	list	Listen Sie jeden verfügbaren OAuth2-Scope auf, gruppiert nach Ressource.

UIP-Administratorroboterkonten-Liste

Listen Sie Roboterkonten in der Partition auf. Gibt die Konto-ID, den Namen, den Anzeigenamen und die Erstellungszeit zurück.

Optionen

Long	Short	Wert	Standard	Beschreibung
--search <term>	-s	string	–	Anhand des Namens suchen.
--sort-by <field>		string	–	Sortierfeld, z. B Name).
--sort-order <direction>		asc|desc	asc	Sortierrichtung.
--limit <number>	-l	Integer	50	Anzahl der zurückzugebenden Elemente.
--offset <number>		Integer	0	Anzahl der zu überspringenden Elemente.

Beispiel

uip admin robot-accounts list --limit 5

Datenform (--output json)

{
  "Code": "RobotAccountList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "automation-bot", "displayName": "Automation Bot", "creationTime": "2026-01-15T10:00:00.000Z" }
  ]
}

UIP-Administratorroboterkonten abrufen

Rufen Sie Roboterkontodetails nach ID ab.

Argumente

Name	Erforderlich	Zweck
<robot-account-id>	ja	Roboterkonto-ID (UUID).

Beispiel

uip admin robot-accounts get a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{ "Code": "RobotAccountDetails", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "automation-bot", "displayName": "Automation Bot", "creationTime": "2026-01-15T10:00:00.000Z", "groupIds": [] } }

UIP-Administratorroboterkonten erstellen

Erstellen Sie ein neues Roboterkonto in der Partition.

Argumente

Name	Erforderlich	Zweck
<name>	ja	Roboterkontoname.

Optionen

Long	Wert	Beschreibung
--display-name <name>	string	Anzeigename. Standardmäßig <name>, wenn keine Angabe erfolgt.

Beispiel

uip admin robot-accounts create "automation-bot" --display-name "Automation Bot"

Datenform (--output json)

{ "Code": "RobotAccountCreated", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000002", "name": "automation-bot", "displayName": "Automation Bot" } }

Aktualisierung der UIP-Administratorroboterkonten

Aktualisieren Sie den Anzeigenamen eines Roboterkontos. --display-name ist das einzige Feld und effektiv erforderlich – das Entfernen schlägt auf Clientseite fehl ("No fields to update").

Argumente

Name	Erforderlich	Zweck
<robot-account-id>	ja	Roboterkonto-ID (UUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--display-name <name>	string	ja	Neuer Anzeigename.

Beispiel

uip admin robot-accounts update a1b2c3d4-0000-0000-0000-000000000001 --display-name "Updated Bot"

Datenform (--output json)

{ "Code": "RobotAccountUpdated" }

UIP-Administratorroboterkonten löschen

Löschen Sie ein Roboterkonto nach ID.

Argumente

Name	Erforderlich	Zweck
<robot-account-id>	ja	Roboterkonto-ID (UUID).

Beispiel

uip admin robot-accounts delete a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{ "Code": "RobotAccountDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Deleted successfully" } }

UIP-Administrator-Patchliste

Listen Sie persönliche Zugriffstoken auf. Standardmäßig werden nur Ihre eigenen aufgeführt; --scope all (nur Administrator) listet jedes Token in der Organisation auf.

Optionen

Long	Wert	Beschreibung
--scope <scope>	all	Nur "all" wird akzeptiert – jeder andere Wert schlägt auf Clientseite mit einem expliziten Fehler fehl. Lassen Sie es zu, nur Ihre eigenen Token aufzulisten.
--search <term>	string	Filtern nach Benutzersuchbegriff. Impliziert --scope all auch wenn --scope nicht übergeben wird.
--limit <number> (-l)	Integer	Der Standardwert ist 50. Anzahl der zurückzugebenden Elemente.
--offset <number>	Integer	Der Standardwert ist 0. Anzahl der zu überspringenden Elemente.

Beispiel

uip admin pat list

Datenform (--output json)

{
  "Code": "PatList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "description": "CI/CD token", "expiration": "2027-01-15T00:00:00.000Z", "scopes": ["OR.Folders.Read"] }
  ]
}

UIP-Administratorpatch erstellen

Erstellen Sie ein neues persönliches Zugriffstoken. Der Tokenwert wird nur einmal zurückgegeben – er ist später nicht mehr abrufbar.

Optionen

Long	Wert	Erforderlich	Beschreibung
--description <text>	string	ja	Beschreibung für das Token.
--expiration <date>	YYYY-MM-DD	ja	Ablaufdatum. Strikt validiert – weist falsch formatierte Datumsangaben und Kalenderüberrollen zurück (z. B. 2027-02-30).
--scope <scopes>	durch Kommas getrennt sind	ja	Ein oder mehrere Scopes, z. B. OR.Folders.Read,OR.Jobs.Read). Den vollständigen Katalog finden Sie unter scopes list .

Beispiel

uip admin pat create --description "CI/CD token" --expiration 2027-01-15 --scope "OR.Folders.Read,OR.Jobs.Read"

Datenform (--output json)

{ "Code": "PatCreated", "Data": { "Token": "...", "Warning": "Save this token now. It will not be shown again." } }

UIP-Administratorpatch widerrufen

Widerrufen Sie ein persönliches Zugriffstoken.

Argumente

Name	Erforderlich	Zweck
<id>	ja	Token-ID (UUID). Finden Sie es mit pat list.

Beispiel

uip admin pat revoke a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{ "Code": "PatRevoked", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Revoked successfully" } }

UIP-Administratoraktualisierung

Generieren Sie erneut ein persönliches Zugriffstoken mit einem neuen Ablaufdatum. Wie create wird der neue Tokenwert nur einmal angezeigt.

Argumente

Name	Erforderlich	Zweck
<id>	ja	Token-ID (UUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--expiration <date>	YYYY-MM-DD	ja	Neues Ablaufdatum. Die gleiche strenge Validierung wie bei create.

Beispiel

uip admin pat regenerate a1b2c3d4-0000-0000-0000-000000000001 --expiration 2028-01-15

Datenform (--output json)

{ "Code": "PatRegenerated", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Token": "...", "Warning": "Save this token now. It will not be shown again." } }

Liste der Administrator-Scopes

Listen Sie jeden OAuth2-Scope auf, der für externe Apps und persönliche Zugriffstoken verfügbar ist, gruppiert nach Ressource. Schreibgeschützt, keine Optionen über globale Optionen hinaus.

Beispiel

uip admin scopes list

Datenform (--output json)

{
  "Code": "ScopesList",
  "Data": [
    {
      "name": "UiPath.Orchestrator",
      "displayName": "Orchestrator API Access",
      "scopes": [
        { "name": "OR.Folders", "displayName": "OR.Folders", "type": "user" }
      ]
    }
  ]
}

type für jeden Scope-Eintrag ist "user" (delegiert, erfordert einen angemeldeten Benutzer) oder "application" (nur App) – die gleiche Unterscheidung der external-apps create-Flags --user-scope/--app-scope und pat create --scope von }Flag aus.

Zugehörig

• uip admin users – Verzeichnisbenutzer und -gruppen.
• uip admin external-apps – OAuth2 Client-Registrierungen, die denselben Scope-Katalog verwenden.
• uip admin smtp – E-Mail-Konfiguration der Organisation.

Siehe auch

• Globale Optionen
• Exitcodes