将包部署到 Orchestrator

Prerequisites:

• 创建包。
• 运行 CLI exe （适用于 Windows）或dll （适用于 Linux）文件。
• 添加所需的 Orchestrator API 访问应用程序作用域。

要将包部署到 Orchestrator，请执行以下步骤：

1. 使用uipcli package运行package任务。您可以注意可用子任务的列表。
2. 指定所需的参数并运行deploy子任务。下表介绍了必需参数。

参数	描述
-c, or --createProcess	默认值为true 。 当设置为true时，它会在 Orchestrator 文件夹中创建一个在命令中传递的流程。 设置为false时，不会在 Orchestrator 文件夹中创建流程。例如： --createProcess false 。
--processNames	（可选）提供一个 .csv 为要创建/更新的流程添加自定义名称。 以下示例说明了如何将 .csv结构必须看起来很清楚。列名称/标头“包名称” 、 “入口点名称”和“流程名称”为必填项！ PackageName EntryPointName 流程名称 我的包 Main.xaml 我的流程 另一个包 自定义入口点.xaml 另一个流程
--processName	（可选）为要更新/创建的流程提供自定义名称。
--ignoreLibraryDeployConflict	部署与现有库包版本相同的库包时，请忽略冲突。默认情况下，如果 Orchestrator 实例中已存在相同版本的库，则部署将失败。
-e、 --environments （适用于传统文件夹）	要部署包的环境列表，用逗号分隔。 如果环境不属于默认文件夹，请在环境名称中添加文件夹名称作为前缀。例如: AccountingTeam\TestEnvironment 。
-h, or --entryPointsPath	定义用于创建或更新流程的特定入口点。这是始于项目根目录的入口点文件路径。 对于传统文件夹，每个环境只能指定一个入口点。
-u、或--username （基本身份验证为必要）	用于对 Orchestrator 进行身份验证的用户名。必须与相应的密码配对。
-p、或--password （基本身份验证为必要）	用于对 Orchestrator 进行身份验证的密码。必须与相应的用户名配对。
-t或--token （对于 基于令牌的身份验证 为 必要项 ）	用于对 Orchestrator 进行身份验证的OAuth2 刷新令牌。必须与帐户名称和客户端 ID配对。
-a或--accountName （对于 基于令牌的身份验证 为 必要项 ）	Orchestrator CloudRPA 帐户名称。必须与OAuth2 刷新令牌和客户端 ID配对。
-A, or --accountForApp	Orchestrator CloudRPA 帐户名称（组织名称）。必须与“应用程序 ID” 、 “应用程序密码”和“应用程序作用域”配对，以进行外部应用程序身份验证。
-I或--applicationId （ 外部应用程序身份验证 为 必要 ）	外部应用程序 ID。必须与“应用程序帐户” 、 “应用程序密码”和“应用程序作用域”配对。
-S或--applicationSecret （ 外部应用程序身份验证 为 必要 ）	外部应用程序密码。必须与“应用程序帐户” 、 “应用程序 ID”和“应用程序作用域”配对。
--applicationScope （对于 外部应用程序身份验证 为必要项 ）	应用程序作用域列表，以单个空格分隔。必须与应用程序帐户、应用程序 ID和应用程序密码配对。
-o、或 --organizationUnit（必要项）	Orchestrator 文件夹（组织单元）的名称。 要输入子文件夹，请同时包括父文件夹和子文件夹的名称。例如： AccountingTeam/TeamJohn 。
-l, or --language	Orchestrator 用户界面中使用的语言。
-y, or --disableTelemetry	禁用遥测数据。
--traceLevel	显示事件的跟踪。
--identityUrl （对于 PaaS 或 MSI 部署为必需）	身份服务器的 URL。
Package(s) Path (pos. 0) （必填）	包文件的路径，或包含多个包的文件夹的路径。
Orchestrator URL (pos. 1) （必填）	Orchestrator 实例的 URL。
Orchestrator 租户 (pos.2) (Required) for SaaP deployments. (Optional) for PaaS deployments.	要删除计算机的 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 "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"