- リリース ノート
- はじめに
- ガバナンス
- ソース管理
- CI/CD パイプライン
- フィードの管理
- ログ
Automation Ops ユーザー ガイド
タスクを実行する
Windows デバイス用に設計された UiPath CLI (UiPath.CLI.Windows) 内でタスクを実行するには、必要な作業がいくつかあります。
UiPath.CLI.Windows の手順と UiPath.CLI (Linux デバイス用に設計された UiPath CLI) の手順の主な違いは、CLI を実行するデバイスの種類に固有のタスクで渡すことができる追加の引数にあります。
The action could not be performed because the project is already opened in another Studio instance. Please close it and try again. (操作を実行できませんでした。このプロジェクトは別の Studio インスタンスですでに開かれています。プロジェクトを閉じてから、もう一度お試しください。)」というエラー メッセージが表示されます。以下の表は、CLI タスクを実行するために必要な Orchestrator API アクセスのアプリケーション スコープを示しています。
|
アプリケーション スコープ |
説明 |
|---|---|
|
OR.Assets |
Orchestrator でのアセットの読み取り/書き込みアクセス権 |
|
OR.BackgroundTasks |
Orchestrator でのバックグラウンド タスクの読み取り/書き込みアクセス権 |
|
OR.Execution |
Orchestrator での実行の読み取り/書き込みアクセス権 |
|
OR.Folders |
Orchestrator でのフォルダーの読み取り/書き込みアクセス権 |
|
OR.Jobs |
Orchestrator でのジョブの読み取り/書き込みアクセス権 |
|
OR.Machines.Read |
Orchestrator でのマシンの読み取りアクセス権 |
|
OR.Monitoring |
Orchestrator での監視の読み取り/書き込みアクセス権 |
|
OR.Robots.Read |
Orchestrator での Robot の読み取りアクセス権 |
|
OR.Settings.Read |
Orchestrator での設定の読み取りアクセス権 |
|
OR.TestSets |
Orchestrator でのテスト セットの読み取り/書き込みアクセス権 |
|
OR.TestSetExecutions |
Orchestrator でのテスト セット実行の読み取り/書き込みアクセス権 |
|
OR.TestSetSchedules |
Orchestrator でのテスト セットのスケジュールの読み取り/書き込みアクセス権 |
|
OR.Users.Read |
Orchestrator でのユーザーの読み取りアクセス権 |
表に示されているスコープに加えて、強調表示する重要なスコープは OR です。デフォルト。OR.既定のスコープはワイルドカードとして機能します。組織レベルとフォルダー レベルの両方で、きめ細かいロール固有のアクセス権を提供します。 これにより、事前定義された組織全体のスコープを超えて、アプリケーションのアクセス許可を柔軟に正確に制御できます。 詳しくは、「 スコープの宣言」をご覧ください。
前提条件: Windows 用の UiPath CLI を使用してタスクを実行するには、.NET 6.0.7 をインストールします。これには、6.0.302 SDK に付属する .NET 6.0.7 Desktop Runtime が含まれている必要があります。
uipcli.exe を、対応するパラメーターを含めて呼び出します。サブタスクを実行するには、コマンドが uipcli.exe <task name> <sub-task name> の形式である必要があります。CLI を実行するには、以下の手順を実行します。
- コマンド プロンプトを開き、NUPKG ファイルから展開したフォルダーに移動します。
- 「
uipcli.exe」と入力し、Enter キーを押します。
前提条件: クロスプラットフォーム用の UiPath CLI を使用してジョブ タスクを実行するには、6.0.302 SDK に付属する .NET 6.0.7 をインストールします。
uipcli.exe を、対応するパラメーターを含めて呼び出します。サブタスクを実行するには、コマンドが dotnet uipcli.dll <task name> <sub-task name> の形式である必要があります。CLI を実行するには、以下の手順を実行します。
- コマンド プロンプトを開き、NUPKG ファイルから展開したフォルダーに移動します。
- 「
dotnet uipcli.dll」と入力し、Enter キーを押します。
前提条件:
- Orchestrator 内にアセットを作成します。
- 削除するアセットを含む CSV ファイルを作成します。CSV ファイルには、
name、type、valueの 3 つの列が必要です。type列とvalue列の下のデータ セルは空のままで構いません。 - CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
CSV ファイルについて詳しくは、以下の表の例をご覧ください。
|
name |
type |
value |
|---|---|---|
|
asset1_name | N/A | N/A |
|
asset2_name |
Bool |
|
|
asset3_name |
integer | N/A |
|
asset4_name |
Credential |
username:password |
Orchestrator からアセットを削除するには、次の手順に従います。
使用状況:
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>]最小限のコマンドの例:
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/」 TenantName -I "76000552-3e4f-4590-9317-cdb420001f1d" -s "********" --applicationScope "OR.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "フォルダ名" --traceLevel "情報"uipcli asset delete "C:\userprofile\assets.csv" 「https://automation-suite.base.url.com/」 TenantName -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。Monitoring" -o "FolderName" --traceLevel "Information"uipcli asset delete "C:\userprofile\assets.csv" 「https://cloud.uipath.com/」 TenantName -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。Monitoring" -o "FolderName" --traceLevel "Information"
前提条件:
- Orchestrator にデプロイするアセットを含む CSV ファイルを作成します。
CSV ファイルには、
name、type、value、descriptionの 4 つの列が必要です。 - CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
CSV ファイルについて詳しくは、以下の例をご覧ください。
|
name |
type |
value |
説明 |
|---|---|---|---|
|
asset_1_name |
text |
"i have a comment" |
asset_1_description |
|
asset_2_name |
integer |
|
asset_2_description |
|
asset_3_name |
Bool |
|
asset_3_description |
|
asset_4_name |
Credential |
username:password |
asset_4_description |
アセットを Orchestrator にデプロイするには、次の手順に従います。
使用状況:
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>]最小限のコマンドの例:
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.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "フォルダ名" --traceLevel "情報"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.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。Monitoring" -o "FolderName" --traceLevel "Informationuipcli asset deploy "C:\userprofile\assets.csv" 「https://cloud.uipath.com/」 "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。Monitoring" -o "FolderName" --traceLevel "Information"
- Orchestrator 内にプロセスを作成します。
- CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
Orchestrator 内でジョブを実行するには、次の手順に従います。
使用状況:
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>]最小限のコマンドの例:
-
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.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。Monitoring" -o "FolderName" --traceLevel "Information"
前提条件:
- プロジェクトを作成します。
- CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
プロジェクトを分析するには、次の手順を実行します。
プロジェクトの検証は、UiPath CLI のパック タスクや分析タスクでは実行されません。
|
パラメーター |
説明 |
|---|---|
|
|
分析後に出力するメッセージの種類を選択します。
|
|
|
ルールに違反した場合、ジョブは失敗します。 |
|
|
警告をエラーとして扱います。 |
|
|
結果を保存する JSON ファイルのフル パスです。 これを引数として追加しない場合、結果は標準コンソールにのみ出力されます。 |
|
|
ワークフロー アナライザーのルールを含むガバナンス ポリシーを渡します。 ポリシーは Automation Ops ガバナンスからダウンロードするか、 Studio からエクスポートされた圧縮 zip ファイルから抽出できます。 注:
ポリシーの使用を指定しても、ポリシー ファイルが上記のパスにない場合、タスクは失敗します。 |
|
|
分析時に無視するルールをコンマで区切って列挙したリストです。 |
-u、 --orchestratorUsername (*)
(ユーザー名とパスワードによる基本認証を使用する場合は必須) |
Orchestrator への認証に使用するユーザー名です。対応するパスワードと組み合わせて使用する必要があります。 |
-p、 --orchestratorPassword (*)
(ユーザー名とパスワードによる基本認証を使用する場合は必須) |
Orchestrator への認証に使用するパスワードです。対応するユーザー名と組み合わせて使用する必要があります。 |
-t、 -orchestratorAuthToken (*)
(トークンベースの認証を使用する場合は必須) |
Orchestrator への認証に使用する OAuth2 更新トークンです。アカウント名およびクライアント ID と組み合わせて使用する必要があります。 |
-a、 --orchestratorAccountName (*)
(トークンベースの認証を使用する場合は必須) |
Orchestrator Cloud RPA のアカウント名です。OAuth2 更新トークンおよびクライアント ID と組み合わせて使用する必要があります。 |
-A、 --orchestratorAccountForApp (*)
|
Orchestrator Cloud RPA のアカウント名 (組織名) です。外部アプリケーションのアプリケーション ID、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。 |
-I、 --orchestratorApplicationId (*)
(外部アプリケーション認証を使用する場合は必須) |
外部アプリケーション ID です。**アプリケーション アカウント、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。 |
-S、 --orchestratorApplicationSecret (*)
(外部アプリケーション認証を使用する場合は必須) |
外部アプリケーション シークレットです。アプリケーション アカウント、アプリケーション ID、アプリケーション スコープと組み合わせて使用する必要があります。 |
--orchestratorApplicationScope (*)
(外部アプリケーション認証を使用する場合は必須) |
アプリケーション スコープを単一のスペースで区切って列挙したリストです。外部アプリケーションのアプリケーション アカウント、アプリケーション ID、アプリケーション シークレットと組み合わせて使用する必要があります。 |
--orchestratorFolder (*)
|
対象の Orchestrator フォルダーの名前です。 サブフォルダーを入力するには、親フォルダーの名前とサブフォルダーの名前の両方を入力してください。例:
AccountingTeam\TeamJohn
|
--orchestratorUrl (*)
|
Orchestrator インスタンスの URL です。 |
--orchestratorTenant (*)
|
マシンを削除する Orchestrator インスタンスのテナントです。 |
-l、--language |
オーケストレーターの言語です。 |
|
|
イベントのトレースを表示します。 |
-identityUrl (PaaS デプロイの場合のみ必須 )
| Identity Server の URL です。 |
|
|
組み込みの NuGet フィードを無効化します。 |
Project(s) Path (pos.0) (必須)
| project.json ファイルのパス、または複数の project.json ファイルを含むフォルダーのパスです。
|
使用状況:
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]最小限のコマンドの例:
-
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"
前提条件:
- パッケージを作成します。
- CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
パッケージを Orchestrator にデプロイするには、次の手順に従います。
uipcli により、default エントリ ポイントを持つプロセスが作成されます。エントリ ポイントを指定した場合は、そのエントリ ポイントを持つプロセスが作成され、プロセス名に _{entryPoint} が付加されます。さらに、プロセスが手動で作成されたか、パイプラインから作成されたかにかかわらず、package.Id に関連付けられているすべてのプロセスが最新バージョンに更新されます。
使用状況:
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>]最小限のコマンドの例:
-
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"
前提条件:
- プロジェクトを作成します。
- CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
プロジェクトをパッケージにまとめるには、次の手順を実行します。
プロジェクトの検証は、UiPath CLI のパック タスクや分析タスクでは実行されません。
凡例: (*) - 任意です。Orchestrator のライブラリとの依存関係がある場合にのみ有効です。
|
パラメーター |
説明 |
|---|---|
-o または --output (必須)
|
プロジェクトのパッケージ化先の Orchestrator フォルダーです。 |
-v または --version |
パッケージのバージョンを設定します。 |
|
|
パッケージのバージョンを自動生成します。 |
|
|
特定の種類に出力を強制します。 |
|
|
ランタイムライブラリとデザインライブラリへの出力分割を可能にします。 |
|
|
プロジェクトのバージョン管理が行われるリポジトリ URL です。 |
|
|
プロジェクトのビルド元のリポジトリ コミット。 |
|
|
プロジェクトの構築元のリポジトリブランチ。 |
|
|
VCS システム リポジトリの種類。 |
|
|
Automation Hub のアイデアの URL |
|
|
リリース ノートを追加する |
-u、 --libraryOrchestratorUsername (*)
(ユーザー名とパスワードによる基本認証を使用する場合は必須) |
Orchestrator への認証に使用するユーザー名です。対応するパスワードと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
-p、 --libraryOrchestratorPassword (*)
(ユーザー名とパスワードによる基本認証を使用する場合は必須) |
Orchestrator への認証に使用するパスワードです。対応するユーザー名と組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
-t、 --libraryOrchestratorAuthToken (*)
(トークンベースの認証を使用する場合は必須) |
Orchestrator への認証に使用する OAuth2 更新トークンです。アカウント名およびクライアント ID と組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
-a、 --libraryOrchestratorAccountName (*)
(トークンベースの認証を使用する場合は必須) |
Orchestrator Cloud RPA のアカウント名です。OAuth2 更新トークンおよびクライアント ID と組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
-A、 --libraryOrchestratorAccountForApp (*)
|
Orchestrator Cloud RPA のアカウント名 (組織名) です。外部アプリケーションのアプリケーション ID、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
-I 、--libraryOrchestratorApplicationId (*)
(外部アプリケーション認証を使用する場合は必須) | 外部アプリケーション ID です。アプリケーション アカウント、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。
パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
-S、 --libraryOrchestratorApplicationSecret (*)
(外部アプリケーション認証を使用する場合は必須) |
外部アプリケーション シークレットです。アプリケーション アカウント、アプリケーション ID、アプリケーション スコープと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
--libraryOrchestratorApplicationScope (*)
(外部アプリケーション認証を使用する場合は必須) |
アプリケーション スコープを単一のスペースで区切って列挙したリストです。外部アプリケーションのアプリケーション アカウント、アプリケーション ID、アプリケーション シークレットと組み合わせて使用する必要があります。 パッケージで Orchestrator フィードのライブラリを参照する場合、必須です。 |
--libraryOrchestratorFolder (*)
|
対象の Orchestrator フォルダーの名前です。 サブフォルダーを入力するには、親フォルダーの名前とサブフォルダーの名前の両方を入力してください。例:
AccountingTeam\TeamJohn
|
--libraryOrchestratorUrl (*)
|
Orchestrator インスタンスの URL です。 |
--libraryOrchestratorTenant (*)
|
マシンを削除する Orchestrator インスタンスのテナントです。 |
--libraryIdentityUrl (PaaS デプロイの場合のみ必須)
| Identity Server の URL です。 |
|
|
イベントのトレースを表示します。 |
-l または --language |
Orchestrator のユーザー インターフェイスで使用する言語です。 |
|
|
組み込みの NuGet フィードを無効にします。 |
Project(s) Path (pos. 0) (必須)
| project.json ファイルのパス、または project.json ファイルを含むフォルダーのパスです。
|
使用状況:
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>]例:
-
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"
前提条件:
- 外部アプリケーションを作成します。
- CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
依存関係を復元するには、次の手順を実行します。
使用状況:
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] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]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] [--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"
前提条件:
- パッケージまたはテスト セットを作成します。
- CLI の
exeファイル (Windows の場合) またはdllファイル (Linux の場合) を実行します。 - 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。
パッケージをテストするには、次の手順を実行します。
使用状況:
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>]例:
-
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"
