命令行参数

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

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

备注：

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

命令行参数描述

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

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

• 使用 ADDLOCAL 启用功能。
• 使用 REMOVE 禁用功能。请注意，无法禁用 Robot。
• 使用 ASSISTANT_OPTIONS 启用或禁用 UiPath Assistant 选项。
• SERVICE_URL - 将 Robot 从服务模式切换到用户模式时可用，方式是不包括 RegisterService 参数。
• NUGET_OPTIONS、ENFORCE_SIGNED_EXECUTION、DISABLE_SECURE_XAML 和 TELEMETRY_ENABLED - 从旧版本更新时可用，而在更改现有安装时不可用。
• 使用 PROXY_ADDRESS 查看代理服务器的地址（IP 或域名）。

输入路径时，请考虑以下事项：

• 可以使用 %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^%。
• 如果需要使用带空格的路径，则必须按如下方式将该路径换行：
  • 在命令提示符中，使用双引号 (" ") 将其括起。例如，UiPathStudio.msi APPLICATIONFOLDER="C:\folder name"。
  • 在 PowerShell 中，请使用单引号和双引号 ('" "') 将其括起。例如 ./UiPathStudio.msi APPLICATIONFOLDER='"C:\folder name"'。

命令	描述
/q	帮助您静默安装指定的 UiPath 功能，而不显示用户界面。
/l*vx <LogFile>	在指定路径生成安装程序日志文件。自 v2018.4.2 起，如果您在安装之时许可 Studio 或机器人，则此文件中也可能会包含许可信息。 如果您在安装过程中遇到困难，不管何种原因，均可将此文件发送给我们的支持团队。
ADDLOCAL	要以服务模式安装机器人，请添加 RegisterService 选项。我们为无人值守机器人选择推荐此选项。 要在用户模式下安装 Robot，请不要添加 RegisterService 选项。我们为有人值守和开发机器人推荐该选项。 如果您将机器人从服务模式转换为用户模式，机器人可能无法访问原始 NuGet 包文件夹中的.xaml文件。 有关如何解决此问题的详细信息，请参阅“迁移后无法访问 NuGet 包”一文。 StartupLauncher – 在 Windows 启动时运行机器人。 如果未使用 Robot 参数，则不能使用此选项。 JavaBridge – 安装 UiPath Java Bridge，以改进 Java 应用程序的集成和自动化。安装 Java Bridge 可能会导致安装时间比平时更长。 如果未使用 Robot 参数，则不能使用此选项。 ChromeExtension – 安装 UiPath Google Chrome 扩展程序。如果未使用 Robot 参数，则不能使用此选项。 FirefoxExtension – Installs the UiPath Mozilla Firefox Extension. It cannot be used without the Robot argument. Example: UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension. EdgeExtension – 安装 UiPath Microsoft Edge（基于 Chromium）扩展程序。如果未使用 Robot 参数，则不能使用此选项。 CitrixClient – 安装 UiPath Citrix 客户端扩展程序。如果未使用 Robot 参数，则不能使用此选项。 JavaScriptAddOn – 安装机器人 JavaScript SDK 所需的机器人 JavaScript 插件。 SapPlugin – 安装 SAP 解决方案管理器插件。 需要 SAP 连接器用于 Microsoft。 对于全新安装，您还必须使用 SAP_SOL_MAN_HOST 提供实例地址。没有 Studio 便无法使用它。 VMwareExtension – 安装 UiPath VMware Horizon 扩展程序。如果未使用 Robot 参数，则不能使用此选项。 WindowsRdpExtension – 安装 UiPath Microsoft 远程桌面扩展程序。如果未使用 Robot 参数，则不能使用此选项。 AmazonWorkSpacesClient – 安装 UiPath Amazon WorkSpaces 扩展程序。如果未使用 Robot 参数，则不能使用此选项。 LiveStreaming – 安装远程调试所需的实时流媒体软件 (RealVNC)。 请参阅机器人指南中的实时流式传输功能。
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=Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address
APPLICATIONFOLDER	用于在自定义位置安装 Studio 和机器人。
NUGET_OPTIONS	如果您在离线环境中工作，建议使用此参数。 如果设置为 DisableOnlineFeeds，则此参数可帮助您为机器人禁用在线 UiPath 官方和社区订阅源（仅考虑 Orchestrator 和本地订阅源）。请注意，URL 订阅源不会从配置文件中删除，只是将其忽略。 它可用于安装和升级。 升级时，您可以将参数设置为 EnableOnlineFeeds，以启用在线订阅源。 注意：NUGET_OPTIONS 参数不会禁用 Studio 的在线 UiPath 官方和社区订阅源。
PACKAGES_FOLDER	用于更改 Studio 和/或机器人工作流及其依赖项的下载位置。此文件夹可以由特定用户访问，也可由计算机上的所有用户访问。此参数可用于服务模式或用户模式的机器人。 如果不提供此参数，则默认文件夹是 %userProfile%\\.nuget\\packages。 更改包文件夹时，请确保需要执行Processes的所有用户都具有对此文件夹的读取访问权限。使用PACKAGES_FOLDER参数时，存在一些限制。 请在自定义包文件夹和网络路径文档中了解更多信息。 对于在 Windows Server 计算机上安装（启用并发执行 – HD Robots），您必须提供每个用户专属路径。 阅读有关为多个机器人使用同一路径的更多信息。 有关如何在安装后更改包的下载文件夹的信息，请参阅管理活动包。
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 实例。
CLIENT_ID 和 CLIENT_SECRET	在安装机器人的同时，使用客户端凭据自动将机器人连接到 Orchestrator。 示例：UiPathStudio.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k。
CHROME_INSTALL_TYPE	POLICYOFFLINE - Chrome 扩展程序是通过离线组策略方法自动安装到每个系统的，这相当于使用 SetupExtensions 工具调用 /Chrome-Policy-Offline 命令。 POLICYONLINE - Chrome 扩展程序是通过在线组策略方法自动安装到每个系统的，这相当于使用 SetupExtensions 工具调用 /ChromePolicyGlobal 命令。 MANUALPERMACHINE - 为所有用户安装 Chrome 扩展程序，相当于使用 SetupExtensions 工具调用 /ChromeGlobal 命令。 NATIVEHOSTONLY - 仅安装原生消息传递主机组件 (ChromeNativeMessaging.exe)，相当于使用 SetupExtensions 工具调用 /ChromeNativeHostGlobal 命令。 保留旧安装方法名称 (STORE 、GLOBAL )，以实现向后兼容。
EDGE_INSTALL_TYPE	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	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	TELEMETRY_ENABLED=0 TELEMETRY_ENABLED=1 有关使用情况数据收集以及如何更改遥测设置的更多信息，请参阅选择退出遥测文档。
ENABLE_PIP	ENABLE_PIP=1 示例： UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	中文（简体）：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
ASSISTANT_OPTIONS	要启用微件，请使用 ASSISTANT_OPTIONS=EnableMarketplace 或不添加此参数。 要禁用微件，请使用 ASSISTANT_OPTIONS=DisableMarketplace。
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。
PROXY_SCRIPT_ADDRESS	如果使用此参数，请不要使用其他特定于各代理的参数。 当 UiPath.config 文件中存在所有参数时，仅使用 ScriptAddress 键。
PROXY_BYPASS_LOCAL_ADDRESS PROXY_BYPASS_LIST PROXY_USER_NAME PROXY_PASSWORD PROXY_DOMAIN	代理服务器的地址（IP 或域名）。例如：http://my.proxy.net:8008.
PROXY_ADDRESS PROXY_BYPASS_LIST	允许绕过代理服务器直接连接本地地址。 如果绕过本地地址，则将其设置为 1，否则设置为 0。
PROXY_ADDRESS PROXY_BYPASS_LOCAL_ADDRESS	绕过代理服务器直接连接到互联网的地址列表。应包含正则表达式字符串，而这些字符串包含要绕过的服务器 URL。例如，“server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}”。
PROXY_USER_NAME（需要 PROXY_PASSWORD）。	用于代理服务器身份验证的用户名凭据。
PROXY_PASSWORD	与用于代理服务器身份验证的用户名关联的密码。
PROXY_DOMAIN	代理服务器所在的域，用于身份验证。

