Studio
2020.10
False
横幅背景图像
不在支持范围内
Studio 用户指南
上次更新日期 2023年12月20日

命令行参数

命令行参数描述

只要您有 UiPathStudio.msi 安装程序,就可以使用命令行安装或更新 Studio 或机器人。下表列出了所有可用参数,并结合一些示例进行说明。
备注:

在静默模式下,无法从命令提示符中对 UiPath 平台的现有实例进行更改。但是,完全支持对执行更新时安装的内容进行更改。

安装程序命令行参数在 UiPathPlatformInstaller.exe 中无效。

需要管理员权限才能执行这些命令。

命令

描述

/q

帮助您静默安装指定的 UiPath 功能,而不显示用户界面。

/l*vx <LogFile>

在指定路径生成安装程序日志文件。自 v2018.4.2 起,如果您在安装之时许可 Studio 或机器人,则此文件中也可能会包含许可信息。

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

ADDLOCAL

使您能够选择要安装的功能。如果使用 ADDLOCAL,则仅安装其中指定的功能。如果未使用 ADDLOCAL,则会安装以下功能:Studio、处于服务模式的机器人、活动包和 JavaScript 插件。

它支持以下选项:

DesktopFeature - indicates that you want to install Robot and Studio features.
Studio - Installs Studio. It cannot be used without DesktopFeature.
ExcelAddin - 安装 StudioX Excel 加载项。无法在没有 Studio 的情况下使用。
Robot - 安装处于用户模式或服务模式的机器人。无法在没有 DesktopFeature 的情况下使用。
  • 要安装处于服务模式的机器人,请添加 RegisterService 选项。我们为无人值守机器人选择推荐此选项。
  • 要在用户模式下安装 Robot,请不要添加 RegisterService 选项。我们为有人值守和开发机器人推荐该选项。
UseLegacyTray - 安装旧版机器人托盘,而不是 UiPath Assistant。
注意:要在安装后切换到 Assistant,请运行 REMOVE=UseLegacyTray
Packages - Installs the activities packages. It cannot be used without the DesktopFeature and Robot arguments.
StartupLauncher - Runs the Robot at Windows startup. It cannot be used without the DesktopFeatureand Robot arguments.
JavaBridge - Installs the UiPath Java Bridge for a better integration and automation in regards to Java applications. Please note that installing the Java Bridge may cause the installation to last longer than usual. It cannot be used without the DesktopFeature and Robot arguments.
ChromeExtension - Installs the UiPath Google Chrome Extension. It cannot be used without the DesktopFeature and Robot arguments.
EdgeExtension - 安装基于 UiPath Microsoft Edge Chromium 的扩展程序。如果未使用 Robot 参数,则不能使用此选项。
CitrixClient - Installs the UiPath Citrix Client Extension. It cannot be used without the DesktopFeature and Robot arguments.
JavaScriptAddOn - 为机器人安装浏览器嵌入插件。

APPLICATIONFOLDER

用于在自定义位置安装 Studio 和机器人。

NUGET_OPTIONS

如果您在离线环境中操作,建议使用此参数。若设为 DisableOnlineFeeds,此参数可帮助您禁用机器人的在线 UiPath 官方及社区订阅源,仅考虑使用 Orchestrator 和本地订阅源。

请注意,不会从配置文件中删除 URL 订阅源,仅忽略它们。

它可用于安装和升级。

PACKAGES_FOLDER

用于更改 Studio 和/或机器人工作流及其依赖项的下载位置。此文件夹可以由特定用户访问,也可由计算机上的所有用户访问。无论是作为服务安装还是以用户模式安装机器人,此参数皆适用。

对于服务模式机器人,包同时为所有用户安装。

请注意,对于同一台计算机上安装的多个用户模式机器人,包文件夹不得相同(如 C:\Packages)。这是因为下载并安装包的第一个用户模式机器人会将 .XAML 文件访问权限限制为仅供该用户使用,从而使该计算机上的其他用户模式机器人因权限不足而无法使用相应的文件夹或包。
如果不提供此参数,则默认文件夹是 %userProfile%\.nuget\packages

对于 Windows Server 计算机(启用并发执行 - 高密度机器人)上的安装,您必须提供特定于每个用户的路径。阅读更多关于为多个机器人使用相同路径的信息。

可以使用 %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^%

有关如何在安装后更改包的下载文件夹的信息,请参阅 管理活动包

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 选项),则支持使用此参数。

TELEMETRY_ENABLED

允许您禁用使用情况数据收集,并且可以在 Studio 和机器人的安装时完成。

Studio 和机器人默认情况下启用遥测功能,要在安装过程中禁用遥测功能,请对参数使用以下值:

  • TELEMETRY_ENABLED=0
注意:这将禁用 Studio 和机器人的遥测功能。

如果要重新启用遥测,请使用以下值:

  • TELEMETRY_ENABLED=1

有关使用情况数据收集以及如何更改遥测设置的更多信息,请参阅选择退出遥测文档。

ENABLE_PIP

允许您在 UiPath 命令行安装过程中启用计算机的画中画功能。

要启用它,请使用以下参数:

  • ENABLE_PIP=1

示例:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENABLE_PIP=1

示例

编写这些示例时,我们假设您已处于 UiPathStudio.msi 安装程序所在的目录中。您可以使用以下命令来完成此操作,例如:cd D:\UiPathInstaller
  • 将 Studio、机器人安装为 Windows 服务和活动包 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages
  • 以用户模式安装 Studio 和机器人 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot
  • 静默安装整个桌面套件 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,StartupLauncher,JavaBridge /Q
  • 通过策略静默安装整个桌面套件和 Chrome 扩展程序 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,ChromeExtension CHROME_INSTALL_TYPE=STORE /Q
  • 将 Studio、机器人静默安装为 Windows 服务和活动包,并且全部安装在 D:\UiPath 文件夹中 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages APPLICATIONFOLDER=D:\UiPath /Q
  • 将机器人静默安装为 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,Packages CODE=1234567890 /Q
  • 将机器人安装为 Windows 服务,并禁用官方在线订阅源 - UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
  • 命令行参数描述
  • 示例

此页面是否有帮助?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath 白色徽标
信任与安全
© 2005-2024 UiPath. All rights reserved.