uip Gov aops-policy Bereitstellung und bereitgestellte Richtlinie

Syntax und Optionen zum Zuweisen von AOps-Governance-Richtlinien zu Mandanten, Benutzern und Gruppen und zum Auflösen der effektiven Richtlinie zur Runtime mithilfe von „uip Gov aops-policy Deployment“ und „uip Gov aops-policy failed-policy“.

uip gov aops-policy deployment weist Governance-Richtlinien zu Governance-Themen (Mandanten, Benutzer, Gruppen) zu; uip gov aops-policy deployed-policy löst auf, welche Richtlinie tatsächlich zur Runtime angewendet wird, nachdem die Vererbung durchlaufen wurde. Informationen zum Erstellen der Richtliniendatensätze selbst finden Sie unter aops-policy. Die Übersicht über das übergeordnete Tool finden Sie unter uip gov.

Konzepte

• Auflösungsreihenfolge ist Benutzer → Gruppe → Mandant (Benutzer schlägt Gruppe schlägt Mandant). Ein Betreff ohne explizite Zuweisung für (product, license type) erbt die nächsthöhere Ebene höher.
• null Pins „No Policy“ – Übergeben von null als configure des Eintrags policyIdentifier blockiert explizit die Vererbung von der Ebene darunter, anstatt den Eintrag deaktiviert zu lassen (der normalerweise erbt).
• Jedes configure -Verb ist ein vollständiger Ersatz, keine Zusammenführung. Einträge, die in der Eingabedatei weggelassen wurden, werden aus der Zuweisungsliste dieses Betreffs entfernt. Um eine Aufgabe hinzuzufügen, während andere behalten werden, beginnen Sie mit der get -Ausgabe dieses Betreffs, bearbeiten Sie sie und reichen Sie das gesamte Array erneut ein.
• Der Scope unterscheidet sich pro Ebene: Mandantenzuweisungen werden nach (productIdentifier, licenseTypeIdentifier) eingeschränkt – eine Richtlinie pro Lizenztyp und Produkt. Benutzer- und Gruppenüberschreibungen werden nur von productIdentifier übernommen (nicht lizenztypspezifisch).
• Das Entfernen der letzten Zuweisung für einen Mandanten wird abgelehnt, nicht im Hintergrund ignoriert – der Governance-Dienst behandelt das Speichern eines leeren Zuweisungs-Arrays als No-Op, sodass deployment tenant remove explizit Fehler meldet, anstatt einen Erfolg zu melden, während die Zuweisung beibehalten wird. Heften Sie stattdessen "policyIdentifier": null über configure an.
• Um zu überprüfen, was tatsächlich gilt, verwenden Sie deployed-policy und nicht deployment ... get – letztere zeigt nur explizite Überschreibungen auf einer Ebene an, nicht das aufgelöste Ergebnis.

Zusammenfassung

uip gov aops-policy deployment tenant list [--product-name <name>] [--limit <n>] [--offset <n>]
uip gov aops-policy deployment tenant get <tenantIdentifier>
uip gov aops-policy deployment tenant configure <tenantIdentifier> --tenant-name <name> --input <path>
uip gov aops-policy deployment tenant remove <tenantIdentifier> --product-name <name> [--license-type <type>]

uip gov aops-policy deployment user list [--limit <n>] [--offset <n>]
uip gov aops-policy deployment user get <userIdentifier>
uip gov aops-policy deployment user configure <userIdentifier> --user <name> --input <path> [--source <source>] [--email <email>]
uip gov aops-policy deployment user delete <userIdentifier>

uip gov aops-policy deployment group list [--limit <n>] [--offset <n>]
uip gov aops-policy deployment group get <groupIdentifier>
uip gov aops-policy deployment group configure <groupIdentifier> --group <name> --input <path> [--source <source>]
uip gov aops-policy deployment group delete <groupIdentifier>

uip gov aops-policy deployed-policy get <license-type> <product-name> <tenantIdentifier> [--s2s-token <token> [--user-id <id> | --tenant-only]]
uip gov aops-policy deployed-policy list <license-type> <product-name> <tenantIdentifier>

Jedes Verb akzeptiert auch --login-validity <minutes> (wird bei deployed-policy get ignoriert, wenn --s2s-token festgelegt ist).

