オートメーションの依存関係を復元する

前提条件

• 外部アプリケーションを作成します。
• CLI exe (Windows レガシの場合) または dll (Windows/Linux/macOS の場合) ファイルを実行します。
• 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。

依存関係を復元するには、次の手順を実行します。

1. uipcli packageを使用して、package タスクを実行します。利用可能なサブタスクのリストが表示されます。

2. 必要なパラメーターを指定し、restore サブタスクを実行します。

   次の表で、必要なパラメーターについて説明します。

   パラメーター	説明
   Project(s) Path (pos. 0)	必須。project.json ファイルのパス、または project.json ファイルを含むフォルダーのパスです。
   --restoreFolder	必須。 復元先のフォルダパス。
   --nugetConfigFilePath	オプション。フィードを含む NuGet.Config ファイルへのパスです。指定したファイルの <clear /> タグは無視され、ソースのみが考慮されます。
   --disableBuiltInNugetFeeds	組み込みの NuGet フィードを無効にします。
   --excludeConfiguredSources	オプション。CLI を実行するホストの組み込みフィードと、ユーザーレベルおよびマシン レベルで設定された NuGet ソースは除外されます。CLI は、 --nugetConfigFilePathで定義されたフィードからのみパッケージを解決します。「 NuGet フィードを管理する」をご覧ください。
   -u、--libraryOrchestratorUsername	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 認証に使用する Orchestrator のユーザー名。 パスワードと一緒に使用する必要があります。
   -p、--libraryOrchestratorPassword	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 認証に使用する Orchestrator のパスワードです。 ユーザー名と一緒に使用する必要があります。
   -t、--libraryOrchestratorAuthToken	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 認証に使用される Orchestrator 更新トークンです。 組織名およびクライアント ID と一緒に使用する必要があります。
   -a、--libraryOrchestratorAccountName	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator の組織名。 更新トークンおよびクライアント ID と一緒に使用する必要があります。
   -A、--libraryOrchestratorAccountForApp	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator の組織名。 外部アプリケーションの ID、シークレット、スコープと共に使用する必要があります。
   -I、--libraryOrchestratorApplicationId	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 外部アプリケーション ID です。 外部アプリケーションの組織名、シークレット、スコープと共に使用する必要があります。
   -S、--libraryOrchestratorApplicationSecret	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 外部アプリケーションのシークレットです。 外部アプリケーションの組織名、ID、およびスコープと共に使用する必要があります。
   --libraryOrchestratorApplicationScope	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 スペースで区切られたアプリケーション スコープのリストです。 外部アプリケーションで、組織名、ID、シークレットと一緒に使用する必要があります。
   --libraryOrchestratorUrl	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator の URL です。
   --libraryOrchestratorTenant	任意です。Orchestrator のライブラリからの依存関係がある場合にのみ便利です。 Orchestrator テナントです。
   --libraryIdentityUrl	Identity Server の URL です。ライブラリの Orchestrator を UiPath Automation Suite または スタンドアロンの Orchestrator (オンプレミスの MSI) で実行する場合は必須です。Automation Cloud では不要 — CLI はクラウド URL から Identity Server を解決します。
   --traceLevel	出力するログ メッセージの種類を指定します。[None]、[Critical]、[Error]、[Warning]、[Information]、[Verbose] のいずれかの値を指定できます。 既定値は Information です。
   -l、--language	翻訳されたログの言語。
   --ca-cert	Orchestrator と Identity Server の TLS 証明書を検証する際に使用される、1 つ以上の信頼されたルート CA 証明書ファイル (PEM、DER、または PKCS#7)。フラグを繰り返すか、複数のパスをコンマで区切ります。詳細については、「 カスタム証明書を信頼する 」をご覧ください。
   --pinnedpubkey	サーバー リーフ証明書の公開キーをピン留めします。形式: sha256//<base64>です。標準の証明書検証に加えてチェックされます。詳細については、「 カスタム証明書を信頼する 」をご覧ください。

注:

--libraryOrchestratorApplicationScope パラメーターを指定せずに外部アプリケーション認証を使用すると、CLI は以下の既定の Orchestrator スコープを自動的に適用します。

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

ヒント:

プライベート証明機関 (UiPath Automation Suite など) によって署名された Orchestrator インスタンスの場合、このコマンドは --ca-cert パラメーターと --pinnedpubkey パラメーターも受け付けます。シナリオと例については、「 カスタム証明書を信頼する 」をご覧ください。

使用状況

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

最小限のコマンド例

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

密閉復元 — 明示的な nuget.config からのみ依存関係を解決します

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