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

机器人管理员指南

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

在 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

      在计算机上安装实时流式传输软件 (RealVNC)。请参阅“实时流式传输”功能

      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。保留所有权利。