命令行参数

您可以安装并更新 Studio 和 Robot，也可以通过 UiPathStudio.msi 或 UiPathStudioCloud.msi 安装程序来更改现有安装。

请参阅以下各部分，了解有关可用参数的描述和一些用法示例。

备注：

• 需要管理员权限才能执行这些命令。
• 不支持在静默模式下通过从命令行运行安装程序来更改现有安装。但是，您可以在静默模式下运行安装程序，以从旧版本进行更新。
• 不支持使用 msiexec.exe 的 /passive 选项运行无人值守安装。

命令行参数描述

下表列出了所有可用的命令行参数。

所有参数都可以用于全新安装，但是从旧版本更新或更改现有安装时，仅支持以下参数：

• 使用 ADDLOCAL 启用/禁用功能。请注意，Robot 不能禁用。
• SERVICE_URL - 将 Robot 从服务模式切换到用户模式时可用，方式是不包括 RegisterService 参数。
• NUGET_OPTIONS、ENFORCE_SIGNED_EXECUTION、DISABLE_SECURE_XAML 和 TELEMETRY_ENABLED - 不可用于更改现有安装。

  命令	描述
  /q	帮助您静默安装指定的 UiPath 功能，而不显示用户界面。
  /l*vx <LogFile>	在指定路径生成安装程序日志文件。自 v2018.4.2 起，如果您在安装之时许可 Studio 或机器人，则此文件中也可能会包含许可信息。 如果您在安装过程中遇到困难，不管何种原因，均可将此文件发送给我们的支持团队。
  ADDLOCAL	使您能够选择要安装的功能。如果使用 ADDLOCAL，则仅安装其中指定的功能。如果未使用 ADDLOCAL，则安装以下功能：Studio、处于服务模式的机器人、Chrome 和 Edge 的扩展程序（如果计算机上安装以上浏览器）以及 JavaScript 加载项。 它支持以下选项： DesktopFeature - 指示要安装机器人和 Studio 功能。 Studio - 安装 Studio。 ExcelAddin - 安装 StudioX Excel 加载项。没有 Studio 便无法使用它。 Robot - 在用户模式或服务模式下安装 Robot 以及 Assistant。 要安装处于服务模式的机器人，请添加 RegisterService 选项。我们为无人值守机器人选择推荐此选项。 要在用户模式下安装 Robot，请不要添加 RegisterService 选项。我们为有人值守和开发机器人推荐该选项。 注意：将 Robot 从服务模式转换为用户模式时，Robot 可能无法访问原始 NuGet 包文件夹中的 .xaml 文件。有关如何解决此问题的详细信息，请参阅《迁移后无法访问 NuGet 包》故障排除文章。 StartupLauncher - 在 Windows 启动时运行机器人。如果未使用 Robot 参数，则不能使用此选项。 JavaBridge - 安装 UiPath Java Bridge，以实现更出色的 Java 应用程序集成和自动化。请注意，安装 Java Bridge 可能会延长安装时间。如果未使用 Robot 参数，则不能使用此选项。 ChromeExtension - 安装 Uipath Google Chrome 扩展程序。如果未使用 Robot 参数，则不能使用此选项。 FirefoxExtension - 例如：UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension /Q EdgeExtension - 安装基于 Microsoft Edge Chromium 的 UiPath 扩展程序。如果没有 Robot 参数，则不能使用。 CitrixClient - 安装 UiPath Citrix 客户端扩展程序。如果未使用 Robot 参数，则不能使用此选项。 JavaScriptAddOn - 安装机器人 JavaScript 插件以支持机器人 JavaScript SDK。 SapPlugin - 安装 SAP 解决方案管理器插件。需要在您的计算机上安装 SAP Connector for Microsoft。在全新安装上，您还必须使用 SAP_SOL_MAN_HOST 参数提供实例的地址。没有 Studio 便无法使用它。 VMwareExtension - 安装 UiPath VMware Horizon 扩展程序。如果未使用 Robot 参数，则不能使用此选项。 WindowsRdpExtension - 安装 UiPath Microsoft 远程桌面扩展程序。如果未使用 Robot 参数，则不能使用此选项。
  MSIINSTALLPERUSER	此参数使您能够按用户或按计算机安装 Studio 和 Robot。 如果未包含该参数，则按计算机进行安装。如果添加 MSIINSTALLPERUSER=1，则安装按用户进行。 这些参数仅在执行全新安装时可用。 以下选项在按用户安装中不可用：RegisterService、CitrixExtension、VMwareExtension、SapPlugin、PACKAGES_FOLDER、CODE。
  SAP_SOL_MAN_HOST	SAP Solution Manager 实例的主机名或 IP 地址。如果为 ADDLOCAL 选项提供了 SapPlugin 参数，则必须执行全新安装。 例如，UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address
  APPLICATIONFOLDER	用于在自定义位置安装 Studio 和机器人。
  NUGET_OPTIONS	如果您在离线环境中操作，建议使用此参数。若设为 DisableOnlineFeeds，此参数可帮助您禁用机器人的在线 UiPath 官方及社区订阅源，仅考虑使用 Orchestrator 和本地订阅源。 请注意，不会从配置文件中删除 URL 订阅源，仅忽略它们。 它可用于安装和升级。 注意：NUGET_OPTIONS 参数不会禁用 Studio 的在线 UiPath 官方和社区订阅源。
  PACKAGES_FOLDER	用于更改 Studio 和/或机器人工作流及其依赖项的下载位置。此文件夹可以由特定用户访问，也可由计算机上的所有用户访问。此参数可用于服务模式机器人或用户模式机器人。如果不提供此参数，则默认文件夹是 %userProfile%\.nuget\packages。 注意：更改包文件夹时，请确保需要执行流程的所有用户都具有该文件夹的读取访问权限。 可以使用 %USERNAME% 或 %USERPROFILE% 等环境变量。% 特殊字符需要通过以下方式转义： 使用命令行提示符调用安装时，可使用 UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%。 在批处理脚本中 - 使用 % - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%。 在 PowerShell 控制台或脚本中 - 不需要转义。 在使用 Active Directory 域帐户时，建议您也在文件夹结构中使用域，例如 C:\packages\^%UserDomain^%.^%Username^%。 对于 Windows Server 计算机（启用并发执行 - 高密度机器人）上的安装，您必须提供特定于每个用户的路径。阅读更多关于为多个机器人使用相同路径的信息。 注意： 使用 PACKAGES_FOLDER 参数时，存在一些限制。有关更多信息，请参阅自定义包文件夹和网络路径文档。 有关如何在安装后更改包的下载文件夹的信息，请参阅 管理活动包。
  CUSTOM_NUGET_FEEDS	让您可以为 Studio 和/或机器人添加自定义 NuGet 活动订阅源。此命令仅添加或更新现有的订阅源列表。 必须使用字符串类型的键值对来填充。有效的位置包括在线订阅源、文件夹路径和共享网络驱动器。确保提供的订阅源可被给定计算机上的所有用户访问。以分号 (;).分隔多个订阅源 示例：CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"。
  ENFORCE_SIGNED_EXECUTION	可选。让您可以强制机器人仅执行签名的包。可以在全新安装或更新实例时使用。如果部署时不指定此参数，则不启用包签名。 它支持以下选项： 1 - 机器人 只能 下载、安装或执行由 UiPath 签名的包作者或存储库。 如果要将自己的证书添加为受信任的来源，则必须通过修改 nuget.config 文件来执行此操作。 要了解如何执行此操作，请参阅此 页面。 0 - 不在您的机器人部署中实施任何包签名规则。 有关如何在安装后强制执行签名执行的信息，请参阅为 包签名 。
  CODE	许可您的 Studio 实例。
  CONNECTIONSTRING	使用连接字符串自动将机器人连接到内部部署 Orchestrator，同时进行安装。请注意，必须满足以下要求： 必须将 UiPath.Orchestrator.dll.config 文件中的 WindowsAuth.Enabled 参数设置为 true 必须将 WindowsAuth.Domain 参数设置为有效域 服务模式机器人 必须具有标准计算机配置。 注意： 使用 CONNECTIONSTRING 向标准计算机自动注册的做法仅适用于 Orchestrator v2020.10 一起。
  CHROME_INSTALL_TYPE	通过策略自动安装 Chrome 扩展程序。 它支持以下选项： GLOBAL - Chrome 扩展程序自动按系统安装，效果等同于使用“设置扩展程序”工具调用 /ChromeGlobal 命令。 STORE - Chrome 扩展程序是根据系统自动通过策略安装的，效果等同于使用 SetupExtenstions 工具调用 /ChromePolicyGlobal 命令。
  DISABLE_SECURE_XAML	允许为安装为 Windows 服务的机器人禁用 XAML 文件的安全性。未受保护的 XAML 文件允许用户读取并修改流程文件和逻辑。 它支持以下选项： 0 - 默认选项。如果使用，则为 Windows 服务机器人启用 XAML 文件的安全性。 1 - 为 Windows 服务机器人禁用 XAML 文件的安全性。 注意：此参数仅可在全新安装或更新时使用。
  SERVICE_URL	允许您定义用户将使用交互式登录连接的 Orchestrator 实例的 URL。 所提供的 URL 保存在 uipath.config 文件中，并且仅保存为用户模式机器人。对于服务模式安装，该参数将被忽略。 运行安装程序以从较早版本进行更新或更改现有安装时，如果要将 Robot 从服务模式切换到用户模式（不包括 RegisterService 选项），则支持使用此参数。
  ORCHESTRATOR_URL	在全新安装中，您可以指定用于检索自动更新信息的主要 Orchestrator URL（例如，https://orchestrator.local/organizationName/tenantName）。
  TELEMETRY_ENABLED	允许您禁用使用情况数据收集，并且可以在 Studio 和机器人的安装时完成。 注意：此参数仅可在全新安装或更新时使用。 默认情况下，为 Studio 和机器人启用遥测。要禁用该功能，请在执行全新安装或更新时为参数使用以下值： TELEMETRY_ENABLED=0 注意：这将禁用 Studio 和机器人的遥测功能。 如果要启用遥测，请不要包含该参数，或将其包含在以下值中： TELEMETRY_ENABLED=1 有关使用情况数据收集以及如何更改遥测设置的更多信息，请参阅选择退出遥测文档。
  ENABLE_PIP	允许您在 UiPath 命令行安装过程中启用计算机的画中画功能。 要启用它，请使用以下参数： ENABLE_PIP=1 示例： UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService ENABLE_PIP=1
  INSTALLER_LANGUAGE	使您能够选择安装程序的显示语言。如果未指定，则将根据 Windows 中的语言设置确定安装程序的语言。要指定语言，请输入参数 INSTALLER_LANGUAGE=<language_code>。可选择以下选项： 中文（简体）：INSTALLER_LANGUAGE=2052 英语：INSTALLER_LANGUAGE=9 法语：INSTALLER_LANGUAGE=12 德语：INSTALLER_LANGUAGE=7 日语：INSTALLER_LANGUAGE=17 韩语：INSTALLER_LANGUAGE=1 葡萄牙语（葡萄牙）：INSTALLER_LANGUAGE=22 葡萄牙语（巴西）：INSTALLER_LANGUAGE=1046 俄语：INSTALLER_LANGUAGE=25 西班牙语（西班牙）：INSTALLER_LANGUAGE=10 西班牙语（墨西哥）：INSTALLER_LANGUAGE=2058 土耳其语：INSTALLER_LANGUAGE=31
  ORCHESTRATOR_AUTO_SIGNIN	如果您在用户模式下安装 Attended Robot，并且您的环境配置为将 SSO 与 Azure Active Directory 一起使用，则可以自动登录到您的帐户。此参数必须与 ORCHESTRATOR_URL 一起使用。 要启用此选项，请使用 ORCHESTRATOR_AUTO_SIGNIN=1。
  ENFORCE_DEFAULT_SERVICE_URL	对于用户模式安装，此参数强制执行默认服务 URL。 要启用此选项，请使用 ENFORCE_DEFAULT_SERVICE_URL=1。 也必须启用 ORCHESTRATOR_URL。