uip Gov aops-policy Bereitstellungsmandant

Basisrichtlinienzuweisungen pro Mandant, Scope durch (productIdentifier, licenseTypeIdentifier). Benutzer- und Gruppenzuweisungen überschreiben diese.

uip Gov aops-policy Bereitstellungsmandantenliste

Listet die im Governance-System registrierten Mandanten mit ihren aktuellen Zuweisungen auf. Löst vor der Rückgabe eine Upstream-Synchronisierung von OMS aus, sodass das Ergebnis den neuesten Mandantenkatalog widerspiegelt (neue Mandanten, Status deaktiviert/erneut aktiviert) – nicht nur den lokalen Cache der Governance.

Optionen

Long	Wert	Beschreibung
--product-name <product-name>	string	Nur Mandanten mit einer Zuweisung für dieses Produkt zurückgeben.
--limit <n>	Integer	Seitengröße. Der Standardwert ist 20.
--offset <n>	Integer	Nullbasierter Seitenindex.

Beispiel

uip gov aops-policy deployment tenant list --product-name StudioX --limit 2

Datenform (--output json)

{
  "Code": "AopsPolicyDeploymentTenantList",
  "Data": [
    {
      "identifier": "a1b2c3d4-0000-0000-0000-000000000100",
      "name": "Acme Tenant",
      "tenantPolicies": [
        { "productIdentifier": "StudioX", "licenseTypeIdentifier": "a1b2c3d4-0000-0000-0000-0000000000A1", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }
      ]
    }
  ]
}

Abrufen des Mandanten der UiPath aops-policy-Bereitstellung

Argumente

Name	Erforderlich	Zweck
<tenantIdentifier>	ja	Mandanten-GUID von tenant list.

Beispiel

uip gov aops-policy deployment tenant get a1b2c3d4-0000-0000-0000-000000000100

Datenform (--output json)

Die gleiche Form wie ein tenant list -Eintrag.

Konfigurieren des Mandanten der UiPath aops-policy-Bereitstellung

Ersetzen Sie die (product, license type) -Zuweisungen eines Mandanten aus einer JSON-Datei. Vollständiges Ersetzen – Einträge, die sich nicht in der Datei befinden, werden entfernt. Löst vor dem Speichern eine Upstream-OCS-Synchronisierung aus, sodass ein neu erstellter (oder Status geändert) Mandant zuerst abgeglichen wird.

Argumente

Name	Erforderlich	Zweck
<tenantIdentifier>	ja	Mandanten-GUID zum Konfigurieren.

Optionen

Long	Wert	Erforderlich	Beschreibung
--tenant-name <tenantName>	string	ja	Anzeigename – muss mit dem Namen des Mandanten im Governance-Dienst übereinstimmen.
--input <path>	Pfad	ja	JSON-Array von {productIdentifier, licenseTypeIdentifier, policyIdentifier}. policyIdentifier: null Pins „Keine Richtlinie“; lassen Sie einen Eintrag weg, um ihn normal zu vererben.

Beispiel

uip gov aops-policy deployment tenant configure a1b2c3d4-0000-0000-0000-000000000100 --tenant-name "Acme Tenant" --input tenant-policies.json

Datenform (--output json)

{
  "Code": "AopsPolicyDeploymentTenantConfigure",
  "Data": [
    { "productIdentifier": "StudioX", "licenseTypeIdentifier": "a1b2c3d4-0000-0000-0000-0000000000A1", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }
  ]
}

UIP Gov aops-policy Bereitstellungsmandant entfernen

Entfernen Sie die Zuweisung(en) eines Mandanten für ein Produkt, ohne die vollständige Liste selbst neu zu schreiben – eine clientseitige Lese-Filter-Speicherung.

Hinweis:

Nicht atomar. Dies ist lesen → filtern → speichern; eine gleichzeitige Änderung am selben Mandanten zwischen dem Lesen und Speichern geht verloren. Vermeiden Sie die gleichzeitige Ausführung für denselben Mandanten. Die letzte Zuweisung kann nicht gelöscht werden – der Dienst behandelt das Speichern eines leeren Arrays als No-Op, sodass dieser Befehl diesen Fall abgelehnt, anstatt einen falschen Erfolg zu melden. Heften Sie stattdessen "policyIdentifier": null über configure an.

