robot
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

机器人管理员指南

上次更新日期 2025年9月25日

在 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.msiUiPathPlatformInstaller.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

可以选择自定义位置。默认位置为:

  • %LocalAppData%\Programs用于按用户安装。
  • %ProgramFiles%

使用社区版许可激活

支持

支持

使用企业版许可激活

支持

支持

需要管理员权限

用于连接到 Orchestrator

仅服务模式机器人需要

使用交互式登录连接到 Orchestrator。

支持

支持 1

使用计算机密钥连接到 Orchestrator

支持

支持

无人值守执行,无需用户登录

不支持

仅支持服务模式机器人

1 - 对于服务模式机器人,您必须首先使用客户端凭据连接到 Orchestrator,然后才能使用交互式登录来更改连接到 Orchestrator 的用户。

使用 UiPathStudio.msi

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 一起使用时,您可以为您的账户启用自动身份验证。

扩展程序 > 工具

  • 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 机器人 - 安装以下配置,用于运行 Attended 自动化任务,并随 Windows 自动启动 Assistant。

    • 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。

可用的安装选项

  • 快速安装 - 在%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 文件中。

    • 自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为您的账户启用自动身份验证。

    扩展程序 > 工具

    • 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.msiUiPathRobot.msi时,可使用这些参数。

命令

描述

/q

  • 在不显示用户界面的情况下,静默安装指定的 UiPath 功能。

/l*vx <LogFile>

  • 在指定路径中生成安装程序日志文件。

  • 如果您在安装过程中遇到困难,不管何种原因,均可将此文件发送给我们的支持团队。

