Bereitstellen von Assets im Orchestrator

Voraussetzungen

• Erstellen Sie eine CSV-Datei, die die Assets enthält, die Sie im Orchestrator bereitstellen möchten.

  Die CSV-Datei muss die folgenden drei Spalten enthalten: name , type , value und description .

• Führen Sie die CLI-Datei exe (für Windows Legacy) oder dll (für Windows/Linux/maOS) aus.

• Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.

Weitere Informationen zur CSV-Datei finden Sie im Beispiel in der folgenden Tabelle.

name	Typ	Wert	Beschreibung
asset_1_name	text	„Ich habe einen Kommentar“	asset_1_description
asset_2_name	Integer	1	asset_2_description
asset_3_name	Bool	false	asset_3_description
asset_4_name	Anmeldeinformationen	username:password	asset_4_description

Führen Sie die folgenden Schritte aus, um Assets im Orchestrator bereitzustellen:

1. Führen Sie die asset -Aufgabe mit uipcli asset aus. Sie können eine Liste der verfügbaren Unteraufgaben sehen.
2. Geben Sie die erforderlichen Parameter an und führen Sie die deploy -Unteraufgabe aus. In der folgenden Tabelle sind die erforderlichen Parameter beschrieben:

Parameter	Beschreibung
Assets File (pos. 0) ( Erforderlich )	Der Name der CSV-Datei, die die bereitzustellenden Assets enthält.
Orchestrator URL (pos. 1) ( Erforderlich )	Die URL der Orchestrator-Instanz.
Orchestrator Tenant (pos. 2)	Der Mandant der Orchestrator-Instanz, in der Sie Ihre Assets bereitstellen möchten. Erforderlich, wenn Sie die Automation Cloud als Ziel haben. Optional für die Automation Suite und den eigenständigen Orchestrator (lokale MSI), bei denen der Mandant Teil der URL ist.
-u oder --username ( Erforderlich , wenn Sie die Standardauthentifizierung verwenden, über einen Benutzernamen und ein Kennwort)	Der Benutzername, der für die Authentifizierung bei Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Kennwort koppeln.
-p oder --password ( Erforderlich , wenn Sie die Standardauthentifizierung verwenden, über einen Benutzernamen und ein Kennwort)	Das Kennwort, das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Benutzernamen koppeln.
-t oder --token ( Erforderlich , wenn Sie tokenbasierte Authentifizierung verwenden )	Das OAuth2-Aktualisierungstoken, das für die Authentifizierung bei Orchestrator verwendet wird. Sie müssen es mit dem Kontonamen und der Client-ID koppeln.
-a oder --accountName ( Erforderlich , wenn Sie tokenbasierte Authentifizierung verwenden )	Der Name des Orchestrator CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-ID koppeln.
-A , or --accountForApp	Der Name des Orchestrator CloudRPA-Kontos (Organisationsname). Sie müssen ihn mit der Anwendungs-ID, dem Anwendungsgeheimnis und dem Anwendungs-Scope für eine externe Anwendung koppeln.
-I oder --applicationId ( Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden )	Die ID der externen Anwendung. Sie müssen es mit dem Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln.
-S oder --applicationSecret ( Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden )	Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln.
--applicationScope ( Optional für die Authentifizierung externer Anwendungen )	Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Optional, wenn die Authentifizierung einer externen Anwendung verwendet wird, da Standard-Scopes automatisch angewendet werden. Sie müssen es mit dem Anwendungskonto , der Anwendungs-ID und dem Anwendungsgeheimnis für eine externe Anwendungen koppeln.
-o , or --organizationUnit	Der Name des Orchestrator-Ordners (Organisationseinheit). Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
-l , or --language	Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.
--traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
--identityUrl	Die URL Ihres Identity Servers. Erforderlich, wenn der Orchestrator auf der UiPath Automation Suite oder einem eigenständigen Orchestrator (lokale MSI) ausgeführt wird. Nicht erforderlich für Automation Cloud – die CLI löst den Identitätsserver von der Cloud-URL auf.
--help	Zeigt die Parameter und Beispiele für diesen Befehl an.
--version	Zeigt Versionsinformationen an.
--ca-cert	Eine oder mehrere vertrauenswürdige Stammzertifikatdateien von Zertifizierungsstellen (PEM, DER oder PKCS#7), die beim Validieren der Orchestrator- und Identity Server-TLS-Zertifikate verwendet werden. Wiederholen Sie das Flag oder trennen Sie mehrere Pfade durch Komma. Weitere Informationen finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .
--pinnedpubkey	Heften Sie den öffentlichen Schlüssel des Serverblattzertifikats an. Format: sha256//<base64>. Wird zusätzlich zur Standardzertifikatvalidierung aktiviert. Weitere Informationen finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Tipp:

Für Orchestrator-Instanzen, die von einer privaten Zertifizierungsstelle signiert wurden (z. B. UiPath Automation Suite), akzeptiert dieser Befehl auch --ca-cert und --pinnedpubkey Parameter. Szenarien und Beispiele finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Hinweis:

Wenn Sie die Authentifizierung einer externen Anwendung verwenden, ohne den Parameter --applicationScope anzugeben, wendet die CLI automatisch diese standardmäßigen Orchestrator-Scopes an:

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Nutzung

uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

Minimale Befehlsbeispiele

• uipcli asset deploy "C:\userprofile\assets.csv" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
• uipcli asset deploy "C:\userprofile\assets.csv" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel "Information"
• uipcli asset deploy "C:\userprofile\assets.csv" "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information
• uipcli asset deploy "C:\userprofile\assets.csv" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"