Argumente

Name	Erforderlich	Zweck
<tenantIdentifier>	ja	Mandanten-GUID.

Optionen

Long	Wert	Erforderlich	Beschreibung
--product-name <product-name>	string	ja	Zu lösendes Produkt.
--license-type <license-type>	string	nein	Enge Entfernung zu einem Lizenztyp. Lassen Sie zu, jeden Lizenztypeintrag für das Produkt zu entfernen.

Fehler mit „Keine übereinstimmende Richtlinienzuweisung zum Entfernen“ wenn nichts übereinstimmt.

Beispiel

uip gov aops-policy deployment tenant remove a1b2c3d4-0000-0000-0000-000000000100 --product-name StudioX

Datenform (--output json)

{
  "Code": "AopsPolicyDeploymentTenantRemove",
  "Data": {
    "removed": [{ "productIdentifier": "StudioX", "licenseTypeIdentifier": "a1b2c3d4-0000-0000-0000-0000000000A1", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }],
    "tenantPolicies": []
  }
}

uip gov aops-policy-Bereitstellungsbenutzer

Überschreibungen pro Benutzer, nur durch productIdentifier (nicht Lizenztyp) eingeschränkt. Benutzerzuweisungen siegen für Gruppe und Mandant.

uip Gov aops-policy Benutzerliste für die Bereitstellung

Listet Benutzer auf, die der Governance-Dienst gesehen (eine Richtlinie zugewiesen oder importiert) hat – keine vollständige Liste des Identitätsanbieters.

Optionen

Long	Wert	Beschreibung
--limit <n>	Integer	Seitengröße. Der Standardwert ist 20.
--offset <n>	Integer	Nullbasierter Seitenindex.

Beispiel

uip gov aops-policy deployment user list --limit 2

Datenform (--output json)

{ "Code": "AopsPolicyDeploymentUserList", "Data": [{ "identifier": "a1b2c3d4-0000-0000-0000-000000000201", "name": "[e-mail]", "source": "cloud" }] }

Abrufen des Benutzers für die aops-policy-Bereitstellung

Überschreibungen pro Produkt, die explizit einem Benutzer zugewiesen sind – Mandanten-/Gruppenvererbung wird hier nicht aufgelöst (verwenden Sie deployed-policy get für den effektiven Wert). Gibt [] zurück, wenn der Benutzer keine Überschreibungen hat.

Argumente

Name	Erforderlich	Zweck
<userIdentifier>	ja	Benutzer-GUID von user list.

Beispiel

uip gov aops-policy deployment user get a1b2c3d4-0000-0000-0000-000000000201

Datenform (--output json)

{ "Code": "AopsPolicyDeploymentUserGet", "Data": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }

Konfiguration des Benutzers für die aops-policy-Bereitstellung

Ersetzen Sie die produktbasierten Überschreibungen eines Benutzers. Registriert den Benutzer automatisch (über einen Aufruf zum Hinzufügen von Benutzer), wenn er der Governance nicht bereits bekannt ist; wird andernfalls als vollständig ersetzender Upsert ausgeführt.

Argumente

Name	Erforderlich	Zweck
<userIdentifier>	ja	Benutzer-GUID zum Konfigurieren – von user list oder dem vorgelagerten Identitätsanbieter.

Optionen

Long	Wert	Erforderlich	Beschreibung
--user <user>	string	ja	Anzeigename, der neben dem Überschreiben gespeichert wird (in den Prüfungsprotokollen/der Benutzeroberfläche aufgetaucht).
--input <path>	Pfad	ja	JSON-Array von {productIdentifier, policyIdentifier}. policyIdentifier: null heftet „Keine Richtlinie“ an.
--source <source>	string	nein	Identitätsanbieter-Quelle (z. B. local, aad, cloud). Standard: local. Wird nur für den Upsert-Pfad verwendet – die erstmalige Registrierung löst stattdessen die Quelle von CIS auf.
--email <email>	string	nein	E-Mail, die nur bei der Registrierung eines brandneuen Benutzers verwendet wird. Wird ignoriert, sobald der Benutzer bereits bekannt ist. Die Standardeinstellung ist --user.

