UIP oder Lizenzen

uip or licenses überprüft und verwaltet die Orchestrator-Lizenzzuweisung. Listen Sie Runtime- und Named-User-Lizenzzuweisungen auf, schalten Sie die Maschinenlizenzierung ein oder aus und zeigen Sie die Gesamtzusammenfassung der Mandantenlizenzen an (zulässig vs. verwendet pro Robotertyp).

Zusammenfassung

uip or licenses <verb> [options]

Verben

Verb	Zweck
list	Listen Sie Lizenzzuweisungen für einen bestimmten Robotertyp auf (Runtime oder Named User).
toggle	Aktivieren oder Deaktivieren der Maschinenlizenzierung für einen bestimmten Runtime Robotertyp.
info	Zeigen Sie die Zusammenfassung der Mandantenlizenz an (Abonnementplan, zulässig/verwendet, Funktionen).

Referenz des Robotertyps

Das Flag --type akzeptiert diese Robotertypen. Das Befehlsverhalten teilt sich in zwei Bereiche auf:

• Runtime-Typen – Zuweisung auf Maschinenebene: Unattended, NonProduction, Headless, TestAutomation.
• Named-User-Typen – Zuweisung auf Benutzerebene: Attended, Development, Studio, StudioX, RpaDeveloper, CitizenDeveloper.

licenses list akzeptiert beide Buckets; licenses toggle akzeptiert nur Runtime-Typen.

UIP oder Lizenzenliste

Listen Sie Lizenzzuweisungen für einen bestimmten Robotertyp auf.

• Bei den Runtime-Typen ist jede Zeile eine Maschine mit einem verbundenen Roboter; MachineName, MachineType, Runtimes, IsOnline, IsLicensed und Enabled werden zurückgegeben.
• Bei Named-User-Typen ist jede Zeile ein Benutzer; UserName, LastLoginDate, MachinesCount, IsLicensed und MachineNames werden zurückgegeben.

Optionen

Short	Long	Wert	Standard	Beschreibung
-t	--tenant	name	Sitzungsstandard	Überschreiben Sie den Mandanten.
–	--type	ENUM	erforderlich	Robotertyp (siehe Liste oben).
–	--licensed	Markieren	aus	Nur lizenzierte Einträge. Sich gegenseitig mit --unlicensed ausschließen.
–	--unlicensed	Markieren	aus	Nur nicht lizenzierte Einträge. Sich gegenseitig mit --licensed ausschließen.
-l	--limit	Nummer	50	Seitengröße.
–	--offset	Nummer	0	Anzahl der Überspringungen.
–	--order-by	Feld	–	OData-Sortierung (z. B. MachineName desc).

Beispiele

uip or licenses list --type Unattended --limit 50
uip or licenses list --type Attended --unlicensed
uip or licenses list --type Unattended \
    --output-filter 'Data[?IsOnline].MachineName'

Datenform (--output json)

Runtime-Typ:

{
  "Code": "LicenseList",
  "Data": [
    {
      "Key": "a1b2c3d4-0000-0000-0000-000000000001",
      "MachineName": "prod-worker-01",
      "MachineType": "Standard",
      "Runtimes": 3,
      "IsOnline": true,
      "IsLicensed": true,
      "Enabled": true
    }
  ]
}

Named-User-Typ:

{
  "Code": "LicenseList",
  "Data": [
    {
      "Key": "d4e5f6a7-0000-0000-0000-000000000001",
      "UserName": "[e-mail]",
      "LastLoginDate": "2025-04-15T10:30:00Z",
      "MachinesCount": 2,
      "IsLicensed": true,
      "MachineNames": ["studio-01", "studio-02"]
    }
  ]
}

UIP oder Lizenzen umschalten

Aktivieren oder Deaktivieren der Maschinenlizenzierung für einen bestimmten Runtime Robotertyp. Named User-Typen werden abgelehnt. Akzeptiert einen Maschinenschlüssel (GUID), der intern in einen Maschinennamen aufgelöst wird, bevor die API aufgerufen wird.

Es muss genau eine von --enable oder --disable angegeben werden.

Argumente

Name	Erforderlich	Zweck
<machine-key>	ja	Maschinenschlüssel (GUID). Finden Sie es mit machines list.

Optionen

Short	Long	Wert	Standard	Beschreibung
-t	--tenant	name	Sitzungsstandard	Überschreiben Sie den Mandanten.
–	--type	ENUM	erforderlich	Nur Runtime-Robotertyp: Unattended, NonProduction, Headless, TestAutomation.
–	--enable	Markieren	–	Lizenzierung aktivieren.
–	--disable	Markieren	–	Lizenzierung deaktivieren.

Beispiele

uip or licenses toggle a1b2c3d4-0000-0000-0000-000000000001 \
    --type Unattended --enable

uip or licenses toggle a1b2c3d4-0000-0000-0000-000000000001 \
    --type NonProduction --disable

uip or licenses toggle a1b2c3d4-0000-0000-0000-000000000001 \
    --type Unattended --enable --output-filter 'Data.Status'

Datenform (--output json)

{
  "Code": "LicenseToggle",
  "Data": {
    "MachineKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "MachineName": "prod-worker-01",
    "RobotType": "Unattended",
    "Enabled": true,
    "Status": "Licensing enabled"
  }
}

UIP oder Lizenzinformationen

Zeigen Sie die Zusammenfassung der Mandantenlizenz an: Abonnementplan, zulässige und verwendete Anzahlen pro Robotertyp, Ablaufstatus und lizenzierte Funktionen. Damit können Sie die Gesamtkapazität vor der Zuweisung überprüfen.

Optionen

Short	Long	Wert	Standard	Beschreibung
-t	--tenant	name	Sitzungsstandard	Überschreiben Sie den Mandanten.

Beispiele

uip or licenses info
uip or licenses info --output-filter 'Data.Used'
uip or licenses info --output table

Datenform (--output json)

{
  "Code": "LicenseInfo",
  "Data": {
    "IsExpired": false,
    "SubscriptionPlan": "Enterprise",
    "Allowed": { "Unattended": 10, "Attended": 20 },
    "Used": { "Unattended": 4, "Attended": 7 },
    "LicensedFeatures": ["AISuite", "TestManager"]
  }
}

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip or machines – Verwalten Sie die Maschinen- und Slotzuweisung.
• uip or users – --license-type auf users create und users edit.

Siehe auch

• Globale Optionen.