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.

Wichtig:

Wenn Sie die UiPath-CLI verwenden, müssen Sie sicherstellen, dass das Projekt in Studio geschlossen ist. Andernfalls verursacht dies einen Konflikt, der zur folgenden Fehlermeldung in der CLI führt: The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.

Anwendungsbereiche von API Access

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.

Hinzufügen einer externen Anwendung

So registrieren Sie eine externe Anwendung, damit sie OAuth verwenden kann, um auf Ihre UiPath-Ressourcen zuzugreifen:

1. Wechseln Sie zu Administrator und wählen Sie die Organisation oben im Bereich auf der linken Seite aus.
2. Wählen Sie Externe Anwendungen aus.
3. Klicken Sie oben rechts auf Anwendung hinzufügen.
4. Füllen Sie das Feld Anwendungsname aus
5. Wählen Sie eine Option für Anwendungstyp aus.

   Wenn Sie Vertrauliche Anwendung auswählen, erhalten Sie am Ende einen geheimen App-Schlüssel, also stellen Sie sicher, dass Ihre Anwendung ihn sicher speichern kann. Wenn dies nicht der Fall ist, wählen Sie die Option Nicht vertrauliche Anwendung aus.

6. Klicken Sie unter Ressourcen auf Scopes hinzufügen.

   Das Panel Ressource bearbeiten wird rechts geöffnet, wo Sie die Ressourcen auswählen können, auf die die Anwendung Zugriff haben soll.

7. Wählen Sie von der Dropdownliste Ressource die UiPath-API aus, welche die Anwendung verwenden kann.
   Hinweis: Sie können jeweils nur einen Scope für eine Ressource hinzufügen. Wenn Sie den Zugriff auf mehrere Ressourcen zulassen möchten, wiederholen Sie diesen Vorgang, um einen Scope für jede Ressource hinzuzufügen.
8. Aktivieren Sie auf der Registerkarte Benutzer-Scope(s) nach Bedarf die Kontrollkästchen für die logischen API-Berechtigungen, die Sie gewähren möchten.

   Die Erteilung von Berechtigungen unter dem Benutzer-Scope bedeutet, dass die externe Anwendung im Rahmen eines Benutzerkontexts auf diese Ressourcen zugreifen kann und ein Benutzer mit den entsprechenden Berechtigungen angemeldet sein muss.

9. Wenn es sich um eine vertrauliche Anwendung handelt, können Sie zur Registerkarte Anwendungs-Scope(s) wechseln, um nach Bedarf auch Berechtigungen auf Anwendungsebene für die ausgewählte Ressource zu erteilen.

   Mit Berechtigungen im Anwendungs-Scope hat die externe Anwendung Zugriff auf anwendungsweite Daten für die ausgewählten Scopes, ohne dass eine Benutzerinteraktion erforderlich ist.

   Nicht vertrauliche Anwendungen können nicht auf den Anwendungs-Scope zugreifen.

10. Klicken Sie auf Speichern.

    Der Bereich wird geschlossen und die ausgewählte Ressource und die Scopes werden der Tabelle Ressourcen im Formular hinzugefügt.

11. Wenn die externe Anwendung bei Benutzer-Scopes registriert wurde, müssen Sie eine Umleitungs-URL hinzufügen, unter der die externe Anwendung die Autorisierungsantwort erhalten soll.

    Wenn nur Anwendungs-Scopes ausgewählt sind, ist die Angabe einer Umleitungs-URL optional.

12. Klicken Sie auf Hinzufügen, um die Registrierung zu erstellen.

    Eine Bestätigungsmeldung wird geöffnet. Für vertrauliche Anwendungen enthält die Bestätigungsmeldung den geheimen App-Schlüssel, den die registrierte externe Anwendung verwenden kann, um eine Autorisierung anzufordern. Speichern Sie ihn an einem sicheren Ort, da er Ihnen nicht erneut angezeigt wird.

Running UiPath.CLI.Windows

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.

Sie können Aufgaben ausführen, indem Sie 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:

1. Öffnen Sie eine Eingabeaufforderung und navigieren Sie zu dem Ordner, der aus der NUPKG-Datei extrahiert wurde.
2. Geben Sie uipcli.exe ein und wählen Sie die Eingabetaste aus.

Ausführen von UiPath.CLI

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.

Sie können Aufgaben ausführen, indem Sie 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:

1. Öffnen Sie eine Eingabeaufforderung und navigieren Sie zu dem Ordner, der aus der NUPKG-Datei extrahiert wurde.
2. Geben Sie dotnet uipcli.dll ein und wählen Sie die Eingabetaste aus.

Anzeigen der CLI-Version

Führen Sie den Befehl uipcli --version aus.