Beispiel

uip gov aops-policy deployment user configure a1b2c3d4-0000-0000-0000-000000000201 --user [e-mail] --input user-policies.json

Datenform (--output json)

{
  "Code": "AopsPolicyDeploymentUserConfigure",
  "Data": { "identifier": "a1b2c3d4-0000-0000-0000-000000000201", "userPolicies": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }
}

Löschen des Benutzers für die Bereitstellung von aops-policy

Löschen Sie jede Überschreibung pro Produkt für einen Benutzer in einem Aufruf – configure mit einem leeren Array, ohne dass eine JSON-Datei benötigt wird. Der Benutzer greift danach für alle Produkte auf die Gruppen-/Mandantenvererbung zurück.

Argumente

Name	Erforderlich	Zweck
<userIdentifier>	ja	Benutzer-GUID von user list.

Beispiel

uip gov aops-policy deployment user delete a1b2c3d4-0000-0000-0000-000000000201

Datenform (--output json)

{ "Code": "AopsPolicyDeploymentUserDelete", "Data": { "Status": "Deleted", "identifier": "a1b2c3d4-0000-0000-0000-000000000201" } }

uip Gov aops-policy-Bereitstellungsgruppe

Überschreibungen pro Gruppe, eingeschränkt durch productIdentifier. Setzt sich zwischen Benutzer und Mandant in der Auflösungsreihenfolge (Benutzer siegt über Gruppe, Gruppe siegt über Mandant). Die Verbform ist identisch mit deployment user (list/get/configure/delete) – nur der Betreff unterscheidet sich.

uip Gov aops-policy Bereitstellungsgruppenliste

Optionen

Wie deployment user list (--limit, --offset).

Beispiel

uip gov aops-policy deployment group list --limit 2

Datenform (--output json)

{ "Code": "AopsPolicyDeploymentGroupList", "Data": [{ "identifier": "a1b2c3d4-0000-0000-0000-000000000301", "name": "Engineering", "source": "cloud" }] }

Abrufen der aops-policy-Bereitstellungsgruppe

Argumente

Name	Erforderlich	Zweck
<groupIdentifier>	ja	Gruppen-GUID von group list.

Datenform (--output json)

{ "Code": "AopsPolicyDeploymentGroupGet", "Data": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }

Gibt [] zurück, wenn die Gruppe keine Überschreibungen hat.

Konfiguration der UiPath aops-policy Bereitstellungsgruppe

Die gleiche Form und das gleiche Verhalten bei der automatischen Registrierung wie deployment user configure, mit --group <name> anstelle von --user <name> (keine --email/--source -Semantik unterscheiden sich – --source hat hier den gleichen Standard/die gleiche Bedeutung). Gruppenmitglieder greifen auf die Mandantenvererbung für jedes Produkt zurück, das sich nicht in der Eingabedatei befindet.

Argumente

Name	Erforderlich	Zweck
<groupIdentifier>	ja	Gruppen-GUID zu konfigurieren.

Optionen

Long	Wert	Erforderlich	Beschreibung
--group <group>	string	ja	Anzeigename, der zusammen mit der Überschreibung gespeichert wird.
--input <path>	Pfad	ja	JSON-Array von {productIdentifier, policyIdentifier}.
--source <source>	string	nein	Identitätsanbieterquelle. Der Standardwert ist local.

Beispiel

uip gov aops-policy deployment group configure a1b2c3d4-0000-0000-0000-000000000301 --group Engineering --input group-policies.json

Datenform (--output json)

{
  "Code": "AopsPolicyDeploymentGroupConfigure",
  "Data": { "identifier": "a1b2c3d4-0000-0000-0000-000000000301", "groupPolicies": [{ "productIdentifier": "StudioX", "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001" }] }
}

gelöschte UiPath aops-policy-Bereitstellungsgruppe

Entfernt die Gruppe und alle ihre Richtlinienüberschreibungen aus der Governance. Die Gruppe selbst bleibt im vorgelagerten Identitätsanbieter – dadurch wird nur der Governance-Status gelöscht. Mitglieder greifen auf Zuweisungen auf Benutzer- oder Mandantenebene zurück.

