automation-ops
latest
false
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.
Automation Ops Benutzerhandbuch
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 23. Okt. 2024

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/AN/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>] 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>]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:

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.
    ParameterBeschreibung
    -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"
      }
    }{
      "StringArgument_In": "MyConfigurationValue",
      "IntArgument_In": 1,
      "DictionaryArgument_In": {
        "Key1": "Value1",
        "Key2": "Value2"
      }
    }
    -P oder --priorityDie Priorität, mit der Sie den Auftrag ausführen möchten:- Niedrig.- Normal (Standard).- Hoch.
    -r oder --robotsEine durch Kommas getrennte Liste bestimmter Roboternamen.
    -j oder --jobscountDie Häufigkeit, mit der Sie den Prozess ausführen möchten. Die Standardanzahl der Prozessausführungen ist eins.
    -U oder --userDer Name des Benutzers. Dies sollte ein Maschinenbenutzer sein, kein Orchestrator-Benutzer. Für lokale Benutzer ist das Format MaschinenName\BenutzerName.
    -M oder --machineDer Name der Maschine, auf der Sie den Prozess ausführen möchten.
    -R oder --result_pathDer 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 --timeoutDas Timeout für Auftragsausführungen (Sekunden). Der Standardwert ist 1800 Sekunden.
    -f oder --fail_when_job_failsDer Befehl schlägt fehl, wenn ein Auftrag fehlschlägt. Die Standardeinstellung dafür ist True.
    -w oder --waitDer 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 --accountForAppDer 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 --organizationUnitDer 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>]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:

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

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!

    PackageNameEntryPointNameProcessName

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

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

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

    --outDer Typ der Ergebnisdatei <junit|uipath>.
    -r oder --result_pathDer 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 --timeoutDie 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.
    --attachRobotLogsFü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.

    --releaseNotesVersionshinweise hinzufügen.
    --disableBuiltInNugetFeedsDeaktivieren 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>]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"

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White
Vertrauen und Sicherheit
© 2005–2024 UiPath. Alle Rechte vorbehalten