- 入门指南
- 了解 UiPath Robot
- 安装要求
- 为 Unattended 自动化任务安装机器人
- 为 Unattended 自动化配置机器人
- 为 Attended 自动化安装机器人
- 为 Attended 自动化配置机器人
- 集成
- 监管
- 故障排除

机器人管理员指南
在 Windows 操作系统上安装
UiPath 提供 Windows 的两套安装程序。您可以从 UiPath Automation Cloud 中的资源中心或客户门户中的“产品下载”版块下载这些程序。
关于 32 位和 64 位版本
- 在 2021.4 版发布之前,Studio 和机器人是 32 位应用程序。但是,从 2021.4 版开始,默认为 64 位安装程序。
- 从 2023.4 版开始, 不再提供 32 位安装程序,从 2021.4 版开始停止
UiPathPlatformInstaller.exe。 - 如要在 64 位操作系统上更新现有的 32 位或 64 位
UiPathStudio.msi和UiPathPlatformInstaller.exe安装的程序,请使用UiPathStudio.msi。 - 2021.4 之前的默认安装路径, 在 64 位系统上安装 32 位
C:\Program Files (x86)\UiPath\Studio。 升级到 64 位安装程序会将安装的程序迁移到C:\Program Files\UiPath\Studio文件夹中。 使用自定义路径安装的程序在更新后不会更改其目录。
关于快速和自定义安装
您可以通过在安装向导中选择“快速”选项(不需要管理员权限),以默认配置为当前用户执行安装,也可以通过选择“自定义”选项来配置安装(每台计算机安装需要管理员权限)。
如果您使用的是 Microsoft Windows Server,则每用户安装可能无法成功完成。如果发生错误,提示已设置策略来阻止安装,若您是计算机的管理员,则可以执行以下任一操作:
- 打开注册表编辑器,然后在注册表键
HKLM\Software\Policies\Microsoft\Windows\Installer中配置策略DisableMSI = 0,为所有应用程序启用 Windows 安装程序。 - 通过使用“自定义”选项进行安装,以按照计算机执行安装。
下表总结快速安装和自定义安装之间的差异和相似之处。
| 快速入门 | 自定义 | |
|---|---|---|
| 安装上下文 | 按用户 | 按用户或计算机 |
| 支持的机器人安装类型 | 用户模式 | Attended 安装的用户模式(按用户和按计算机)。Unattended 安装的服务模式(按计算机)。 |
| 安装所需的管理员权限 | 否 | 仅对于每台计算机安装是必需的。 |
| 安装目录 | %LocalAppData%\Programs | 可以选择自定义位置。 默认位置为:%LocalAppData%\Programs适用于按用户安装。 对于按计算机安装模式,文件夹为 %ProgramFiles%。 |
| 使用社区版许可激活 | 支持 | 支持 |
| 使用企业版许可激活 | 支持 | 支持 |
| 连接到 Orchestrator 所需的管理员权限 | 否 | 仅服务模式机器人需要 |
| 使用交互式登录连接到 Orchestrator。 | 支持 | 支持 1 |
| 使用计算机密钥连接到 Orchestrator | 支持 | 支持 |
| 无人值守执行,无需用户登录 | 不支持 | 仅支持服务模式机器人 |
1 - 对于服务模式机器人,您必须首先使用客户端凭据连接到 Orchestrator,然后可以使用交互式登录来更改连接到 Orchestrator 的用户。
使用 UiPathStudio.msi
UiPathStudio.msi 是主要针对开发者的 Windows 安装程序。 安装后,软件包包括开发环境 (UiPath Studio)、UiPath Robot 和 UiPath Assistant,以执行已开发的工作流。
如果您希望在同一台计算机上构建、调试和测试自动化任务,那么请使用此安装程序。
- 要使用
UiPathStudio.msi安装无人值守的自动化机器人,请参阅“安装无人值守的自动化机器人”。 - 要使用
UiPathStudio.msi安装有人值守的自动化机器人,请参阅“安装有人值守的自动化机器人”。
可用的安装选项
-
快速安装 - 在
%localappdata%\Programs\UiPath目录中安装默认配置。默认配置包括:- Studio、StudioX 和 Assistant
- 用户模式机器人
- StudioX Excel 加载项(如果您的计算机上已经安装了 Microsoft Excel)
- Chrome 扩展程序(如果您的计算机上安装了 Google Chrome)
- Edge Chromium 扩展程序(如果您的计算机上已经安装了 Microsoft Edge Chromium)
- JavaScript Robot 附加项
- Microsoft 远程桌面扩展程序
-
自定义安装 - 允许您选择要安装的组件,并配置高级设置。安装路径
%LocalAppData%\Programs适用于当前用户安装,%ProgramFiles%适用于设备上所有用户的安装。
自定义安装 - 可用选项
- 仅为我安装 - 在用户配置文件夹中安装自定义配置。无需管理员权限。
- 为此计算机上的所有用户安装 - 为计算机上的所有用户安装自定义配置。需要管理员权限。
仅为我安装 - 可用的安装包
自动化开发者 - 安装以下配置,用于运行 Attended 自动化:
- Studio、StudioX 和 Assistant
- 用户模式机器人
Attended 机器人 - 安装以下配置,用于运行 Attended 自动化任务,并随 Windows 自动启动 Assistant。
- Assistant
- 用户模式机器人
当您选择某选项时,高级设置配置将变为可用,其中包含以下选项:
- 安装包
- Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在
uipath.config文件中。 - 自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为帐户启用自动身份验证。
- Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在
- 扩展程序 > 工具
- StudioX Excel 加载项
- UiPath JavaScript 机器人插件
- UiPath Chrome 扩展程序
- Edge Chromium 的 UiPath 扩展程序
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
- 扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
- 安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
为此计算机上的所有用户安装 - 可用的安装包
自动化开发者 - 安装以下配置,用于运行 Attended 自动化:
- Studio、StudioX 和 Assistant
- 用户模式机器人
自动化开发者 - 安装以下配置,用于运行 Attended 自动化:
- Studio、StudioX 和 Assistant
- 用户模式机器人
Attended 机器人 - 安装以下配置,用于运行 Attended 自动化任务,并随 Windows 自动启动 Assistant。
当您选择某选项时,高级设置配置可用。
- 安装包
- 安装路径 - 所安装程序的目标文件夹。默认路径为
%ProgramFiles%。 - 许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。
- Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在
uipath.config文件中。 - 自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为帐户启用自动身份验证。
- 随 Windows 自动启动 Assistant - 在 Windows 启动时启动 Assistant。
- 安装路径 - 所安装程序的目标文件夹。默认路径为
- 扩展程序 > 工具
- StudioX Excel 加载项
- UiPath Java 扩展程序
- UiPath JavaScript 机器人插件
- UiPath Citrix 扩展程序
- UiPath Chrome 扩展程序
- Edge Chromium 的 UiPath 扩展程序
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
- 适用于 VMware 的 UiPath 扩展程序
- SAP 解决方案管理器 - 如果您的计算机上已经安装了适用于 Microsoft 的 SAP 连接器,则可使用此功能。如果选中,那么您需要在“主机”框中提供 SAP 解决方案管理器实例的主机名或 IP 地址。
- 扩展程序 > 默认下载位置
- 活动包的下载位置。 默认位置为
%userprofile%.nuget\packages。
- 活动包的下载位置。 默认位置为
- 扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
- 安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
Unattended 机器人 - 安装以下配置,以运行 Unattended 自动化
- Assistant
- 服务模式下的机器人
当您选择某选项时,高级设置配置可用。
-
安装包
- 许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。
- Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在
uipath.config文件中。 - 客户端 ID 和客户端密码 - 来自计算机模型对象的客户端凭据。这一对生成令牌,允许 Unattended 机器人访问 Orchestrator 资源。
- 安装 UiPath Studio - 如选中,安装用于设计的 Studio。
-
扩展程序 > 工具
- StudioX Excel 加载项
- UiPath Java 扩展程序
- UiPath JavaScript 机器人插件
- UiPath Citrix 扩展程序
- 适用于 Chrome 的 UiPath 扩展程序 (*)
- 适用于 Edge Chromium 的 UiPath 扩展程序 (*)
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
- 适用于 VMware 的 UiPath 扩展程序
- SAP 解决方案管理器 - 如果您的计算机上已经安装了适用于 Microsoft 的 SAP 连接器,则可使用此功能。如果选中,那么您需要在“主机”框中提供 SAP 解决方案管理器实例的主机名或 IP 地址。
(*) 这些选项默认处于选中状态。
-
扩展程序 > 默认下载位置
- 活动包的下载位置。 默认位置为
%userprofile%.nuget\packages。
- 活动包的下载位置。 默认位置为
-
扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
-
安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
使用 UiPathRobot.msi
UiPathRobot.msi 通常安装在主要执行自动化任务的 Windows 计算机上。 此安装不附加任何开发环境,因此资源分配主要用于运行机器人。 它包括 UiPath 机器人和 UiPath Assistant。
- 要使用
UiPathRobot.msi安装无人值守的自动化机器人,请参阅“安装无人值守的自动化机器人”。 - 要使用
UiPathRobot.msi安装有人值守的自动化机器人,请参阅“安装有人值守的自动化机器人”。
可用的安装选项
-
快速安装 - 在
%localappdata%\Programs\UiPath目录中安装默认配置。默认配置包括:- Studio、StudioX 和 Assistant
- 用户模式机器人
- StudioX Excel 加载项(如果您的计算机上已经安装了 Microsoft Excel)
- Chrome 扩展程序(如果您的计算机上安装了 Google Chrome)
- Edge Chromium 扩展程序(如果您的计算机上已经安装了 Microsoft Edge Chromium)
- JavaScript Robot 附加项
- Microsoft 远程桌面扩展程序
-
自定义安装 - 允许您选择要安装的组件,并配置高级设置。安装路径
%LocalAppData%\Programs适用于当前用户安装,%ProgramFiles%适用于设备上所有用户的安装。
自定义 - 可用的安装包
仅为我安装:Attended - 安装 Robot 和 Assistant 以运行 Attended 自动化。
- 您的自定义配置将应用于当前的用户配置文件。
- 机器人安装在用户模式下。
- 无需管理员权限。
选择此选项时,高级设置配置变为可用。
-
安装包
- Orchestrator URL — 使用交互式登录连接上的 Orchestrator 实例的 URL。 此值保存在
uipath.config文件中。 - 自动登录 — 当您的环境配置为通过 Azure Active Directory 实现单点登录 (SSO) 时,您可以为您的帐户启用自动身份验证。
- Orchestrator URL — 使用交互式登录连接上的 Orchestrator 实例的 URL。 此值保存在
-
扩展程序 > 工具
- UiPath JavaScript 机器人插件 (*)
- 适用于 Chrome 的 UiPath 扩展程序 (*)
- 适用于 Edge Chromium 的 UiPath 扩展程序 (*)
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
(*) 这些选项默认处于选中状态。
-
扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
-
安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
为所有用户安装:Attended - 安装 Robot 和 Assistant 以运行 Attended 自动化。
- 您的自定义配置将应用于计算机上的所有用户。
- 机器人安装在用户模式下。
- 需要管理员权限。
- 随 Windows 自动启动 Assistant。
选择此选项时,高级设置配置变为可用。
-
安装包
- 安装路径 - 所安装程序的目标文件夹。默认路径为
%ProgramFiles%。 - 许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。
- Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在
uipath.config文件中。 - 自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为帐户启用自动身份验证。
- 随 Windows 自动启动 Assistant - 在 Windows 启动时启动 Assistant。
- 安装路径 - 所安装程序的目标文件夹。默认路径为
-
扩展程序 > 工具
- UiPath Java 扩展程序
- UiPath JavaScript 机器人插件 (*)
- UiPath Citrix 扩展程序
- 适用于 Chrome 的 UiPath 扩展程序 (*)
- 适用于 Edge Chromium 的 UiPath 扩展程序 (*)
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
- 适用于 VMware 的 UiPath 扩展程序
(*) 这些选项默认处于选中状态。
-
扩展程序 > 默认下载位置
- 活动包的下载位置。 默认位置为
%userprofile%.nuget\packages。
- 活动包的下载位置。 默认位置为
-
扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
-
安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
为所有用户安装: Unattended - 安装机器人以通过 Orchestrator 运行 Unattended 自动化任务,并安装 Assistant 以解决问题。
- 您的自定义配置将应用于计算机上的所有用户。
- 机器人安装在服务模式下。
- 需要管理员权限。
选择此选项时,高级设置配置变为可用。
-
安装包
- 安装路径 - 所安装程序的目标文件夹。默认路径为
%ProgramFiles%。 - 许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。
- Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在
uipath.config文件中。 - 客户端 ID 和客户端密码 - 来自计算机模型对象的客户端凭据。这一对生成令牌,允许 Unattended 机器人访问 Orchestrator 资源。
- 安装路径 - 所安装程序的目标文件夹。默认路径为
-
扩展程序 > 工具
- UiPath Java 扩展程序
- UiPath JavaScript 机器人插件
- UiPath Citrix 扩展程序
- 适用于 Chrome 的 UiPath 扩展程序 (*)
- 适用于 Edge Chromium 的 UiPath 扩展程序 (*)
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
- 适用于 VMware 的 UiPath 扩展程序
(*) 这些选项默认处于选中状态。
-
扩展程序 > 默认下载位置
- 活动包的下载位置。 默认位置为
%userprofile%.nuget\packages。
- 活动包的下载位置。 默认位置为
-
扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
-
安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
使用命令行接口
使用命令行参数安装机器人或 Studio 对于多台计算机上的安装、静默安装以及节省图形向导可能消耗的系统资源非常有用。它还允许自定义安装设置并与脚本集成。
如要使用命令提示符安装机器人,您需要管理员权限。
- 要使用命令行接口安装无人值守的自动化机器人,请参阅“安装无人值守的自动化机器人”。
- 要使用命令行接口安装有人值守的自动化机器人,请参阅“安装有人值守的自动化机器人”。
最佳实践
-
如要转义系统变量名称中的 "%" 字符,如 %username%,请使用以下命令:
^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%备注:在 PowerShell 中,不需要转义。
-
使用 Active Directory 域账户时,请在文件夹结构中指定域名:
C:\packages\^%UserDomain^%.^%Username^%C:\packages\^%UserDomain^%.^%Username^% -
如要使用包含空格的路径,请使用引号:
- 在命令提示符中,使用双引号:
UiPathRobot.msi APPLICATIONFOLDER="C:\folder name"UiPathRobot.msi APPLICATIONFOLDER="C:\folder name" - 在 PowerShell 中,使用单引号和双引号:
./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'
- 在命令提示符中,使用双引号:
干净安装 - 命令行参数
从命令行运行UiPathStudio.msi或UiPathRobot.msi时,可使用这些参数。
-
/q- 在不显示用户界面的情况下,静默安装指定的 UiPath 功能。 -
/l*vx <LogFile>- 在指定路径中生成安装程序日志文件。 如果在安装过程中由于任何原因而遇到困难,您可以将文件进一步发送给我们的支持团队。 -
ADDLOCAL- 允许选择要安装的功能。 如不设置此参数,系统将默认安装以下功能:服务模式机器人、默认活动包和 JavaScript 插件。 它支持以下选项:Studio(exclusively for UiPathStudio.msi) — Installs Studio.ExcelAddin(仅适用于 UiPathStudio.msi)— 安装 StudioX Excel 加载项。 必须与Studio参数一起使用。Robot— Installs the Robot in User Mode or Service Mode, as well as the Assistant.RegisterService— 对服务模式安装而言是必需的。 不要在用户模式安装中添加它。StartupLauncher— Runs the Robot at Windows startup.JavaBridge— 安装 UiPath Java Bridge,以便更好地与 Java 应用程序集成和自动化。 添加此项可能会增加安装时间。 必须与Robot参数一起使用。ChromeExtension— 安装 Google Chrome 扩展程序。 必须与Robot参数一起使用。FirefoxExtension— 安装 Firefox 扩展程序。 必须与Robot参数一起使用。EdgeExtension— 安装基于 Chromium 的 Microsoft Edge 扩展程序。 必须与Robot参数一起使用。CitrixClient— 安装 UiPath Citrix 客户端扩展程序。 必须与Robot参数一起使用。不适用于按用户安装。JavaScriptAddOn— 安装浏览器嵌入插件。 必须与Robot参数一起使用。不能在提权情况下使用。SapPlugin(仅适用于 UiPathStudio.msi)— 安装 SAP 解决方案管理器插件。 需要在您的计算机上安装 SAP Connector for Microsoft。在全新安装上,您还必须使用SAP_SOL_MAN_HOST参数提供实例的地址。必须与Studio参数一起使用。不适用于按用户安装。VMwareExtension— 安装 UiPath VMware Horizon 扩展程序。 必须与Robot参数一起使用。不适用于按用户安装。WindowsRdpExtension— 安装 UiPath Windows 远程桌面扩展程序。 必须与Robot参数一起使用。
-
MSIINSTALLPERUSER- 使您能够仅为当前用户安装。- 要按用户安装,请添加
MSIINSTALLPERUSER=1。以下选项在按用户安装中不可用:RegisterService、CitrixExtension、VMwareExtension、PACKAGES_FOLDER、CODE。 - 如要按计算机安装,请勿包含此参数。
- 要按用户安装,请添加
-
SAP_SOL_MAN_HOST(仅适用于UiPathStudio.msi) - SAP Solution Manager 实例的主机名或 IP 地址。 对于在ADDLOCAL选项中添加了SapPlugin参数的清洁安装,这是必需的。 -
APPLICATIONFOLDER- 使您能够将机器人安装到自定义位置。 -
NUGET_OPTIONS- 适用于离线环境。 如果设置为DisableOnlineFeeds,则此参数将禁用机器人的在线 UiPath 官方和社区订阅源,并仅使用 Orchestrator 和本地订阅源。备注:URL 订阅源仍保留在配置文件中,但会被忽略。
-
PACKAGES_FOLDER- 可使您更改工作流及其依赖项的下载位置。 选定的文件夹可以是用户专属的文件夹,也可以由计算机上的所有用户访问。
- 如不设置此参数,默认下载位置为
%userProfile%\.nuget\packages。 - 不适用于按用户安装。
备注:
确保需要执行流程的所有用户均具有新文件夹的读取权限。
- 了解如何设置自定义包文件夹和网络路径。
- 对于启用并发执行的 Windows Server 计算机上的安装,您必须提供每个用户的专属路径。 详细了解如何为多台机器人使用同一路径。
- 了解如何在安装后更改包的下载文件夹。
-
CUSTOM_NUGET_FEEDS- 使您能够为 Studio 和/或机器人添加自定义 NuGet 活动订阅源。 此命令只会添加或更新现有订阅源列表。 必须填充类型为字符串的键值对:- 有效的位置包括在线订阅源、文件夹路径和共享网络驱动器。
- 确保提供的订阅源可供给定计算机上的所有用户访问。
- 用分号 (;) 分隔订阅源。 例如:
CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"
-
ENFORCE_SIGNED_EXECUTION- 可选。 使您能够强制机器人仅执行已签名的包。如不设置此参数,则不会启用包签名。 它具有以下选项:1- 机器人仅处理由 UiPath 验证的作者或存储库签署的包。 如要将您自己的证书添加为已信任来源,请修改nuget.config文件。0- 不在您的机器人部署中实施任何包签名规则。如需更多详细信息,请参阅在包上签名。
-
CODE- 为您的机器人实例授予许可证。 不适用于按用户安装。 -
CLIENT_ID和CLIENT_SECRET- 在安装机器人的同时,使用客户端凭据自动将机器人连接到 Orchestrator。例如:UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32kUiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k -
CHROME_INSTALL_TYPE- 可让您选择 Chrome 扩展程序的安装方法。 需要管理员权限。 如不设置此参数,系统将自动选择最合适的方法。 它具有以下选项:POLICYOFFLINE- Chrome 扩展程序是通过离线组策略方法自动安装到每个系统的,这相当于使用 SetupExtensions 工具调用/Chrome-Policy-Offline命令。POLICYONLINE- Edge 扩展程序是通过在线组策略方法自动安装到每个系统的,这相当于使用 SetupExtensions 工具调用/Edge-Chromium-PolicyGlobal命令。MANUALPERMACHINE- 为所有用户安装 Chrome 扩展程序,相当于使用 SetupExtensions 工具调用/ChromeGlobal命令。NATIVEHOSTONLY- 仅安装原生消息传递主机组件 (ChromeNativeMessaging.exe),相当于使用 SetupExtensions 工具调用/ChromeNativeHostGlobal命令。
备注:保留旧的安装方法名称 (
STORE、GLOBAL) 以实现向后兼容性。 -
EDGE_INSTALL_TYPE- 允许您选择 Edge 扩展程序的安装方法。 需要管理员权限。 如不设置此参数,系统将自动选择最合适的方法。 它具有以下选项:POLICYOFFLINE- Edge 扩展程序是通过离线组策略方法自动安装到每个系统的,这相当于使用 SetupExtensions 工具调用/Edge-Policy-Offline命令。POLICYONLINE- Edge 扩展程序是通过在线组策略方法自动安装到每个系统的,这相当于使用 SetupExtensions 工具调用/Edge-Chromium-PolicyGlobal命令。MANUALPERMACHINE- 为所有用户安装 Edge 扩展程序,相当于使用 SetupExtensions 工具调用/Edge-Chromium-Global命令。NATIVEHOSTONLY- 仅安装原生消息传递主机组件 (ChromeNativeMessaging.exe),相当于使用 SetupExtensions 工具调用/Edge-Chromium-NativeHostGlobal命令。
备注:保留旧的安装方法名称 (
STORE、GLOBAL) 以实现向后兼容性。 -
DISABLE_SECURE_XAML- 允许您为作为 Windows 服务安装的机器人禁用XAML文件的安全性。 未加密的XAML文件允许用户读取和修改流程文件和逻辑。 它具有以下选项:0- 默认选项。 启用 Windows 服务机器人XAML的文件保护功能。1- 为 Windows 服务机器人禁用XAML文件的安全性。
-
SERVICE_URL- 可让您确定使用交互式登录连接到的 Orchestrator 实例的 URL。此值保存在uipath.config文件中。 用户模式安装需要。服务模式安装时会忽略此参数。 -
ORCHESTRATOR_URL- 在清洁安装中,您可以指定用于检索自动更新信息的主要 Orchestrator URL。 例如:https://orchestrator.local/organizationName/tenantName -
TELEMETRY_ENABLED- 允许您禁用使用情况数据收集。 它具有以下选项:0- 禁用 Studio 和机器人的遥测功能。1- 默认选项。 启用 Studio 和 Robot 的遥测功能。了解如何选择退出遥测功能。
-
ENABLE_PIP- 可让您启用计算机的“机器人会话”(画中画)功能。 它具有以下选项:0- 默认选项。 机器人会话功能已禁用。1- 启用机器人会话功能。
-
INSTALLER_LANGUAGE- 使您能够选择安装程序的显示语言。 如不设置此参数,安装程序将使用 Windows 中的语言设置。 它具有以下选项:2052- 中文(简体)12- 法语7- 德语17- 日语1- 韩语22- 葡萄牙语(葡萄牙)1046- 葡萄牙语(巴西)25- 俄语10- 西班牙语(西班牙)2058- 西班牙语(墨西哥)31- 土耳其语
-
ASSISTANT_OPTIONS- 启用或禁用 Assistant 的 Marketplace 小组件。它具有以下选项:- 无或
EnableMarketplace- 默认选项。 启用微件。 DisableMarketplace- 禁用小组件。
- 无或
-
ORCHESTRATOR_AUTO_SIGNIN- 启用自动登录您的帐户。 适用于用户模式安装和已配置为通过 Azure Active Directory 实现单点登录 (SSO) 的环境一起使用。 必须与ORCHESTRATOR_URL参数一起使用。它具有以下选项:0- 禁用自动登录功能。1- 启用自动登录功能。
-
ENFORCE_DEFAULT_SERVICE_URL- 强制使用默认服务 URL。 适用于用户模式安装。 必须与ORCHESTRATOR_URL参数一起使用。它具有以下选项:0- 禁用对默认服务 URL 的强制使用。1- 启用对默认服务 URL 的强制使用。
-
PROXY_SCRIPT_ADDRESS- 决定如何以及何时使用代理的脚本的地址。 应包含脚本文件的 URI,例如http://localhost/proxy.pac。备注:- 如果使用此参数,请不要使用其他特定于各代理的参数。
- 当 UiPath.config 文件中存在所有参数时,仅使用
ScriptAddress键。
-
PROXY_ADDRESS- 代理服务器的地址,可以是 IP 或域名。 例如http://my.proxy.net:8008。备注:需与以下内容一起使用:
PROXY_BYPASS_LOCAL_ADDRESSPROXY_BYPASS_LIST
或使用以下内容:
PROXY_USER_NAMEPROXY_PASSWORDPROXY_DOMAIN
-
PROXY_BYPASS_LOCAL_ADDRESS- 允许绕过代理服务器,直接连接到本地地址。 将其设置为 1 以绕过本地地址,否则设置为 0。备注:需与以下内容一起使用:
PROXY_ADDRESSPROXY_BYPASS_LIST
-
PROXY_BYPASS_LIST- 绕过代理服务器、直接连接到互联网的地址的列表。 应包含正则表达式字符串,而这些字符串包含要绕过的服务器 URI。例如server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}。备注:需与以下内容一起使用:
PROXY_ADDRESSPROXY_BYPASS_LIST
-
PROXY_USER_NAME- 需要PROXY_PASSWORD。 用于代理服务器身份验证的用户名凭据。 -
PROXY_PASSWORD- 与用于代理服务器身份验证的用户名关联的密码。 -
PROXY_DOMAIN- 代理服务器所在的域,身份验证所需。
更新或修改现有安装 - 命令行参数
从命令行运行 UiPathStudio.msi时,可使用这些参数。
/q- 不支持更改现有安装。 在不显示用户界面的情况下,静默更新指定的 UiPath 功能。ADDLOCAL- 允许选择要更新的功能。 如不设置此参数,系统将默认更新以下功能:服务模式机器人、默认活动包和 JavaScript 插件。 它支持以下选项:Studio(exclusively for UiPathStudio.msi) — Installs Studio.ExcelAddin(仅适用于 UiPathStudio.msi)— 安装 StudioX Excel 加载项。 必须与Studio参数一起使用。Robot— Installs the Robot in User Mode or Service Mode, as well as the Assistant.RegisterService— 对服务模式安装而言是必需的。 不要在用户模式安装中添加它。LiveStreaming- 在计算机上安装实时流式传输软件 (RealVNC)。请参阅“实时流式传输”功能。StartupLauncher— Runs the Robot at Windows startup.JavaBridge— 安装 UiPath Java Bridge,以便更好地与 Java 应用程序集成和自动化。 添加此项可能会增加安装时间。 必须与Robot参数一起使用。ChromeExtension— 安装 Google Chrome 扩展程序。 必须与Robot参数一起使用。FirefoxExtension— 安装 Firefox 扩展程序。 必须与Robot参数一起使用。EdgeExtension— 安装基于 Chromium 的 Microsoft Edge 扩展程序。 必须与Robot参数一起使用。CitrixClient— 安装 UiPath Citrix 客户端扩展程序。 必须与Robot参数一起使用。不适用于按用户安装。JavaScriptAddOn— 安装浏览器嵌入插件。 必须与Robot参数一起使用。不能在提权情况下使用。SapPlugin(仅适用于 UiPathStudio.msi)— 安装 SAP 解决方案管理器插件。 需要在您的计算机上安装 SAP Connector for Microsoft。在全新安装上,您还必须使用SAP_SOL_MAN_HOST参数提供实例的地址。必须与Studio参数一起使用。不适用于按用户安装。VMwareExtension— 安装 UiPath VMware Horizon 扩展程序。 必须与Robot参数一起使用。不适用于按用户安装。WindowsRdpExtension— 安装 UiPath Windows 远程桌面扩展程序。 必须与Robot参数一起使用。
REMOVE- 禁用某功能。备注:无法移除机器人。
NUGET_OPTIONS- 不支持更改现有安装。 适用于离线环境。 如果设置为DisableOnlineFeeds,则此参数将禁用机器人的在线 UiPath 官方和社区订阅源,并仅使用 Orchestrator 和本地订阅源。备注:URL 订阅源仍保留在配置文件中,但会被忽略。
ENFORCE_SIGNED_EXECUTION- 可选。 使您能够强制机器人仅执行已签名的包。如不设置此参数,则不会启用包签名。 不支持更改现有安装。 它具有以下选项:1- 机器人仅处理由 UiPath 验证的作者或存储库签署的包。 如要将您自己的证书添加为已信任来源,请修改nuget.config文件。0- 不在您的机器人部署中实施任何包签名规则。如需更多详细信息,请参阅在包上签名。
SERVICE_URL- 可让您确定使用交互式登录连接到的 Orchestrator 实例的 URL。此值保存在uipath.config文件中。 可用性条件:在不包含RegisterService参数的情况下,将机器人从服务模式切换到用户模式时。TELEMETRY_ENABLED- 允许您禁用使用情况数据收集。 不支持更改现有安装。 它具有以下选项:0- 禁用 Studio 和机器人的遥测功能。1- 默认选项。 启用 Studio 和 Robot 的遥测功能。了解如何选择退出遥测功能。
ASSISTANT_OPTIONS- 启用或禁用 Assistant 的 Marketplace 小组件。它具有以下选项:- 无或
EnableMarketplace- 默认选项。 启用微件。 DisableMarketplace- 禁用小组件。
- 无或
DISABLE_SECURE_XAML- 允许您为作为 Windows 服务安装的机器人禁用XAML文件的安全性。 未加密的XAML文件允许用户读取和修改流程文件和逻辑。 不支持更改现有安装。 它具有以下选项:0- 默认选项。 启用 Windows 服务机器人XAML的文件保护功能。1- 为 Windows 服务机器人禁用XAML文件的安全性。
实时流式传输功能
从 2024.10 版开始,实时流式传输功能使用 UiPath 机器人 和 UiPath Studio 2024.10+ 安装程序中捆绑的 RealVNC 软件。 安装或升级到 2024.10+ 使用 GUI 或命令提示符的机器人会自动安装 RealVNC ,除非使用ADDLOCAL参数。 如果您选择在命令提示符中使用ADDLOCAL参数,那么您必须添加LiveStreaming标志。
例如,以下UiPathRobot.msi命令执行自定义安装或升级操作,该操作还安装实时流式传输所需的软件 RealVNC:
UiPathRobot.msi ADDLOCAL=Robot,RegisterService,LiveStreaming
UiPathRobot.msi ADDLOCAL=Robot,RegisterService,LiveStreaming
在早于 2024.10.5 的机器人版本中,实时流式传输和远程控制功能在代理设置状态下无法使用。将您的机器人升级到 2024.10.5 以上版本,以在代理设置状态下使用这些功能。