Deploying a package to Orchestrator

Voraussetzungen:

• Erstellen Sie das Paket.
• Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
• Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.

Um ein Paket im Orchestrator bereitzustellen, führen Sie die folgenden Schritte aus:

1. Führen Sie die package -Aufgabe mit uipcli package aus. Sie können eine Liste der verfügbaren Unteraufgaben sehen.
2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe deploy aus.

   In der folgenden Tabelle sind die erforderlichen Parameter beschrieben.

   Parameter	Beschreibung
   -c oder --createProcess	Der Standardwert für ist true. Wenn sie auf true festgelegt ist, wird ein Prozess im Orchestrator-Ordner erstellt, der im Befehl übergeben wird. Wenn auf falsefestgelegt, wird kein Prozess im Orchestrator-Ordner erstellt. Beispiel: --createProcess false..
   --processNames	Geben Sie optional eine .csv- Datei mit benutzerdefinierten Namen für die zu erstellenden/aktualisierenden Prozesse. Im Folgenden finden Sie ein Beispiel dafür, wie die .csv- wie die Struktur aussehen muss. Die Spaltennamen/Header: Paketname, Einstiegspunktname und Prozessname sind erforderlich! PackageName EntryPointName ProcessName MeinPaket Main.xaml Mein Prozess Noch ein Paket CustomEntryPoint.xaml Noch ein Prozess
   --processName	Geben Sie optional einen benutzerdefinierten Namen für den zu aktualisierenden/erstellenden Prozess an.
   --ignoreLibraryDeployConflict	Ignorieren Sie den Konflikt, wenn Sie ein Bibliothekspaket mit derselben Version wie ein vorhandenes bereitstellen. Standardmäßig schlägt die Bereitstellung fehl, wenn eine Bibliothek mit derselben Version bereits in der Orchestrator-Instanz vorhanden ist.
   -e oder --environments (für klassische Ordner)	Eine durch Kommas getrennte Liste der Umgebungen, in denen Sie das Paket bereitstellen möchten. Wenn die Umgebung nicht zum Standardordner (Organisationseinheit) gehört, müssen Sie dem Umgebungsnamen den Ordnernamen voranstellen. Wenn die Umgebung beispielsweise TestEnvironmentund der Ordnername AccountingTeamist, schreiben Sie die Umgebung als AccountingTeam\TestEnvironment.
   -h oder --entryPointsPath	Definiert die spezifischen Einstiegspunkte zum Erstellen oder Aktualisieren des Prozesses. Dies ist der Dateipfad des Einstiegspunkts, beginnend beim Stamm des Projekts. Bei klassischen Ordnern kann für jede Umgebung nur ein einzelner Einstiegspunkt angegeben werden.
   -u oder --username (Erforderlich, wenn Sie die Einfache Authentifizierung 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 Einfache Authentifizierung 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 die tokenbasierte Authentifizierungverwenden)	Das OAuth2-Aktualisierungstoken , das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen ihn mit dem Kontonamen und der Client-ID koppeln.
   -a oder --accountName (Erforderlich , wenn Sie die tokenbasierte Authentifizierungverwenden)	Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln.
   -A oder --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 externer Anwendungenverwenden)	Die externe Anwendungs-ID. Sie müssen es mit dem Anwendungskonto, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich koppeln.
   -S oder --applicationSecret (Erforderlich , wenn Sie die Authentifizierung externer Anwendungenverwenden)	Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln.
   --applicationScope (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)	Die Liste der Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung koppeln.
   -o oder --organizationUnit (Erforderlich)	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 oder --language	Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.
   -y oder --disableTelemetry	Deaktivieren der Telemetriedaten.
   --traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
   --identityUrl (Nur fürPaaS- Bereitstellungen erforderlich )	Die URL Ihres Identitätsservers.
   Package(s) Path (pos. 0) (Erforderlich)	Der Pfad zu einer Paketdatei oder der Pfad zu einem Ordner, der mehrere Pakete enthält.
   Orchestrator URL (pos. 1) (Erforderlich)	Die URL der Orchestrator-Instanz.
   Orchestrator-Mandant (Pos. 2) (Erforderlich) für SaaP-Bereitstellungen. (Optional) für PaaS-Bereitstellungen.	Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten.

uipcli erstellt einen Prozess mit einem default-Einstiegspunkt, wenn Sie keinen angeben. Wenn der Einstiegspunkt angegeben ist, wird ein Prozess mit diesem Einstiegspunkt erstellt und _{entryPoint} wird an den Prozessnamen angehängt. Darüber hinaus werden alle Prozesse, die der package.Id zugeordnet sind, auf die neueste Version aktualisiert, unabhängig davon, ob der Prozess manuell oder in einer Pipeline erstellt wurde.

Verwendung:

uipcli package deploy <packages_path> <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>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

Beispiele für minimale Befehle:

• uipcli package deploy "C:\userprofile\AutomationPackages" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"

• uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "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 --entryPointsPath "Main.xaml"n

• uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "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 --entryPointsPath "Main.xaml"

• uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "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 --processNames "C:\userprofile\processNames.csv"

• uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "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 --entryPointsPath "Main.xaml" --processName "MyProcessName"