机器人管理员指南

可用的安装选项

• 快速安装 - 在%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 - 使用交互式登录连接上的 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 和机器人的匿名使用数据。

为此计算机上的所有用户安装 - 可用的安装包

• 安装包

  • 安装路径 - 所安装程序的目标文件夹。默认路径为%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 和机器人的匿名使用数据。

• 安装包
  • 许可证代码（可选） - 您的独立试用或企业许可证的密钥。 在独立试用设置期间，如无密钥，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 和机器人的匿名使用数据。

可用的安装选项

• 快速安装 - 在%localappdata%\Programs\UiPath目录中安装默认配置。默认配置包括：

  • Studio、StudioX 和 Assistant

  • 用户模式机器人

  • StudioX Excel 加载项（如果您的计算机上已经安装了 Microsoft Excel）

  • Chrome 扩展程序（如果您的计算机上安装了 Google Chrome）

  • Edge Chromium 扩展程序（如果您的计算机上已经安装了 Microsoft Edge Chromium）

  • JavaScript Robot 附加项

  • Microsoft 远程桌面扩展程序

• 自定义安装 - 允许您选择要安装的组件，并配置高级设置。安装路径%LocalAppData%\Programs适用于当前用户安装，%ProgramFiles%适用于设备上所有用户的安装。

自定义 - 可用的安装包

• 安装包
  • 安装路径 - 所安装程序的目标文件夹。默认路径为%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 和机器人的匿名使用数据。

最佳实践

• 如要转义系统变量名称中的 "%" 字符，如 %username%，请使用以下命令：

  assignment

  ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%

  备注：

  在 PowerShell 中，不需要转义。

• 使用 Active Directory 域账户时，请在文件夹结构中指定域名：

  assignment

  C:\packages\^%UserDomain^%.^%Username^%C:\packages\^%UserDomain^%.^%Username^%

• 如要使用包含空格的路径，请使用引号：

  • 在命令提示符中，使用双引号：

    assignment

    UiPathRobot.msi APPLICATIONFOLDER="C:\folder name"UiPathRobot.msi APPLICATIONFOLDER="C:\folder name"

  • 在 PowerShell 中，使用单引号和双引号：

    assignment

    ./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'

清洁安装 - 命令行参数

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

• /q - 静默安装指定的 UiPath 功能，而不显示用户界面。
• /l*vx <LogFile> - 在指定的路径中生成安装程序日志文件。如果您在安装过程中遇到困难，不管何种原因，均可将此文件发送给我们的支持团队。
• ADDLOCAL - 允许选择要安装的功能。如不设置此参数，则默认安装以下功能：服务模式机器人、默认活动包和 JavaScript 加载项。

  它支持以下选项：

  • DesktopFeature — 指明您要安装 Robot 功能。
  • Studio （专用于 UiPathStudio.msi）— 安装 Studio。必须与DesktopFeature参数一起使用。
  • ExcelAddin （专用于 UiPathStudio.msi）— 安装 StudioX Excel 加载项。必须与Studio参数一起使用。
  • Robot — 安装用户模式或服务模式下的机器人以及 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 远程桌面的 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。

  • 不适用于按用户安装。

    注意：确保需要执行流程的所有用户均具有新文件夹的读取权限。
  • 了解如何设置自定义包文件夹和网络路径。
  • 如需在启用并行执行的 Windows Server 计算机上安装，必须提供每个用户的专属路径。阅读有关为多个机器人使用相同路径的更多信息。
  • 了解如何在安装后更改包的下载文件夹。
• CUSTOM_NUGET_FEEDS - 使您能够为 Studio 和/或机器人添加自定义 NuGet 活动订阅源。此命令只会添加或更新订阅源的现有列表。必须填充类型为字符串的键值对：
  • 有效的位置包括在线订阅源、文件夹路径和共享网络驱动器。
  • 确保提供的订阅源可供给定计算机上的所有用户访问。

  • 用分号 (;) 分隔订阅源。

    例如：

    assignment

    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_ID和CLIENT_SECRET -使用客户端凭据自动将机器人连接到 Orchestrator，同时安装它。例如：
  assignment

  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 和机器人的遥测功能。
  了解如何退出遥测。
• 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 - 代理服务器的地址（IP 或域名）。例如http://my.proxy.net:8008 。
  注意：要与以下产品一起使用：

  • PROXY_BYPASS_LOCAL_ADDRESS
  • PROXY_BYPASS_LIST

  或使用以下内容：

  • PROXY_USER_NAME
  • PROXY_PASSWORD
  • PROXY_DOMAIN
• PROXY_BYPASS_LOCAL_ADDRESS - 允许绕过代理服务器直接连接本地地址。将其设置为 1 会绕过本地地址，否则设置为 0。
  注意：要与以下产品一起使用：

  • PROXY_ADDRESS
  • PROXY_BYPASS_LIST
• PROXY_BYPASS_LIST - 绕过代理服务器直接连接到互联网的地址列表。应包含正则表达式字符串，而这些字符串包含要绕过的服务器 URI。例如server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3} 。
  注意：要与以下产品一起使用：

  • PROXY_ADDRESS
  • PROXY_BYPASS_LIST
• PROXY_USER_NAME - 需要PROXY_PASSWORD 。用于代理服务器身份验证的用户名凭据。
• PROXY_PASSWORD - 与用于代理服务器身份验证的用户名关联的密码。
• PROXY_DOMAIN - 代理服务器所在的域，身份验证所必需的。

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