Argumente

Name	Erforderlich	Zweck
<groupIdentifier>	ja	Gruppen-GUID von group list.

Datenform (--output json)

{ "Code": "AopsPolicyDeploymentGroupDelete", "Data": { "Status": "Deleted", "identifier": "a1b2c3d4-0000-0000-0000-000000000301" } }

UIP Gov aops-policy bereitgestellte Richtlinie

Schreibgeschützt. Löst die einzige effektive Richtlinie für einen Betreff aus, nachdem die Vererbung übergeben wurde – die Antwort auf „was jetzt tatsächlich gilt.“

uip Gov aops-policy failed-policy get

Argumente

Name	Erforderlich	Zweck
<license-type>	ja	Name des Lizenztyps (z. B. Attended) – von license-type list.
<product-name>	ja	Produktname (z. B StudioX) – von product list.
<tenantIdentifier>	ja	Mandanten-GUID – von deployment tenant list.

Optionen

Long	Wert	Beschreibung
--s2s-token <token>	string	Dienst-zu-Dienst-Bearer-Token, das das Benutzertoken nur für diesen Aufruf überschreibt. Bevorzugen Sie die Umgebungsvariable UIP_S2S_TOKEN gegenüber diesem Flag – ein CLI-Argumenttoken ist in Prozessauflistungen (ps aux, /proc/*/cmdline) sichtbar.
--user-id <userId>	string	Lösen Sie die effektive Richtlinie für diesen bestimmten Benutzer (vollständiger Benutzer→Gruppe→Mandantenpfad). Erfordert ein S2S-Token. Sich gegenseitig mit --tenant-only ausschließen.
--tenant-only	Markieren	Lösen Sie nur die Richtlinie auf Mandantenebene und ignorieren Sie Benutzer-/Gruppenüberschreibungen. Erfordert ein S2S-Token. Sich gegenseitig mit --user-id ausschließen.

Drei Lösungsmodi: Standard (das eigene Benutzertoken des Anrufers, löst für den Anrufer auf), S2S + --user-id (Auflösung für einen bestimmten Benutzer), S2S + --tenant-only (nur Mandantenebene). --user-id/--tenant-only ohne S2S-Token schlägt auf Clientseite fehl.

Beispiel

uip gov aops-policy deployed-policy get Attended StudioX a1b2c3d4-0000-0000-0000-000000000100

Datenform (--output json)

{
  "Code": "AopsPolicyDeployedPolicyGet",
  "Data": { "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Baseline StudioX Policy", "data": { "allowAnalytics": true, "maxProjects": 5 } }
}

Wenn keine Regel übereinstimmt und es keinen Standardwert gibt, wird Data stattdessen { "Message": "No policy applies." } (Server 204).

uip Gov aops-policy bereitgestellte Richtlinienliste

Im Gegensatz zu get (nur effektive Richtlinie mit höchster Priorität) gibt es jede Regel zurück, die auf ein (license type, product, tenant) für den aufrufenden Benutzer gilt, und zwar in der Reihenfolge ihrer Priorität – nützlich, um zu verstehen, warum ein bestimmter Wert gewinnt. Nur Benutzertoken; S2S/Identitätswechsel wird hier nicht unterstützt.

Argumente

Die gleichen drei Positionargumente wie deployed-policy get.

Beispiel

uip gov aops-policy deployed-policy list Attended StudioX a1b2c3d4-0000-0000-0000-000000000100

Datenform (--output json)

{
  "Code": "AopsPolicyDeployedPolicyList",
  "Data": [
    { "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Baseline StudioX Policy", "priority": 10, "source": "Tenant" },
    { "policyIdentifier": "a1b2c3d4-0000-0000-0000-000000000002", "name": "Restricted StudioX Policy", "priority": 20, "source": "User" }
  ]
}

Gibt [] zurück, wenn keine Regeln gelten.

Zugehörig

• uip gov – Toolübersicht und Zugriffsrichtlinien.
• aops-policy – Richtlinien-CRUD, Produkt-/Lizenztypkataloge, Vorlagen.
• compliance-packs – bündeln Sie Richtlinien in einem benannten Framework.

Siehe auch

• Tools (Plugins)
• Globale Optionen
• Exitcodes