执行同步安装

如果要在安装完成后进行其他配置，可以同步运行安装程序。这使您能够添加要在安装程序完成后执行的其他命令，例如，您可以安装并设置机器人连接或配置订阅源。

以下脚本将执行安装，并允许您添加安装成功后要执行的其他命令。

:: Runnning the MSI synchronously
start /wait /b UiPathStudio.msi /Q
:: Assert the exit code and continue accordingly
set "_isSuccess="
if %ERRORLEVEL% EQU 0 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 1641 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 3010 Set "_isSuccess=1"
:: test for success and run follow-up commands
if (%_isSuccess% EQU 1) (
    echo "success"
) ELSE (
    echo "fail"
)

示例

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

• 将 Studio、机器人安装为 Windows 服务和活动包 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService
• 在用户模式下仅为当前用户安装 Studio 和 Robot- UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot
• 为 Robot 2024.10+ - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,LiveStreaming 版本安装实时流式传输功能
• 静默安装整个桌面套件 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• 通过策略静默安装整个桌面套件和 Chrome 扩展程序 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
• 将 Studio、机器人静默安装为 Windows 服务和活动包，并且全部安装在 D:\UiPath 文件夹中 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService APPLICATIONFOLDER=D:\UiPath /Q
• 将机器人静默安装为 Windows 服务，并将其连接到 Orchestrator -

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

• 以静默方式安装 Studio，将机器人安装为 Windows 服务，并添加两个自定义活动订阅源 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• 静默安装并许可 Studio、注册为 Windows 服务的机器人和本地活动订阅源 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CODE=1234567890 /Q
• 将机器人安装为 Windows 服务，并禁用官方在线订阅源 - UiPathStudio.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• 卸载 Chrome 扩展程序 - UiPathStudio.msi REMOVE=ChromeExtension /Q
• 在安装 Attended Robot 期间设置自动更新连接 - UiPathStudio.msi ADDLOCAL=Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"
• 在安装 Unattended Robot 期间设置自动更新连接 - UiPathStudio.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"