Deleting assets from Orchestrator

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 und value . Die Datenzellen unter den Spalten type und value können leer bleiben.
• 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.

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	true
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:

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

   Siehe die Liste der Parameter unten.

   Parameter	Beschreibung
   -u, oder --username (Erforderlich , wenn Sie die Standardauthentifizierungverwenden, ü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 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 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 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.
   -o oder --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 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.
   --help	Zeigt die Parameter und Beispiele für diesen Befehl an.
   --version	Zeigt Versionsinformationen an.
   Assets File (pos. 0) (Erforderlich)	Der Name der CSV-Datei, die die Assets enthält, die Sie löschen möchten.
   Orchestrator URL (pos.1) (Erforderlich)	Die URL der Orchestrator-Instanz.
   Orchestrator Tenant (pos.2) (Erforderlich) für SaaP-Bereitstellungen. (Optional) für PaaS-Bereitstellungen.	Der Mandant der Orchestrator-Instanz, in der Sie Ihre Assets verwalten möchten.

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>]

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"

Deploying assets to 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) oder dll (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	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 anzeigen.
2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe deploy aus.

   Siehe die Liste der Parameter unten.

   Parameter	Beschreibung
   -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 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 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 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.
   -o oder --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 oder --language	Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.
   --traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
   --identityUrl (Nur fürPaaS- Bereitstellungen erforderlich )	Die URL Ihres Identitätsservers.
   --help	Zeigt die Parameter und Beispiele für diesen Befehl an.
   --version	Zeigt Versionsinformationen an.
   Assets File (pos. 0) (Erforderlich)	Der Name der CSV-Datei, die die Assets enthält, die Sie löschen möchten.
   Orchestrator URL (pos.1) (Erforderlich)	Die URL der Orchestrator-Instanz.
   Orchestrator Tenant (pos.2) (Erforderlich) für SaaP-Bereitstellungen. (Optional) für PaaS-Bereitstellungen.	Der Mandant der Orchestrator-Instanz, in der Sie Ihre Assets verwalten möchten.

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>]

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"

Ausführen eines Auftrags im Orchestrator

Voraussetzungen:

• Erstellen Sie einen Prozess im Orchestrator.
• 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 einen Auftrag innerhalb des Orchestrators auszuführen, führen Sie die folgenden Schritte aus:

1. Führen Sie die job-Aufgabe mit uipcli job aus. Jetzt sehen Sie eine Liste der verfügbaren Unteraufgaben.
2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe run aus.
   Siehe die Liste der Parameter unten.

   Parameter	Beschreibung
   -i oder --input_path (Nurerforderlich , wenn der Einstiegspunkt des Workflows Eingabeparameter hat)	Der vollständige Pfad zur JSON-Eingabedatei, die dem Prozess entspricht, den Sie ausführen möchten. Beispiel für ein JSON-Dateiformat: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
   -P oder --priority	Die Priorität, mit der Sie den Auftrag ausführen möchten:- Niedrig.- Normal (Standard).- Hoch.
   -r oder --robots	Eine durch Kommas getrennte Liste bestimmter Roboternamen.
   -j oder --jobscount	Die Häufigkeit, mit der Sie den Prozess ausführen möchten. Die Standardanzahl der Prozessausführungen ist eins.
   -U oder --user	Der Name des Benutzers. Dies sollte ein Maschinenbenutzer sein, kein Orchestrator-Benutzer. Für lokale Benutzer ist das Format MaschinenName\BenutzerName.
   -M oder --machine	Der Name der Maschine, auf der Sie den Prozess ausführen möchten.
   -R oder --result_path	Der vollständige Pfad zu einer JSON-Datei oder zu einem Ordner, in dem Sie die Ergebnisse des Auftrags speichern möchten. Die Ergebnisse werden als JSON-Dateien zurückgegeben.
   -W oder --timeout	Das Timeout für Auftragsausführungen (Sekunden). Der Standardwert ist 1800 Sekunden.
   -f oder --fail_when_job_fails	Der Befehl schlägt fehl, wenn ein Auftrag fehlschlägt. Die Standardeinstellung dafür ist True.
   -w oder --wait	Der Befehl wartet, bis der Auftrag abgeschlossen ist. Die Standardeinstellung dafür ist True.
   -b oder --job_type (nur für moderne Ordner)	Der Laufzeittyp für den Auftrag. Sie können wählen:- Unattended - NonProduction .
   -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 über externe Anwendungen 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 über externe Anwendungen verwenden)	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 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.
   -o oder --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, --language	Die Orchestrator-Sprache.
   -y, --disableTelemetry	Deaktivieren der Telemetriedaten.
   --traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
   --identityUrl (nur für PaaS-Bereitstellungen erforderlich )	Die URL Ihres Identitätsservers.
   Process Name (pos.0) (Erforderlich)	Der Name des Prozesses, den Sie ausführen möchten.
   Orchestrator URL (pos.1) (Erforderlich)	Die URL der Orchestrator-Instanz.
   Orchestrator Tenant (pos.2) (Erforderlich) für SaaP-Bereitstellungen. (Optional) für PaaS-Bereitstellungen.	Der Mandant der Orchestrator-Instanz, in der Sie Prozesse ausführen möchten.

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>]

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"

Analyzing a project

Voraussetzungen:

• Erstellen Sie ein Projekt.
• 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.

Führen Sie die folgenden Schritte aus, um ein Projekt zu analysieren:

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

   Siehe die Liste der Parameter unten.

Hinweis:

Die Projektvalidierung wird nicht von den Pack- oder Analyze-Aufgaben der UiPath-CLI durchgeführt.

