- Versionshinweise
- Einleitung
- Governance
- Quellenkontrolle
- CI/CD-Pipelines
- Verwalten von Feeds
- Protokollierung
Ausführen von Aufgaben
Das Ausführen von Aufgaben innerhalb der UiPath CLI für Windows-Geräte (UiPath.CLI.Windows) erfordert mehrere Aufgaben.
Die Hauptunterschiede zwischen Prozeduren für UiPath.CLI.Windows und Prozeduren für UiPath.CLI (UiPath CLI für Linux-Geräte) bestehen in zusätzlichen Argumenten, die Sie mit einigen Aufgaben übergeben können, die spezifisch für Ihren Gerätetyp sind läuft weiter.
The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.
Die folgende Tabelle zeigt die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API, um eine CLI-Aufgabe auszuführen.
Anwendungs-Scope |
Beschreibung |
---|---|
ODER.Assets |
Lese- und Schreibzugriff für Assets im Orchestrator. |
ODER.BackgroundTasks |
BackgroundTasks Lese- und Schreibzugriff im Orchestrator. |
ODER.Ausführung |
Lese- und Schreibzugriff für die Ausführung im Orchestrator. |
ODER.Ordner |
Lese- und Schreibzugriff für Ordner im Orchestrator. |
ODER.Aufträge |
Aufträge Lese- und Schreibzugriff im Orchestrator. |
ODER.Maschinen.Lesen |
Maschinen-Lesezugriff im Orchestrator. |
ODER.Überwachung |
Überwachen des Lese- und Schreibzugriffs im Orchestrator. |
OR.Robots.Read |
Lesezugriff von Robotern im Orchestrator. |
ODER.Einstellungen.Lesen |
Lesezugriff auf Einstellungen im Orchestrator. |
ODER.TestSets |
Lese- und Schreibzugriff für TestSets im Orchestrator. |
ODER.TestSetExecutions |
Lese- und Schreibzugriff für TestSetExecutions im Orchestrator. |
ODER.TestSetSchedules |
TestSetSchedules Lese- und Schreibzugriff im Orchestrator. |
ODER.Benutzer.Lesen |
Benutzer-Lesezugriff im Orchestrator. |
Zusätzlich zu den in der Tabelle aufgeführten Scopes ist OR.Default ein wichtiger Scope, der hervorgehoben werden muss. Der Scope OR.Default fungiert als Platzhalter. Sie bietet differenzierten, rollenspezifischen Zugriff sowohl auf Organisations- als auch auf Ordnerebene. Dies gibt Ihnen die Flexibilität, über die vordefinierten organisationsweiten Scopes hinaus die Anwendungsberechtigungen genau zu steuern. Weitere Informationen finden Sie unter Deklarieren von Scopes.
So registrieren Sie eine externe Anwendung, damit sie OAuth verwenden kann, um auf Ihre UiPath-Ressourcen zuzugreifen:
Voraussetzungen: Um die UiPath CLI für Windows zu verwenden und Aufgaben auszuführen, installieren Sie .NET 6.0.7, das .NET 6.0.7 Desktop Runtimeenthalten muss, das mit dem 6.0.302 SDK geliefert wird.
uipcli.exe
einschließlich der entsprechenden Parameter aufrufen. Um Unteraufgaben auszuführen, muss der Befehl das folgende Format haben: uipcli.exe <task name> <sub-task name>
. So führen Sie die CLI aus:
- Öffnen Sie eine Eingabeaufforderung und navigieren Sie zu dem Ordner, der aus der NUPKG-Datei extrahiert wurde.
- Geben Sie
uipcli.exe
ein und wählen Sie die Eingabetaste aus.
Voraussetzungen: Um die UiPath CLI for Cross-Platform zu verwenden und Auftragsaufgaben auszuführen, installieren Sie .NET 6.0.7, das mit dem 6.0.302 SDK geliefert wird.
uipcli.exe
einschließlich der entsprechenden Parameter aufrufen. Um Unteraufgaben auszuführen, muss der Befehl das folgende Format haben: dotnet uipcli.dll <task name> <sub-task name>
. So führen Sie die CLI aus:
- Öffnen Sie eine Eingabeaufforderung und navigieren Sie zu dem Ordner, der aus der NUPKG-Datei extrahiert wurde.
- Geben Sie
dotnet uipcli.dll
ein und wählen Sie die Eingabetaste aus.
Voraussetzungen:
- Erstellen Sie Assets im Orchestrator.
- Erstellen Sie eine CSV-Datei, die die Assets enthält, die Sie löschen möchten. Die CSV-Datei muss die folgenden drei Spalten enthalten:
name
,type
undvalue
. Die Datenzellen unter den Spaltentype
undvalue
können leer bleiben. - Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Weitere Informationen zur CSV-Datei finden Sie in den Beispielen in der folgenden Tabelle:
name |
Typ |
Wert |
---|---|---|
asset1_name | N/A | N/A |
asset2_name |
Bool |
|
asset3_name |
Integer | N/A |
asset4_name |
Anmeldeinformationen |
username:password |
Um Assets aus dem Orchestrator zu löschen, führen Sie die folgenden Schritte aus:
Verwendung:
uipcli asset delete <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>]
uipcli asset delete <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>]
Beispiele für minimale Befehle:
Uipcli Asset Delete „C:\userprofile\assets.csv“ „https://orch-23-10-paas.cloudapp.azure.com/“ "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
Uipcli Asset Delete „C:\userprofile\assets.csv“ „https://orch-23-10-paas.cloudapp.azure.com/“ Mandantenname -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders ODER.BackgroundTasks ODER.TestSets ODER.TestSetExecutions ODER.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/ Identität“ -o "Ordnername" --traceLevel "Information"
Uipcli Asset Delete „C:\userprofile\assets.csv“ „https://automation-suite.base.url.com/“ Mandantenname -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders ODER.BackgroundTasks OR.TestSets ODER.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 Delete „C:\userprofile\assets.csv“ „https://cloud.uipath.com/“ Mandantenname -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"
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
unddescription
. - Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(für Linux) 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 folgenden Beispiel.
name |
Typ |
Wert |
Beschreibung |
---|---|---|---|
asset_1_name |
text |
„Ich habe einen Kommentar“ |
asset_1_description |
asset_2_name |
Integer |
|
asset_2_description |
asset_3_name |
Bool |
|
asset_3_description |
asset_4_name |
Anmeldeinformationen |
username:password |
asset_4_description |
Führen Sie die folgenden Schritte aus, um Assets im Orchestrator bereitzustellen:
Verwendung:
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>]
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>]
Beispiele für minimale Befehle:
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 "Ordnername" --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"
- Erstellen Sie einen Prozess im Orchestrator.
- Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Um einen Auftrag innerhalb des Orchestrators auszuführen, führen Sie die folgenden Schritte aus:
Verwendung:
uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-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>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]
uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-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>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]
Beispiele für minimale Befehle:
-
uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
-
uipcli job run ProcessName "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 job run ProcessName "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 job run ProcessName „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"
Voraussetzungen:
- Erstellen Sie ein Projekt.
- Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Führen Sie die folgenden Schritte aus, um ein Projekt zu analysieren:
Die Projektvalidierung wird nicht von den Pack- oder Analyze-Aufgaben der UiPath-CLI durchgeführt.
Parameter |
Beschreibung |
---|---|
|
Wählen Sie aus, welche Nachrichtentypen nach der Analyse ausgegeben werden sollen:
|
|
Der Auftrag schlägt fehl, wenn eine Regel verletzt wird. |
|
Warnungen als Fehler behandeln. |
|
Der vollständige Pfad zu einer JSON-Datei, in der Sie die Ergebnisse speichern möchten. Wenn Sie dies nicht als Argument hinzufügen, werden die Ergebnisse nur in der Standardkonsole ausgegeben. |
|
Übergeben Sie Governance-Richtlinien, die die Workflow-Analyse-Regeln enthalten. Richtlinien können von Automation Ops Governance heruntergeladen oder aus der exportierten komprimierten ZIP-Datei von Studio extrahiert werden. Hinweis:
Die Aufgabe schlägt fehl, wenn Sie die Verwendung einer Richtlinie angeben, die Richtliniendatei sich jedoch nicht im angegebenen Pfad befindet. |
|
Eine durch Kommas getrennte Liste von Regeln, die Sie während der Analyse ignorieren möchten. |
-u , --orchestratorUsername (*)
(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 , --orchestratorPassword (*)
(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 , -orchestratorAuthToken (*)
(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden) |
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 , --orchestratorAccountName (*)
(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden) |
Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln. |
-A , --orchestratorAccountForApp (*)
|
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 , --orchestratorApplicationId (*)
(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden) |
Die ID der externen Anwendung. Sie müssen sie mit dem **Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln. |
-S , --orchestratorApplicationSecret (*)
(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden) |
Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln. |
--orchestratorApplicationScope (*)
(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden) |
Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungsgeheimnis für eine externe Anwendungen koppeln. |
--orchestratorFolder (*)
|
Der Name des Ziel-Orchestrator-Ordners. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel
AccountingTeam\TeamJohn .
|
--orchestratorUrl (*)
|
Die URL der Orchestrator-Instanz. |
--orchestratorTenant (*)
|
Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten. |
-l , --language |
Die Orchestrator-Sprache. |
|
Zeigt die Ablaufverfolgung der Ereignisse an. |
-identityUrl (Nur für PaaS-Bereitstellungen erforderlich )
| Die URL Ihres Identitätsservers. |
|
Deaktivieren Sie integrierte NuGet-Feeds. |
Project(s) Path (pos.0) (erforderlich)
| Der Pfad zur project.json -Datei oder der Pfad zum Ordner, der mehrere project.json -Dateien enthält.
|
Verwendung:
uipcli package analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--treatWarningsAsErrors] [--resultPath <result_path>] [--governanceFilePath <governance_file_path>] [--ignoredRules <rule_id_1,rule_id_2>] [--orchestratorUrl <orchestrator_url> --orchestratorTenant <orchestrator_tenant>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --orchestratorApplicationScope <application_scope>] [--orchestratorFolder <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>] [--disableBuiltInNugetFeeds]
uipcli package analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--treatWarningsAsErrors] [--resultPath <result_path>] [--governanceFilePath <governance_file_path>] [--ignoredRules <rule_id_1,rule_id_2>] [--orchestratorUrl <orchestrator_url> --orchestratorTenant <orchestrator_tenant>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --orchestratorApplicationScope <application_scope>] [--orchestratorFolder <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>] [--disableBuiltInNugetFeeds]
Beispiele für minimale Befehle:
-
uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json"
-
uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
-
uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --orchestratorApplicationScope "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" --orchestratorFolder "FolderName" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
-
uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://automation-suite.base.url.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --orchestratorApplicationScope "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" --orchestratorFolder "FolderName"
-
uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://cloud.uipath.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --orchestratorApplicationScope "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" --orchestratorFolder "FolderName"
Voraussetzungen:
- Erstellen Sie das Paket.
- Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(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:
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>]
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"
Voraussetzungen:
- Erstellen Sie Projekte.
- Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Führen Sie die folgenden Schritte aus, um ein Projekt in ein Paket zu packen:
Die Projektvalidierung wird nicht von den Pack- oder Analyze-Aufgaben der UiPath-CLI durchgeführt.
Legende: (*) – Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek im Orchestrator haben.
Parameter |
Beschreibung |
---|---|
-o oder --output (Erforderlich)
|
Der Ziel-Orchestrator-Ordner, in den Sie die Projekte packen möchten. |
-v oder --version |
Legen Sie die Paketversion fest. |
|
Eine Paketversion automatisch generieren. |
|
Die Ausgabe in einem bestimmten Typ erzwingen. |
|
Aktiviert die Aufteilung der Ausgabe in Runtime- und Designbibliotheken. |
|
Die Repository-URL, unter der das Projekt versioniert wird. |
|
Der Repository-Commit, aus dem das Projekt erstellt wurde. |
|
Die Repository-Verzweigung, aus der das Projekt erstellt wurde. |
|
VCS-System-Repository-Typ. |
|
URL der Automation Hub-Idee. |
|
Versionshinweise hinzufügen. |
-u , --libraryOrchestratorUsername (*)
(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. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-p , --libraryOrchestratorPassword (*)
(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. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-t , --libraryOrchestratorAuthToken (*)
(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden) |
Das OAuth2-Aktualisierungstoken , das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen ihn mit dem Kontonamen und der Client-ID koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-a , --libraryOrchestratorAccountName (*)
(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden) |
Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-A , --libraryOrchestratorAccountForApp (*)
|
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. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken im Orchestrator-Feed verweist. |
-I ,--libraryOrchestratorApplicationId (*)
(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden) | Die ID der externen Anwendung. Sie müssen es mit dem Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln.
Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken im Orchestrator-Feed verweist. |
-S , --libraryOrchestratorApplicationSecret (*)
(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden) |
Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken im Orchestrator-Feed verweist. |
--libraryOrchestratorApplicationScope (*)
(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden) |
Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungsgeheimnis für eine externe Anwendungen koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken im Orchestrator-Feed verweist. |
--libraryOrchestratorFolder (*)
|
Der Name des Ziel-Orchestrator-Ordners. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel
AccountingTeam\TeamJohn .
|
--libraryOrchestratorUrl (*)
|
Die URL der Orchestrator-Instanz. |
--libraryOrchestratorTenant (*)
|
Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten. |
--libraryIdentityUrl (nur für PaaS- Bereitstellungenerforderlich )
| Die URL Ihres Identitätsservers. |
|
Zeigt die Ablaufverfolgung der Ereignisse an. |
-l oder --language |
Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird. |
|
Deaktivieren Sie integrierte NuGet-Feeds. |
Project(s) Path (pos. 0) (erforderlich)
| Der Pfad zu einer project.json -Datei oder zu einem Ordner, der project.json -Dateien enthält.
|
Verwendung:
uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--splitOutput] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]
uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--splitOutput] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]
Beispiele:
-
uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output"
-
uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
-
uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --libraryOrchestratorApplicationScope "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" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
-
uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --libraryOrchestratorApplicationScope "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" --libraryOrchestratorFolder "FolderName"
-
uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --libraryOrchestratorApplicationScope "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" --libraryOrchestratorFolder "FolderName"
Voraussetzungen:
- Erstellen Sie ein Paket oder einen Testsatz.
- Führen Sie die CLI-Datei
exe
(für Windows) oderdll
(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Führen Sie die folgenden Schritte aus, um ein Paket zu testen:
Verwendung:
uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]
uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]
Beispiele:
-
uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" "C:\userprofile\AutomationProjectWithTestCases\project.json"
-
uipcli test run "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 -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
-
uipcli test run "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 -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
-
uipcli test run "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 -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
- Anwendungsbereiche von API Access
- Hinzufügen einer externen Anwendung
- Running UiPath.CLI.Windows
- Ausführen von UiPath.CLI
- Anzeigen der CLI-Version
- Deleting assets from Orchestrator
- Deploying assets to Orchestrator
- Ausführen eines Auftrags im Orchestrator
- Analyzing a project
- Deploying a package to Orchestrator
- Packing projects into a package
- Testen eines Pakets oder Ausführen eines Testsatzes