将机器人连接到 Orchestrator

使用管理员配置的身份验证方法将机器人连接到 Orchestrator。

您可以根据 Orchestrator 中配置的机器人身份验证设置（通常由管理员设置）以不同方式将机器人连接到 Orchestrator。如果您不知道任何机器人身份验证设置，请让 Orchestrator 管理员提供详细信息，以便能够使用正确的方法连接您的机器人。

我的身份验证设置是什么

The robot authentication settings can be seen and configured on Tenant > Settings, on the Robot security tab, usually by an administrator. Your Orchestrator administrator should provide you with details so as to be able to use the right method to connect your robot.

有关机器人身份验证的更多信息。

有关如何更改机器人身份验证设置的说明。

将有人值守的机器人连接到 Orchestrator

使用服务 URL（交互式登录）

使用您的凭据登录，以将机器人连接到 Orchestrator。这使机器人可以访问 Orchestrator 资源，并为用户提供 Studio 或 Assistant 等产品的操作权限。

1. 打开 Assistant。
2. 在“首选项”菜单上，选择“Orchestrator 设置” 。系统将显示“Orchestrator 配置”窗口。
3. 在“连接类型”字段上，选择“服务 URL” 。
4. 在“服务 URL”字段中，输入要连接的 Orchestrator 实例的 URL。
5. 选择“登录” 。系统会将您定向至 Orchestrator 实例的登录页面。
6. 使用您的凭据登录。

Assistant 会使用您可以访问的文件夹中的自动化填充。

图 1. 使用服务 URL 连接

备注：

• 使用交互式登录时，无需在 Orchestrator 中创建计算机对象。
• 您需要在租户级别具有包的查看权限才能下载包和库。

在 Assistant 中使用客户端凭据

使用客户端凭据将 Attended Robot 连接到 Orchestrator。客户端 ID - 客户端密码对是通过 Orchestrator 中的计算机模板对象生成的。

有两种方法可以将机器人与客户端凭据连接：使用 Assistant 或命令行。

1. 打开 Assistant。
2. 在“首选项”菜单上，选择“Orchestrator 设置” 。系统将显示“Orchestrator 配置”窗口。
3. 在“连接类型”字段上，选择“客户端 ID” 。
4. 在“Orchestrator URL”字段中，请输入完整的 URL，包括AccountLogicalName和ServiceName （例如： https://cloud.uipath.com/uipathtokyo/uipathkyoto/ ）。
5. 在“客户端 ID”字段中，输入由 Orchestrator 中的计算机对象生成的客户端 ID。
6. 在“客户端密码”字段中，输入由 Orchestrator 中的计算机对象生成的客户端密码。
7. Select Connect.

图 2. 使用客户端 ID 连接

在命令行中使用客户端凭据

1. 打开命令提示符。
2. 转到安装机器人的目录。例如：

   cd C:\Program Files\UiPath\Studio
   

3. 使用 --connect、--url、--clientID 和 --clientSecret 命令行参数连接机器人并传递 Orchestrator URL、客户端 ID 和客户端密码。例如：

   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   

   <OrchestratorURL> 必须同时包含组织名称和租户名称，例如 https://cloud.uipath.com/<organization>/<tenant>/orchestrator_/ 或 https://cloud.uipath.com/MyOrganization/MyTenant/。
   备注：

   使用 PowerShell 时，您需要使用“”对客户端密码中的 $ 字符进行转义。例如，您应该将客户端密码（例如 Bepx8O3XqSHrt$ZU）传递为 "Bepx8O3XqSHrt""$""ZU"。

将无人值守机器人连接到 Orchestrator

在无人值守的自动化中，主机已在无人值守模式下连接并获得许可，因此 Orchestrator 是执行流程的指定方式。如果要在强制执行交互式登录时以有人值守模式（打开 Assistant）使用计算机，则需要登录，否则您将无法在 Assistant 中看到流程，并且机器人将显示为“已连接，未获得许可”。

在 Assistant 中使用客户端凭据

使用客户端凭据将无人值守机器人连接到 Orchestrator。客户端 ID - 客户端密码对是通过 Orchestrator 中的计算机模板对象生成的。

有两种方法可以将机器人与客户端凭据连接：使用 Assistant 或命令行。

1. 打开 Assistant。
2. 在“首选项”菜单上，选择“Orchestrator 设置” 。系统将显示“Orchestrator 配置”窗口。
3. 在“连接类型”字段上，选择“客户端 ID” 。
4. 在“Orchestrator URL”字段中，请输入完整的 URL，包括AccountLogicalName和ServiceName （例如： https://cloud.uipath.com/uipathtokyo/uipathkyoto/ ）。
5. 在“客户端 ID”字段中，输入由 Orchestrator 中的计算机对象生成的客户端 ID。
6. 在“客户端密码”字段中，输入由 Orchestrator 中的计算机对象生成的客户端密码。
7. Select Connect.

图 3. 使用客户端 ID 连接

连接成功后，Assistant 会显示一个警告点，后跟 Connected as Unattended 消息。

当连接到活动 Windows 会话且缺少有人值守功能时，会显示这条警告。要启用有人值守模式，请使用您的 RPA Developer 帐户登录。

备注：

以无人值守模式连接时，将在 Windows 事件查看器 > 应用程序事件中记录以下错误：

UiPath.Service.Host 25.10.7.0

[Http Status 401][Orchestrator Error Code

InvalidLoginMethod]UiPath.Robot.Core.Orchestrator.OrchestratorHttpException

无法获取用户令牌。 您将以 Unattended 身份连接、登录或从 Orchestrator 启用故障排除会话。

在命令行中使用客户端凭据

1. 打开命令提示符。
2. 转到安装机器人的目录。例如：

   cd C:\Program Files\UiPath\Studio
   

3. 使用 --connect、--url、--clientID 和 --clientSecret 命令行参数连接机器人并传递 Orchestrator URL、客户端 ID 和客户端密码。例如：

   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   

   <OrchestratorURL> 必须同时包含组织名称和租户名称，例如 https://cloud.uipath.com/<organization>/<tenant>/orchestrator_/ 或 https://cloud.uipath.com/MyOrganization/MyTenant/。
   备注：

   使用 PowerShell 时，您需要使用“”对客户端密码中的 $ 字符进行转义。例如，您应该将客户端密码（例如 Bepx8O3XqSHrt$ZU）传递为 "Bepx8O3XqSHrt""$""ZU"。

更新 Mac 的默认 Orchestrator URL

要在 Mac 上使用 Assistant 时更新默认的 Orchestrator URL 服务，请将其从 store.json (/Applications/UiPath Assistant.app/Contents/Robot/uipath.config~/Library/Application Support/UiPath/store.json):

"MAIN_WINDOW_SERVICE_LOGIN_DETAILS": {
        "nextServiceUrl": "https://cloud.uipath.com",
        "defaultServiceUrl": "https://cloud.uipath.com"
    }