Legende: (*) – Optional, empfohlen bei Verwendung zusätzlicher Paket-Feeds.

Parameter	Beschreibung
--analyzerTraceLevel	Wählen Sie aus, welche Nachrichtentypen nach der Analyse ausgegeben werden sollen: Aus = Keine Nachricht anzeigen Fehler (Error) -Warnung -Info -Ausführlich.
-stopOnRuleViolation	Der Auftrag schlägt fehl, wenn eine Regel verletzt wird.
--treatWarningsAsErrors	Warnungen als Fehler behandeln.
--resultPath	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.
--governanceFilePath	Ü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.
--ignoredRules	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.
--traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
-identityUrl (Nur für PaaS-Bereitstellungen erforderlich )	Die URL Ihres Identitätsservers.
--disableBuiltInNugetFeeds	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]

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"

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 anzeigen.
2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe deploy aus.

   Siehe die Liste der Parameter unten.

   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.
   -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	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"

Packing projects into a package

Voraussetzungen:

• Erstellen Sie Projekte.
• 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.

Führen Sie die folgenden Schritte aus, um ein Projekt in ein Paket zu packen:

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

   Siehe die Liste der Parameter unten.

Hinweis:

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.
--autoVersion	Eine Paketversion automatisch generieren.
--outputType	Die Ausgabe in einem bestimmten Typ erzwingen.
--splitOutput	Aktiviert die Aufteilung der Ausgabe in Runtime- und Designbibliotheken.
--repositoryUrl	Die Repository-URL, unter der das Projekt versioniert wird.
--repositoryCommit	Der Repository-Commit, aus dem das Projekt erstellt wurde.
--repositoryBranch	Die Repository-Verzweigung, aus der das Projekt erstellt wurde.
--repositoryType	VCS-System-Repository-Typ.
--projectUrl	URL der Automation Hub-Idee.
--releaseNotes	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.
--traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
-l oder --language	Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.
--disableBuiltInNugetFeeds	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>]

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"

Testen eines Pakets oder Ausführen eines Testsatzes

Voraussetzungen:

• Erstellen Sie ein Paket oder einen Testsatz.
• 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.

Führen Sie die folgenden Schritte aus, um ein Paket zu testen:

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

   Siehe die Liste der Parameter unten.

   Parameter	Beschreibung
   -P oder --project-path	Der Pfad zur Testpaketdatei, die Sie testen möchten.
   -s oder --testset	Der Name, der für den Testsatz angezeigt wird, den Sie ausführen möchten. Stellen Sie sicher, dass der Testsatz die neueste Version der Testfälle enthält. Wenn sich der Testsatz nicht im Standardordner befindet, stellen Sie sicher, dass Sie den entsprechenden Ordnernamen davor einschließen. Verwenden Sie beispielsweise AccountingTeam\TestSet.
   --out	Der Typ der Ergebnisdatei <junit|uipath>.
   -r oder --result_path	Der Zielpfad der Datei, in der Sie die Ergebnisse speichern möchten.
   -e oder --environment (erforderlich für klassische Ordner)	Die Umgebung, in der Sie das Paket bereitstellen möchten. Sie müssen es mit dem project path .
   -w oder --timeout	Die Zeit (in Sekunden), die Sie auf die Ausführung des Testsatzes warten möchten. Der Standardwert ist 7200 Sekunden.
   -i oder --input_path (Erforderlich , wenn der Einstiegspunkt-Workflow Eingabeparameter hat, die Sie über die Befehlszeile übergeben möchten)	Der vollständige Pfad zu einer JSON-Eingabedatei.
   --attachRobotLogs	Fügt Roboterprotokolle für jeden ausgeführten Testfall und einen JUnit-Testbericht an.
   --repositoryUrl	Die Repository-URL, unter der das Projekt versioniert wird.
   --repositoryCommit	Der Repository-Commit, aus dem das Projekt erstellt wurde.
   --repositoryBranch	Die Repository-Verzweigung, aus der das Projekt erstellt wurde.
   --repositoryType	VCS-System-Repository-Typ.
   --projectUrl	URL der Automation Hub-Idee.
   --releaseNotes	Versionshinweise hinzufügen.
   --disableBuiltInNugetFeeds	Deaktivieren Sie integrierte NuGet-Feeds.
   --retryCount	Anzahl der Wiederholungen für fehlgeschlagene Testfälle (standardmäßig ist kein Wiederholungsversuch festgelegt).
   -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, --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 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 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 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.
   -o oder --organizationUnit	Der Orchestrator-Ordner, in dem Sie die Testsätze ausführen möchten.
   -l oder --language	Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.
   --traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
   --identityURL (Nur für PaaS-Bereitstellungenerforderlich )	Die URL Ihres Identitätsservers.
   Orchestrator URL (pos. 0) (Erforderlich)	Die URL der Orchestrator-Instanz.
   Orchestrator Tenant (pos. 1) (Erforderlich) für SaaP-Bereitstellungen. (Optional) für PaaS-Bereitstellungen.	Der Mandant, in dem sich das Paket oder der Testsatz befindet.

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>]

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"