Orchestrator にパッケージをデプロイする

前提条件:

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

パッケージを Orchestrator にデプロイするには、次の手順に従います。

1. uipcli package を使用して package タスクを実行します。利用可能なサブタスクのリストが表示されます。
2. 必要なパラメーターを指定し、deploy サブタスクを実行します。 以下のパラメーターのリストをご覧ください。

パラメーター	説明
-c , or --createProcess	既定値は true です。 [ true ] に設定すると、コマンドで渡したプロセスが Orchestrator フォルダー内に作成されます。false に設定すると、Orchestrator フォルダー内にプロセスが作成されません。例: --createProcess false .
-e 、または --environments (クラシック フォルダーの場合)	パッケージのデプロイ先のロボット グループをコンマで区切って列挙したリストです。 ロボット グループが既定のフォルダー (組織単位) に属していない場合は、ロボット グループの名前にプレフィックスとしてフォルダー名を付ける必要があります。たとえば、ロボット グループが TestEnvironment で、フォルダー名が AccountingTeam である場合は、ロボット グループを AccountingTeam\TestEnvironment として記述します。
-h , or --entryPointsPath	プロセスを作成または更新するために使用するエントリ ポイントを定義します。この値は、プロジェクトのルートから始まるエントリ ポイントのファイル パスです。 クラシック フォルダーで指定できるエントリ ポイントはロボット グループごとに 1 つだけです。
-u 、または --username ( 基本認証を使用する場合は必須、ユーザー名とパスワードを使用)	Orchestrator への認証に使用するユーザー名です。対応するパスワードと組み合わせて使用する必要があります。
-p 、または --password ( 基本認証を使用する場合は必須、ユーザー名とパスワードを使用)	Orchestrator への認証に使用するパスワードです。対応するユーザー名と組み合わせて使用する必要があります。
-t 、または--token ( トークンベースの認証 を使用する場合は 必須)	Orchestrator への認証に使用する OAuth2 更新トークンです。アカウント名およびクライアント ID と組み合わせて使用する必要があります。
-a 、または--accountName ( トークンベースの認証 を使用する場合は 必須)	Orchestrator Cloud RPA のアカウント名です。OAuth2 更新トークンおよびクライアント ID と組み合わせて使用する必要があります。
-A , or --accountForApp	Orchestrator Cloud RPA のアカウント名 (組織名) です。外部アプリケーションのアプリケーション ID、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。
-I または--applicationId ( 外部アプリケーション認証 を使用する場合は 必須 )	外部アプリケーション ID です。アプリケーション アカウント、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。
-S または--applicationSecret ( 外部アプリケーション認証 を使用する場合は 必須 )	外部アプリケーション シークレットです。アプリケーション アカウント、アプリケーション ID、アプリケーション スコープと組み合わせて使用する必要があります。
--applicationScope (外部アプリケーション認証を使用する場合は必須)	アプリケーション スコープを単一のスペースで区切って列挙したリストです。外部アプリケーションのアプリケーション アカウント、アプリケーション ID、アプリケーション シークレットと組み合わせて使用する必要があります。
-o , or --organizationUnit	Orchestrator フォルダー (組織単位) の名前です。 サブフォルダーを入力するには、親フォルダーの名前とサブフォルダーの名前の両方を入力してください。例: AccountingTeam/TeamJohn
-l , or --language	Orchestrator のユーザー インターフェイスで使用する言語です。
-y , or --disableTelemetry	テレメトリ データを無効化します。
--traceLevel	イベントのトレースを表示します。
--identityUrl ( PaaS または MSI デプロイに必要)	Identity Server の URL です。
--help	このコマンドのパラメーターと例を表示します。
--version	バージョン情報を表示します。
Package(s) Path (pos. 0) (必須)	1 つのパッケージ ファイルのパス、または複数のパッケージを含むフォルダーのパスです。
Orchestrator URL (pos. 1) (必須)	Orchestrator インスタンスの URL です。
Orchestrator テナント (位置 2) (必須) SaaS デプロイの場合。 (任意) PaaS デプロイの場合。`	マシンを削除する Orchestrator インスタンスのテナントです。

エントリ ポイントを指定しない場合、uipcli により、default エントリ ポイントを持つプロセスが作成されます。エントリ ポイントを指定した場合は、そのエントリ ポイントを持つプロセスが作成され、プロセス名に _{entryPoint} が付加されます。さらに、プロセスが手動で作成されたか、パイプラインから作成されたかにかかわらず、package.Id に関連付けられているすべてのプロセスが最新バージョンに更新されます。

使用状況:

package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <account_for_app> -I <application_id> -S <application_secret> --applicationScope] [-o <folder_organization_unit>] [-c <create_process>] [-e <environment_list>] [-l <language>]

例:

• package deploy "C:\UiPath\Project 1" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456
• package deploy "C:\UiPath\Project\Package.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US
• package deploy "C:\UiPath\Project\Package.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read"
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US -h EntryPoint1,EntryPoint2