Wiederherstellen von Automatisierungsabhängigkeiten

Prerequisites:

• 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. Excludes the built-in feeds and the NuGet sources configured at the user and machine level on the host running the CLI. The CLI resolves packages only from the feeds defined in --nugetConfigFilePath. See Managing 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	The URL of your identity server. Required when the library Orchestrator runs on UiPath Automation Suite or standalone Orchestrator (on-premises MSI). Not needed for Automation Cloud — the CLI resolves the identity server from the cloud URL.
   --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 .

Verwendung:

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

Beispiele für Mindestbefehle:

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

Hermetic restore — resolve dependencies only from the explicit nuget.config:

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