2025.10.1

2025.10.1 机器人发行说明。

发布日期：2025 年 10 月 30 日

支持启用多因素身份验证 (MFA) 的 EntraID 用户

新增：2025 年 11 月 3 日

您现在可以将已启用多因素身份验证的 Unattended Robot 用于 EntraID 用户。请参阅“将启用多因素身份验证 (MFA) 的 EntraID 用户用于 Unattended Robot”。

可配置的执行程序启动延迟

引入了新的环境变量 (UIPATH_EXECUTOR_STARTUP_DELAY)，以便在创建执行程序流程之前在无人值守 Windows 会话中添加短暂的延迟。如果执行程序在 Windows 会话中启动之前，基础架构需要其他流程才能启动，则可以使用此功能。

增强的机器人日志记录配置

机器人现在支持双日志记录，本地文件和 Orchestrator 有单独的记录级别。使用UIPATH_FILE_LOG_LEVEL环境变量为本地文件日志记录设置不同的最低日志级别，同时为发送到 Orchestrator 的日志保留单独的级别。

这样，您可以在计算机上本地存储详细日志（例如 INFO+ 级别），同时只将优先级较高的日志（例如 WARN+ 级别）发送到 Orchestrator。这样做可以减少数据库的增长，同时保留全面的本地诊断信息。有效值包括：Verbose、Trace、Information、Warning、Error、Critical 和 Off。

支持大型输入和输出参数。

从此版本开始，Robot 支持超过 10,000 个字符的输入和输出参数。

对作业的文件参数支持

从此版本开始，机器人支持“文件”类型的输入和输出参数。

支持 UPN 域名

以前，Unattended 会话的智能卡身份验证仅将 Orchestrator 用户名与主 UPN 进行匹配。 更改 UPN 域名需要重新创建智能卡。

The UPN can now be specified on the smart card in the Domain\Username field of your Robot account. Supported formats:

• Private domains: ADUPN\some.upn@domain
• Azure AD domains: AzureAd\some.Azure@domain

无论使用的是基于密码的身份验证还是智能卡身份验证，此更新还允许您直接指定 UPN 进行身份验证。

但是，当将智能卡身份验证与证书一起使用时，只有当证书颁发给该备用 UPN 时，才支持备用 UPN。

迁移代理设置

使用 UiPathStudio.msi 或 UiPathRobot.msi 更新 Robot 时，代理设置会自动从 uipath.config 文件迁移到 %ProgramData%\UiPath\Shared\proxy.json。

工作流日志的保留期

工作流日志文件的保留期默认限制为 30 天。

执行日志中的作业 ID

机器人执行日志现在显示作业 ID。

headless-with-user 模式下的智能卡支持

headless-with-user 模式下的后台任务现在不仅需要用户名和密码，还需要智能卡凭据。

改进了日志详情

错误日志现在提供与导致工作流失败的活动相关的详细信息，包括工作流文件名称、活动名称和容器层次结构。这些详细信息有助于您在项目中快速定位活动，并在 Studio、Orchestrator 和 Robot 日志中显示。

所有 NuGet 订阅源的 HTTPS

从 2025 年 2 月（最新）和 2025 年 10 月 (LTS) 的机器人版本开始，不再允许从 NuGet 支持的包调用 HTTP 不安全订阅源。 使用非 HTTPS 订阅源时，会引发错误，并且无法退出此行为。

用户会话的新选项

UIPATH_SESSION_BEHAVIOR系统环境变量的两个新选项——LeaveSessionActive和LeaveSessionDisconnected——可用于控制作业完成后对用户会话的操作。

• UIPATH_SESSION_BEHAVIOR=LeaveSessionActive — 防止恢复初始会话状态。
• UIPATH_SESSION_BEHAVIOR=LeaveSessionDisconnected — 还原时始终断开会话。

新的 UiPath 存储库证书 SHA-256 指纹

If you are using package signature verification, a new UiPath repository certificate SHA-256 fingerprint must be added to your NuGet configuration under both trusted authors and trusted repositories, as shown in our documentation.

<certificate fingerprint="A96ADDC7455443CF702A887BC153CF7844038E2E88081D676C57DDD90EC90245" hashAlgorithm="SHA256" allowUntrustedRoot="false" />

支持 Windows Server 2025

从新版本开始，UiPath 机器人还可以在 Windows Server 2025 操作系统上运行。

.NET Framework 要求更新

.NET Framework 最低要求已从 4.6.1 更新为 4.7.2。

错误修复

• 有时执行作业会失败，并显示“无法访问已关闭的管道”或“连接已关闭”异常。此问题不会再发生。
• 在极少数情况下，在旧版项目中使用“HTTP 请求”活动会导致执行程序意外崩溃，并出现错误：“System.Exception: 无法检索作业执行的结果。这可能是因为消息太大而无法处理。”如果作业失败，那么会在 Orchestrator 中显示错误。
• 在编码的工作流中，并行多次调用工作流时可能会出现异常。 这是使用RunWorkflowAsync方法导致的。
• 在字符串中使用特殊字符引号 " (0x201C) 会导致 Windows 项目 runtime 出现 JIT 编译错误。
• UiPath 机器人服务错误地检测到正在进行的交互式作业，从而阻止了新作业的启动。此时显示错误消息“正在为此用户运行另一个交互式作业。用户一次只能运行一个交互式作业。”，即使没有正在运行的作业，此错误消息仍会显示。发生这种情况的原因是服务级状态更新不当，导致作业陷入终止或停止状态。
• 在计算机待机或锁定后，UiPath 机器人服务无法重新连接到 Orchestrator。它一直使用断开的连接。Orchestrator 连接的生命周期有限，默认情况下为 30 分钟。您可以使用 UIPATH_HTTP_CONNECTION_LIFETIME 调整时长，这是一个环境变量，以秒为单位定义连接生命周期。
• 反复启动 Robot（画中画）会话导致记忆峰值。
• 有时，截取会话屏幕图像会导致 UiPath.Session.csharp.exe 应用程序错误，从而导致机器人会话无法正确关闭且新作业无法启动。
• 以前，当用户帐户存在于多个域名中时，有时会导致 Unattended 作业失败以及会话超时。发生这种情况的原因是域名在会话识别过程中被混淆。
• 修复了 FreeRDP 错误，该错误会导致 UiPath 机器人服务的 CPU 使用率很高。
• 有时，即使机器人执行程序已退出，机器人也会报告作业正在运行。
• 现在，在 Windows 上运行时，可设置正确的分辨率。
• 如果调用的工作流位于子文件夹中，使用“调用工作流”活动生成的包会崩溃。
• This version also includes performance fixes.