示例

编写这些示例时，我们假设您已处于 UiPathStudio.msi 安装程序所在的目录中。您可以使用以下命令来完成此操作，例如：cd D:\UiPathInstaller。

• 将 Studio 和机器人安装为 Windows 服务 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService
• 在用户模式下仅为当前用户安装 Studio 和 Robot- UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Studio,Robot
• 静默安装整个桌面套件 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• 通过策略静默安装整个桌面套件和 Chrome 扩展程序 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=STORE /Q
• 在 D:\UiPath 文件夹 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService APPLICATIONFOLDER=D:\UiPath /Q 中以静默方式将 Studio 和机器人安装为 Windows 服务

• 将机器人静默安装为 Windows 服务，并将其连接到 Orchestrator -

  UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q

• 以静默方式安装 Studio，将机器人安装为 Windows 服务，并添加两个自定义活动订阅源 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1, https://my.custom.nuget.feed; FeedName2, D:\RPA\Activities\Packages\" /Q
• 静默安装并许可 Studio，并将机器人安装为 Windows 服务 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService CODE=1234567890 /Q
• 将机器人安装为 Windows 服务，并禁用官方在线订阅源 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds

• 在 Attended Robot 安装期间设置自动更新连接

  UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"

• 在 Unattended Robot 安装期间设置自动更新连接 -

  UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant"