Wiederherstellen von Automatisierungsabhängigkeiten

Voraussetzungen

• Erstellen Sie eine externe Anwendung.
• Führen Sie die CLI-Datei exe (für Windows Legacy) oder dll (für Windows/Linux/maOS) aus.
• Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.

Führen Sie die folgenden Schritte aus, um die Abhängigkeiten wiederherzustellen:

1. Führen Sie die package -Aufgabe mit uipcli package aus. Sie können eine Liste der verfügbaren Unteraufgaben sehen.

2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe restore aus.

   In der folgenden Tabelle sind die erforderlichen Parameter beschrieben:

   Parameter	Beschreibung
   Project(s) Path (pos. 0)	Erforderlich. Der Pfad zu einer project.json -Datei oder zu einem Ordner, der project.json -Dateien enthält.
   --restoreFolder	Erforderlich. Pfad des Zielordners wiederherstellen.
   --nugetConfigFilePath	Optional. Pfad zur NuGet.Config-Datei mit Feeds. Das <clear /> -Tag von der angegebenen Datei wird ignoriert und nur Quellen berücksichtigt.
   --disableBuiltInNugetFeeds	Deaktivieren Sie integrierte NuGet-Feeds.
   --excludeConfiguredSources	Optional. Schließen Sie die integrierten Feeds und die NuGet-Quellen aus, die auf Benutzer- und Maschinenebene auf dem Host konfiguriert sind, auf dem die CLI ausgeführt wird. Die CLI löst Pakete nur aus den in --nugetConfigFilePath definierten Feeds auf. Siehe Verwalten von NuGet-Feeds.
   -u, --libraryOrchestratorUsername	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Der Orchestrator-Benutzername, der für die Authentifizierung verwendet wird. Muss zusammen mit dem Kennwort verwendet werden.
   -p, --libraryOrchestratorPassword	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Das für die Authentifizierung verwendete Orchestrator-Kennwort. Muss zusammen mit dem Benutzernamen verwendet werden.
   -t, --libraryOrchestratorAuthToken	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Das für die Authentifizierung verwendete Orchestrator-Aktualisierungstoken. Muss zusammen mit dem Organisationsnamen und der Client-ID verwendet werden.
   -a, --libraryOrchestratorAccountName	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Der Name der Orchestrator-Organisation. Muss zusammen mit dem Aktualisierungstoken und der Client-ID verwendet werden.
   -A, --libraryOrchestratorAccountForApp	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Der Name der Orchestrator-Organisation. Muss zusammen mit ID, Geheimnis und Scope(s) für eine externe Anwendung verwendet werden.
   -I, --libraryOrchestratorApplicationId	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Die ID der externen Anwendung. Muss zusammen mit Organisationsname, Geheimnis und Scope(s) für eine externe Anwendung verwendet werden.
   -S, --libraryOrchestratorApplicationSecret	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Der geheime Schlüssel der externen Anwendung. Muss zusammen mit Organisationsname, ID und Scope(s) für eine externe Anwendung verwendet werden.
   --libraryOrchestratorApplicationScope	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Die durch Leerzeichen getrennte Liste der Anwendungs-Scopes. Muss zusammen mit Organisationsname, ID und Geheimschlüssel für eine externe Anwendung verwendet werden.
   --libraryOrchestratorUrl	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Die Orchestrator-URL.
   --libraryOrchestratorTenant	Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek in Orchestrator haben. Der Orchestrator-Mandant.
   --libraryIdentityUrl	Die URL Ihres Identity Servers. Erforderlich, wenn der Bibliotheks-Orchestrator in der UiPath Automation Suite oder im eigenständigen Orchestrator (lokale MSI) ausgeführt wird. Nicht erforderlich für Automation Cloud – die CLI löst den Identitätsserver von der Cloud-URL auf.
   --traceLevel	Gibt an, welche Arten von Protokollmeldungen einer der folgenden Werte ausgegeben werden sollen: Keine, Kritisch, Fehler, Warnung, Information, Ausführlich. Standardwert: Information.
   -l, --language	Sprache für die übersetzten Protokolle.
   --ca-cert	Eine oder mehrere vertrauenswürdige Stammzertifikatdateien von Zertifizierungsstellen (PEM, DER oder PKCS#7), die beim Validieren der Orchestrator- und Identity Server-TLS-Zertifikate verwendet werden. Wiederholen Sie das Flag oder trennen Sie mehrere Pfade durch Komma. Weitere Informationen finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .
   --pinnedpubkey	Heften Sie den öffentlichen Schlüssel des Serverblattzertifikats an. Format: sha256//<base64>. Wird zusätzlich zur Standardzertifikatvalidierung aktiviert. Weitere Informationen finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Hinweis:

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

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

Tipp:

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

Nutzung

uipcli package restore <project_path> --restoreFolder <restore_directory> --nugetConfigFilePath <nuget_config_path> [--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>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

Minimale Befehlsbeispiele

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder ""C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\userprofile\Package\NuGet.Config"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --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 restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --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 restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --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"

Hermetische Wiederherstellung – lösen Abhängigkeiten nur von der expliziten nuget.config auf

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\ci\nuget.config" --excludeConfiguredSources