ADDLOCAL

  • 允许选择要安装的功能。

  • 如不设置此参数,默认安装以下功能:

    • 服务模式下的机器人

    • 默认活动包

    • JavaScript 加载项

  • 它支持以下选项:

    • DesktopFeature
      表示您想安装机器人功能。
      Studio (仅限UiPathStudio.msi

      安装 Studio。

      必须与DesktopFeature参数一起使用。
      ExcelAddin (仅限UiPathStudio.msi

      安装 StudioX Excel 加载项。

      必须与Studio参数一起使用。
      机器人
      安装用户模式或服务模式下的机器人以及 Assistant。
      必须与DesktopFeature参数一起使用。
      RegisterService

      对服务模式安装而言是必需的。

      不要在用户模式安装中添加它。

      StartupLauncher

      在 Windows 启动时运行机器人。

      必须与DesktopFeature参数一起使用。
      Packages (仅限UiPathStudio.msi

      安装默认活动包。

      必须与Robot参数一起使用。
      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

      安装 VMware Horizon 的 UiPath 扩展程序。

      必须与Robot参数一起使用。

      不适用于按用户安装。

      WindowsRdpExtension

      安装 Windows Remote Desktop 的 UiPath 扩展程序。

      必须与Robot参数一起使用。

MSIINSTALLPERUSER

  • 使您能够仅为当前用户安装。

    • 如要按用户安装,请添加MSIINSTALLPERUSER=1
    • 如要按计算机安装,请勿包含此参数。

以下选项在按用户安装中不可用:RegisterService、CitrixExtension、VMwareExtension、PACKAGES_FOLDER、CODE。

SAP_SOL_MAN_HOST (仅限UiPathStudio.msi
  • SAP 解决方案管理器实例的主机名或 IP 地址。

  • 对于在ADDLOCAL选项中添加了SapPlugin参数的清洁安装,这是必需的。

APPLICATIONFOLDER

  • 用于在自定义位置安装 Robot。

NUGET_OPTIONS

  • 适用于离线环境。

  • 如果设置为DisableOnlineFeeds,那么此参数将禁用机器人的在线 UiPath 官方和社区订阅源,并仅使用 Orchestrator 和本地订阅源。
备注:

URL 订阅源仍保留在配置文件中,但会被忽略。

PACKAGES_FOLDER

  • 可使您更改工作流及其依赖项的下载位置。 选定的文件夹可以是用户专属的文件夹,也可以由计算机上的所有用户访问。

  • 如不设置此参数,默认下载位置为%userProfile%\.nuget\packages
  • 不适用于按用户安装。

注意:确保需要执行流程的所有用户均具有新文件夹的读取权限。

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

  • 向您的 Robot 实例授予许可。

  • 不适用于按用户安装。

CLIENT_IDCLIENT_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
    Chrome 扩展程序通过组策略在线方法自动按系统安装,相当于使用 SetupExtensions 工具调用/ChromePolicyGlobal命令。
    MANUALPERMACHINE
    为所有用户安装 Chrome 扩展程序,相当于使用 SetupExtensions 工具/ChromeGlobal调用命令。
    NATIVEHOSTONLY
    只安装原生消息传递主机组件(ChromeNativeMessaging.exe),相当于使用 SetupExtensions 工具调用命令/ChromeNativeHostGlobal
注意:旧的安装方法名称(STOREGLOBAL)会保留下来,以保持向后兼容性。

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
注意:旧的安装方法名称(STOREGLOBAL)会保留下来,以保持向后兼容性。

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 和机器人的遥测功能。

  • 了解如何退出遥测

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
  • 启用自动登录您账户这一功能。

  • 适用于用户模式安装以及配置为将 SSO 与 Azure Active Directory 一起使用的环境。

  • 必须与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

需与以下内容一起使用:

  • PROXY_BYPASS_LOCAL_ADDRESS

  • PROXY_BYPASS_LIST

或使用以下内容:

  • PROXY_USER_NAME

  • PROXY_PASSWORD

  • PROXY_DOMAIN

代理服务器的地址(IP 或域名)。例如,http://my.proxy.net:8008

PROXY_BYPASS_LOCAL_ADDRESS

需与以下内容一起使用:

  • PROXY_ADDRESS

  • PROXY_BYPASS_LIST

允许绕过代理服务器直接连接本地地址。

如果绕过本地地址,则将其设置为 1,否则设置为 0。

PROXY_BYPASS_LIST

需与以下内容一起使用:

  • PROXY_ADDRESS

  • PROXY_BYPASS_LOCAL_ADDRESS

绕过代理服务器直接连接到互联网的地址列表。应包含正则表达式字符串,而这些字符串包含要绕过的服务器 URI。例如,“server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}”。

PROXY_USER_NAME

需要 PROXY_PASSWORD

用于代理服务器身份验证的用户名凭据。

PROXY_PASSWORD

与用于代理服务器身份验证的用户名关联的密码。

PROXY_DOMAIN

代理服务器所在的域,用于身份验证。

更新或修改现有安装 - 命令行参数

从命令行运行 UiPathStudio.msi时,可使用这些参数。

命令

描述

/q

不支持更改现有安装。

  • 在不显示用户界面的情况下,静默更新指定的 UiPath 功能。

ADDLOCAL

  • 允许选择要安装的功能。

  • 如不设置此参数,默认安装以下功能:

    • 服务模式下的机器人

    • 默认活动包

    • JavaScript 加载项

  • 它支持以下选项:

    • DesktopFeature
      表示您想安装机器人功能。
      Studio (仅限UiPathStudio.msi

      安装 Studio。

      必须与DesktopFeature参数一起使用。
      ExcelAddin (仅限UiPathStudio.msi

      安装 StudioX Excel 加载项。

      必须与Studio参数一起使用。
      机器人
      安装用户模式或服务模式下的机器人以及 Assistant。
      必须与DesktopFeature参数一起使用。
      RegisterService

      对服务模式安装而言是必需的。

      不要在用户模式安装中添加它。

      LiveStreaming

      Installs the live streaming software (RealVNC) on the machine. See The Live Streaming feature.

      StartupLauncher

      在 Windows 启动时运行机器人。

      必须与DesktopFeature参数一起使用。
      Packages (仅限UiPathStudio.msi

      安装默认活动包。

      必须与Robot参数一起使用。
      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

      安装 VMware Horizon 的 UiPath 扩展程序。

      必须与Robot参数一起使用。

      不适用于按用户安装。

      WindowsRdpExtension

      安装 Windows Remote Desktop 的 UiPath 扩展程序。

      必须与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 和机器人的遥测功能。

  • 了解如何退出遥测

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=DesktopFeature,Robot,RegisterService,LiveStreamingUiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,LiveStreaming
警告:

在早于 2024.10.5 的机器人版本中,实时流式传输和远程控制功能在代理设置状态下无法使用。将您的机器人升级到 2024.10.5 以上版本,以在代理设置状态下使用这些功能。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo
信任与安全
© 2005-2025 UiPath。保留所有权利。