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

机器人管理员指南
UiPath 提供 Windows 的两套安装程序。您可以从 UiPath Automation Cloud 中的资源中心或客户门户中的“产品下载”版块下载这些程序。
-
在 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 安装程序。 - 通过使用“自定义”选项进行安装,以按照计算机执行安装。
|
快速入门 |
自定义 | |
|---|---|---|
| 安装上下文 | 按用户 | 按用户或计算机 |
|
支持的机器人安装类型 |
用户模式 |
有人值守安装的用户模式(按用户和按计算机)。 无人值守安装的服务模式(按计算机)。 |
|
安装所需的管理员权限 |
否 |
仅对于每台计算机安装是必需的。 |
|
安装目录 |
|
可以选择自定义位置。默认位置为: 对于按用户安装模式,文件夹为
%LocalAppData%\Programs。
对于按计算机安装模式,文件夹为
%ProgramFiles%。
|
|
使用社区版许可激活 |
支持 |
支持 |
|
使用企业版许可激活 |
支持 |
支持 |
|
需要管理员权限 用于连接到 Orchestrator |
否 |
仅服务模式机器人需要 |
|
使用交互式登录连接到 Orchestrator。 |
支持 |
支持
1 |
|
使用计算机密钥连接到 Orchestrator |
支持 |
支持 |
|
无人值守执行,无需用户登录 |
不支持 |
仅支持服务模式机器人 |
1 - 对于服务模式机器人,您必须首先使用客户端凭据连接到 Orchestrator,然后才能使用交互式登录来更改连接到 Orchestrator 的用户。
UiPathStudio.msi 是主要针对开发者的 Windows 安装程序。 安装后,软件包包括开发环境 (UiPath Studio)、UiPath Robot 和 UiPath Assistant,以执行已开发的工作流。
如果您希望在同一台计算机上构建、调试和测试自动化任务,那么请使用此安装程序。
可用的安装选项
-
快速安装 - 在
%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 通常安装在主要执行自动化任务的 Windows 计算机上。 此安装不附加任何开发环境,因此资源分配主要用于运行机器人。 它包括 UiPath 机器人和 UiPath Assistant。
可用的安装选项
-
快速安装 - 在
%localappdata%\Programs\UiPath目录中安装默认配置。默认配置包括:-
Studio、StudioX 和 Assistant
-
用户模式机器人
-
StudioX Excel 加载项(如果您的计算机上已经安装了 Microsoft Excel)
-
Chrome 扩展程序(如果您的计算机上安装了 Google Chrome)
-
Edge Chromium 扩展程序(如果您的计算机上已经安装了 Microsoft Edge Chromium)
-
JavaScript Robot 附加项
-
Microsoft 远程桌面扩展程序
-
-
自定义安装 - 允许您选择要安装的组件,并配置高级设置。安装路径
%LocalAppData%\Programs适用于当前用户安装,%ProgramFiles%适用于设备上所有用户的安装。
自定义 - 可用的安装包
-
您的自定义配置将应用于当前的用户配置文件。
-
机器人安装在用户模式下。
-
无需管理员权限。
- 安装包
- Orchestrator URL — The URL of the Orchestrator instance to connect to using Interactive Sign-In. This value is saved in the
uipath.configfile. - Automatically sign in — When your environment is configured to use SSO with Azure Active Directory, you can enable automatic authentication for your account.
- Orchestrator URL — The URL of the Orchestrator instance to connect to using Interactive Sign-In. This value is saved in the
- 扩展程序 > 工具
- UiPath JavaScript 机器人插件 (*)
- 适用于 Chrome 的 UiPath 扩展程序 (*)
- 适用于 Edge Chromium 的 UiPath 扩展程序 (*)
- Firefox 版 UiPath 扩展程序
- Microsoft Remote Desktop 的 UiPath 扩展程序
- 扩展程序 > 包配置
- 禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。
- 安全性
- 强制签名执行 - 指示机器人仅执行已签名的包。
- 禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。
- 禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。
- 您的自定义配置将应用于计算机上的所有用户。
- 机器人安装在用户模式下。
- 需要管理员权限。
- 随 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 和机器人的匿名使用数据。
-
您的自定义配置将应用于计算机上的所有用户。
-
机器人安装在服务模式下。
-
需要管理员权限。
- 安装包
- 安装路径 - 所安装程序的目标文件夹。默认路径为
%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- Installs the specified UiPath features silently, without displaying the user interface./l*vx <LogFile>- Generates an installer log file at the specified path. You can send the file further to our support team if, for any reason, you encounter difficulties during the installation process.-
ADDLOCAL- Allows selecting the features to install. Without this parameter, the following features are installed by default: Robot in Service Mode, Default activity packages, and JavaScript Add-on.它支持以下选项:
DesktopFeature— Indicates that you want to install the Robot feature.Studio(exclusively for UiPathStudio.msi) — Installs Studio. Must be used together with theDesktopFeatureparameter.ExcelAddin(exclusively for UiPathStudio.msi) — Installs the StudioX Excel Add-in. Must be used together with theStudioparameter.Robot— Installs the Robot in User Mode or Service Mode, as well as the Assistant. Must be used together with theDesktopFeatureparameter.RegisterService— Required for Service Mode installations. Do not add it for User Mode installations.StartupLauncher— Runs the Robot at Windows startup. Must be used together with theDesktopFeatureparameter.Packages(exclusively for UiPathStudio.msi) — Installs the default activity packages. Must be used together with theRobotparameter.JavaBridge— Installs the UiPath Java Bridge for better integration and automation with Java applications. Adding this may increase installation time. Must be used together with theRobotparameter.ChromeExtension— Installs the Google Chrome Extension. Must be used together with theRobotparameter.FirefoxExtension— Installs the Firefox extension. Must be used together with theRobotparameter.EdgeExtension— Installs the Microsoft Edge Chromium-based Extension. Must be used together with theRobotparameter.CitrixClient— Installs the UiPath Citrix Client Extension. Must be used together with theRobotparameter. Not available for per-user installations.JavaScriptAddOn— Installs the Browser Embedding add-on. Must be used together with theRobotparameter. Cannot be used with elevated rights.SapPlugin(exclusively for UiPathStudio.msi) — Installs the SAP Solution Manager plugin. Requires the SAP Connector for Microsoft to be installed on your machine. On clean installs, you must also provide an address for the instance using theSAP_SOL_MAN_HOSTparameter. Must be used together with theStudioparameter. Not available for per-user installations.VMwareExtension— Installs the UiPath extension for VMware Horizon. Must be used together with theRobotparameter. Not available for per-user installations.WindowsRdpExtension— Installs the UiPath extension for Windows Remote Desktop. Must be used together with theRobotparameter.
MSIINSTALLPERUSER- Enables you to install only for the current user.- To install per user, add
MSIINSTALLPERUSER=1. The following options are not available in per-user installations: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE. - 如要按计算机安装,请勿包含此参数。
- To install per user, add
SAP_SOL_MAN_HOST(exclusively forUiPathStudio.msi) - The hostname or IP address of your SAP Solution Manager instance. Required for clean installations where theSapPluginparameter was added in theADDLOCALoption.APPLICATIONFOLDER- Enables you to install the Robot in a custom location.NUGET_OPTIONS- For offline environments. If set toDisableOnlineFeeds, this parameter disables the online UiPath official and Community feeds for the Robot, and uses Orchestrator and local feeds exclusively.Note: The URL feeds remain in the configuration files, but are ignored.-
PACKAGES_FOLDER- 可使您更改工作流及其依赖项的下载位置。 选定的文件夹可以是用户专属的文件夹,也可以由计算机上的所有用户访问。
- 如不设置此参数,默认下载位置为
%userProfile%\.nuget\packages。 -
不适用于按用户安装。
注意:确保需要执行流程的所有用户均具有新文件夹的读取权限。 - 了解如何设置自定义包文件夹和网络路径。
- 如需在启用并行执行的 Windows Server 计算机上安装,必须提供每个用户的专属路径。阅读有关为多个机器人使用相同路径的更多信息。
- 了解如何在安装后更改包的下载文件夹。
CUSTOM_NUGET_FEEDS- Enables you to add custom NuGet activities feeds for Studio and/or Robot. This command only adds or updates the existing list of feeds. It must be populated with key-value pairs of type string:- 有效的位置包括在线订阅源、文件夹路径和共享网络驱动器。
- 确保提供的订阅源可供给定计算机上的所有用户访问。
-
用分号 (;) 分隔订阅源。
例如:
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- Optional. Enables you to enforce your Robots to execute only signed packages. Without this parameter, package signing is not enabled. It has the following options:1- The Robot only handles packages signed by UiPath-verified authors or repositories. To add your own certificate as a trusted source, modify thenuget.configfile.0- 不在您的机器人部署中实施任何包签名规则。
CODE- Licenses your Robot instance. Not available for per-user installations.-
CLIENT_IDandCLIENT_SECRET- Automatically connects the Robot to Orchestrator using client credentials, while also installing it. For example: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- Allows you to choose the installation method for the Chrome extension. Needs admin rights. Without this parameter, the most appropriate method is selected automatically. It has the following options: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- Allows you to choose the installation method for the Edge extension. Needs admin rights. Without this parameter, the most appropriate method is selected automatically. It has the following options: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- Allows you to disable security ofXAMLfiles for Robots installed as a Windows service. UnsecuredXAMLfiles allow users to read and modify the process files and logic. It has the following options:0- The default option. Enables security forXAMLfiles for Windows service Robots.1- 为 Windows 服务机器人禁用XAML文件的安全性。
SERVICE_URL- Allows you to define the URL of the Orchestrator instance to connect to using Interactive Sign-In. This value is saved in theuipath.configfile. Required by User Mode installations. Service Mode installations ignore this parameter.ORCHESTRATOR_URL- In clean installations, you can specify the main Orchestrator URL, used for retrieving auto-update information. For example:https://orchestrator.local/organizationName/tenantName.TELEMETRY_ENABLED- Allows you to disable the usage data collection. It has the following options:0- Disables the telemetry for Studio and Robot.1- Default option. Enables the telemetry for Studio and Robot.
-
ENABLE_PIP- Allows you to enable the Robot session (Picture in Picture) functionality of the machine. It has the following options:0- Default option. The Robot session capability is disabled.1- Enables the Robot session capability.
INSTALLER_LANGUAGE- Enables you to select the display language of the installer. Without this parameter, the installer uses the language settings in Windows. It has the following options:2052- Chinese (Simplified)12- French7- German17- Japanese1- Korean22- Portuguese (Portugal)1046- Portuguese (Brazil)25- Russian10- Spanish (Spain)2058- Spanish (Mexico)31- Turkish
ASSISTANT_OPTIONS- Enables or disables the Marketplace widget for Assistant. It has the following options:- Absent or
EnableMarketplace- The default option. Enables the widget. DisableMarketplace- Disables the widget.
- Absent or
ORCHESTRATOR_AUTO_SIGNIN- Enables automatic sign-in to your account. For User Mode installations and environments configured to use the SSO with Azure Active Directory. Must be used together with theORCHESTRATOR_URLparameter. It has the following options:0- Disables the automatic sign-in.1- Enables the automatic sign-in.
ENFORCE_DEFAULT_SERVICE_URL- Enforces the default service URL. For User Mode installations. Must be used together with theORCHESTRATOR_URLparameter. It has the following options:0- Disables the enforcement of the default service URL.1- Enables the enforcement of the default service URL.
-
PROXY_SCRIPT_ADDRESS- The address of the script that determines how and when to use the proxy. Should contain the URI of the script file, for example,http://localhost/proxy.pac.备注:- 如果使用此参数,请不要使用其他特定于各代理的参数。
- 当 UiPath.config 文件中存在所有参数时,仅使用
ScriptAddress键。
PROXY_ADDRESS- The address of the proxy server, either IP or domain name. For example,http://my.proxy.net:8008.Note: To be used together with:PROXY_BYPASS_LOCAL_ADDRESSPROXY_BYPASS_LIST
PROXY_USER_NAMEPROXY_PASSWORDPROXY_DOMAIN
PROXY_BYPASS_LOCAL_ADDRESS- Allows direct connection for local addresses, bypassing the proxy server. Set it to 1 to bypass the local address, or to 0 otherwise.Note: To be used together with:PROXY_ADDRESSPROXY_BYPASS_LIST
PROXY_BYPASS_LIST- The list of addresses that connect directly to the internet, bypassing the proxy server. Should contain RegExr strings that contain the URIs of servers to bypass. For example,server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}.Note: To be used together with:PROXY_ADDRESSPROXY_BYPASS_LIST
PROXY_USER_NAME- RequiresPROXY_PASSWORD. The username credential for proxy server authentication.PROXY_PASSWORD- The password associated with the username for proxy server authentication.PROXY_DOMAIN- The domain where the proxy server resides, required for authentication.
更新或修改现有安装 - 命令行参数
UiPathStudio.msi时,可使用这些参数。
/q- Not supported for changing an existing installation. Updates the specified UiPath features silently, without displaying the user interface.-
ADDLOCAL- Allows selecting the features to update. Without this parameter, the following features are updated by default: Robot in Service Mode, Default activity packages, and JavaScript Add-on.它支持以下选项:
DesktopFeature— Indicates that you want to install the Robot feature.Studio(exclusively for UiPathStudio.msi) — Installs Studio. Must be used together with theDesktopFeatureparameter.ExcelAddin(exclusively for UiPathStudio.msi) — Installs the StudioX Excel Add-in. Must be used together with theStudioparameter.Robot— Installs the Robot in User Mode or Service Mode, as well as the Assistant. Must be used together with theDesktopFeatureparameter.RegisterService— Required for Service Mode installations. Do not add it for User Mode installations.LiveStreaming- Installs the live streaming software (RealVNC) on the machine. See The Live Streaming feature.StartupLauncher— Runs the Robot at Windows startup. Must be used together with theDesktopFeatureparameter.Packages(exclusively for UiPathStudio.msi) — Installs the default activity packages. Must be used together with theRobotparameter.JavaBridge— Installs the UiPath Java Bridge for better integration and automation with Java applications. Adding this may increase installation time. Must be used together with theRobotparameter.ChromeExtension— Installs the Google Chrome Extension. Must be used together with theRobotparameter.FirefoxExtension— Installs the Firefox extension. Must be used together with theRobotparameter.EdgeExtension— Installs the Microsoft Edge Chromium-based Extension. Must be used together with theRobotparameter.CitrixClient— Installs the UiPath Citrix Client Extension. Must be used together with theRobotparameter. Not available for per-user installations.JavaScriptAddOn— Installs the Browser Embedding add-on. Must be used together with theRobotparameter. Cannot be used with elevated rights.SapPlugin(exclusively for UiPathStudio.msi) — Installs the SAP Solution Manager plugin. Requires the SAP Connector for Microsoft to be installed on your machine. On clean installs, you must also provide an address for the instance using theSAP_SOL_MAN_HOSTparameter. Must be used together with theStudioparameter. Not available for per-user installations.VMwareExtension— Installs the UiPath extension for VMware Horizon. Must be used together with theRobotparameter. Not available for per-user installations.WindowsRdpExtension— Installs the UiPath extension for Windows Remote Desktop. Must be used together with theRobotparameter.
-
REMOVE- Disables a feature.Note: Robot cannot be removed. NUGET_OPTIONS- Not supported for changing an existing installation. For offline environments. If set toDisableOnlineFeeds, this parameter disables the online UiPath official and Community feeds for the Robot, and uses Orchestrator and local feeds exclusively.Note: The URL feeds remain in the configuration files, but are ignored.ENFORCE_SIGNED_EXECUTION- Optional. Enables you to enforce your Robots to execute only signed packages. Without this parameter, package signing is not enabled. Not supported for changing an existing installation. It has the following options:1- The Robot only handles packages signed by UiPath-verified authors or repositories. To add your own certificate as a trusted source, modify thenuget.configfile.0- 不在您的机器人部署中实施任何包签名规则。
SERVICE_URL- Allows you to define the URL of the Orchestrator instance to connect to using Interactive Sign-In. This value is saved in theuipath.configfile. Available when switching the Robot from Service Mode to User Mode, by not including theRegisterServiceparameter.TELEMETRY_ENABLED- Allows you to disable the usage data collection. Not supported for changing an existing installation. It has the following options:0- Disables the telemetry for Studio and Robot.1- Default option. Enables the telemetry for Studio and Robot.
ASSISTANT_OPTIONS- Enables or disables the Marketplace widget for Assistant. It has the following options:- Absent or
EnableMarketplace- The default option. Enables the widget. DisableMarketplace- Disables the widget.
- Absent or
DISABLE_SECURE_XAML- Allows you to disable security ofXAMLfiles for Robots installed as a Windows service. UnsecuredXAMLfiles allow users to read and modify the process files and logic. Not supported for changing an existing installation. It has the following options:0- The default option. Enables security forXAMLfiles for Windows service Robots.1- 为 Windows 服务机器人禁用XAML文件的安全性。
ADDLOCAL参数。 如果您选择在命令提示符中使用ADDLOCAL参数,那么您必须添加LiveStreaming标志。
UiPathRobot.msi命令执行自定义安装或升级操作,该操作还安装实时流式传输所需的软件 RealVNC:
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,LiveStreamingUiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,LiveStreaming在早于 2024.10.5 的机器人版本中,实时流式传输和远程控制功能在代理设置状态下无法使用。将您的机器人升级到 2024.10.5 以上版本,以在代理设置状态下使用这些功能。