配置文件

UiPath.Settings 文件说明

UiPath.Settings 文件包含有关机器人如何执行流程的所有必要详细信息。您可通过直接编辑该文件和相应字段来修改这些设置。另一方面，您也可通过 Orchestrator 来修改这些设置。这是通过“设置”选项卡完成的。

备注：

请注意，修改这些设置需要本地系统和管理员权限。如要使更改生效，请务必重启 UiPath 机器人服务（此操作需要管理员权限），并关闭机器人托盘。

在用户模式下部署机器人时，UiPath.Settings 文件存储在 %localappdata%\UiPath\ 文件夹中，在服务模式下部署机器人时，该文件存储在 %programdata%\UiPath\ 文件夹中。当 UiPath 机器人服务首次启动时，系统便会创建此文件。该文件包含以下参数：

参数	描述
NuGet API 密钥	NuGet 订阅源的 API 密钥。 当未连接到 Orchestrator 时，如果您使用的是本地订阅源，则无需 API 密钥。请注意，如果您使用私有的 MyGet 订阅源，则需要此参数。 当连接到 Orchestrator 时，不考虑此值。
NuGet 服务器 URL	推送项目和检索项目的位置。这可以是本地订阅源（如文件系统路径），也可以是使用 NuGet 协议的网页订阅源（NuGet、MyGet 等）。 未连接到 Orchestrator 时，默认值为 %ProgramData%\UiPath\packages（用户模式）或 `%。如果您使用私有 MyGet 订阅源，请使用预验证的 V2 URL（无基本身份验证）下提供的 URL。请注意，这不是 MyGet 的免费服务。 当连接到 Orchestrator 时，不考虑此值。
活动订阅源	The address where the activities are stored. This field is only populated if you are not connected to Orchestrator. By default, the value is ~/NuGetPackages/Activities. If you connect to Orchestrator, this field is not taken into account. Find out more about the activities feeds on this page, as well as where packages are installed based on the Robot deployment type.
UiPath 服务器 URL	Orchestrator 实例的地址。 当未连接到 Orchestrator 时，此参数为空。 When connected to Orchestrator, it is automatically filled in with the URL you provided in the Orchestrator Settings window.
追踪级别	The level at which the Robot should log information. The following options are available: Verbose,Trace,Information,Warning,Error,Critical and Off. 这也可从“级别”下拉列表的“Orchestrator 设置”窗口中进行更改。
低级别追踪	Indicates whether or not to log information at a trace level, to help you with troubleshooting crashes and errors. By default, this parameter is set to false. To start low level tracing, set the value of this parameter to true. You can also change this value from the command line.
安全许可证密钥	用于连接到 Orchestrator 的计算机密钥。UiPath.settings 文件中的密钥均经过 DPAPI 加密处理。您也可通过“Orchestrator 设置”窗口填写和修改此值。如果未连接到 Orchestrator，则此参数应为空。
登录到控制台	Enables the Robot to connect to the console session of the machine where it is installed. Additionally, it indicates if you can connect multiple Robots to Orchestrator using multiple users (High-Density Robots) or not. By default, the value is true. To enable High-Density Robots, set the value to false.
分辨率宽度	计算机的显示分辨率宽度。此选项默认设置为 0，这意味着系统会自动检索并使用检测到的分辨率宽度。您可以使用自定义值，前提是工作站支持该值。
分辨率高度	机器的显示分辨率高度。此选项默认设置为 0，这意味着系统会自动检索并使用检测到的分辨率宽度。您可以使用自定义值，前提是工作站支持该值。
分辨率深度	机器的显示分辨率深度。此选项默认设置为 0，这意味着系统会自动检索并使用检测到的分辨率深度。您可以使用自定义值，前提是工作站支持该值。
字体平滑	提高文本识别能力。如果设为“True”，则启用 RDP 连接上的“字体平滑”选项。这意味着目标计算机将启用“ClearType”。
ConnectionString	Orchestrator 中生成的字符串，可用于在不提供“计算机名称”和“计算机密钥”的情况下将机器人注册到该平台。
禁用工作流执行	启用此参数后，您将无法通过命令行执行流程。系统默认会隐藏并禁用此功能。
webProxySettings	Parameter used to configure Proxy Settings for the Robot. Find out more in the Redirecting Robots Through a Proxy document.

UiPath Robot 系统变量

可以通过系统环境变量配置进一步的自定义行为。

重要提示：

修改任意系统变量后，请重新启动机器人服务。

以下列表总结了最常见的用例：

系统变量	用法	示例
UIPATH_SESSION_TIMEOUT	更改创建交互式会话时默认的 60 秒超时。 调整此值，以根据与之交互的系统的性能和加载时间调整机器人的行为。	UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT	更改在机器人会话中启动流程时默认的 180 秒超时。	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_LANGUAGE	设置机器人的操作语言。 确定语言的顺序是： UIPATH_LANGUAGE 值 计算机环境变量 当前线程用户界面文化 默认 UiPath 语言（英语）	UIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER	使用先前在 Orchestrator 中配置的特定用户的凭据。	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	默认情况下，会在机器人启动时启动预加载的执行程序。 要更改此行为并仅在第一个流程运行时启动预加载的执行程序，请将此变量设置为 None。	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	禁用预加载的执行程序功能。	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	在机器人 JS SDK 和机器人执行程序之间建立连接时，自动接受机器人同意对话框。 该变量接受用分号分隔的自定义应用程序 URL。如果端口号与标准端口（80 或 443）不同，请在 URL 中包含该端口号。	UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME	允许在创建 RDP 会话时使用本地主机的 DNS 主机名。要在对 RDP 使用 Kerberos 身份验证的环境中执行 Unattended 作业，请将此值设置为 True。	UIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS	使机器人能够处理使用 Windows 凭据进行身份验证的代理配置。	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	配置回退包文件夹的路径。使用分号分隔多个路径。 如果没有此变量，机器人会在 Nuget.config 文件中搜索回退包文件夹。
NUGET_SCRATCH	允许同一台计算机上的多个用户模式机器人共享用于存储包的本地路径。 该值必须是不同于 Nuget 安装文件夹的路径，并且充当 NuGet 的临时文件夹。 应只有 NUGET_SCRATCH 变量使用已配置的临时文件夹。	NUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE	保留日志记录凭据（域\用户名）的原始大小写。	UIPATH_PRESERVE_CREDENTIALS_CASE = True

重新启动机器人组件

请记得在重新启动之前保存任何正在进行的工作，避免丢失任何未保存的进度。

• 机器人服务
  • 服务模式安装
    1. 打开“任务管理器”>“服务”。
    2. 查找 UiPathRobotSvc 服务。
    3. 右键单击该服务，然后选择“重新启动”。
  • 用户模式安装 - 退出，然后重新启动 Assistant，或：
    1. 打开“任务管理器”>“详细信息”。
    2. 选择 UiPath.Service.UserHost.exe 流程。
    3. 选择结束任务。
• 更新服务
  1. 打开“任务管理器”>“服务”。
  2. 查找 UiPath.UpdateService.Agent 服务。
  3. 右键单击该服务，然后选择“重新启动”。
• UiPath RobotJS 服务主机
  1. 打开“任务管理器”>“服务”。
  2. 查找 UiPath.RobotJS.ServiceHost 服务。
  3. 右键单击该服务，然后选择“重新启动”。
• UiPath Assistant
  1. 在 Assistant 中，选择“首选项”，然后选择“退出”。
  2. 重新启动 Assistant。
• 小组件 - 重新启动 Assistant，或：
  1. 右键单击任务栏中的 Assistant 图标。
  2. 选择“重新加载小组件”