UiPath Documentation
studio
2020.10
false
Studio 用户指南
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。

命令行参数

命令行参数描述

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

备注:

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

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

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

命令 描述

/q

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

/l*vx <LogFile>

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

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

ADDLOCAL

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

它支持以下选项:

DesktopFeature - 指示要安装机器人和 Studio 功能。

Studio - 安装 Studio。没有 DesktopFeature 便无法使用它。

ExcelAddin - 安装 StudioX Excel 加载项。没有 Studio 便无法使用它。

Robot - 在用户模式或服务模式下安装机器人。没有 DesktopFeature 便无法使用它。

  • 要安装处于服务模式的机器人,请添加 RegisterService 选项。我们为无人值守机器人选择推荐此选项。
  • 要在用户模式下安装 Robot,请不要添加 RegisterService 选项。我们为有人值守和开发机器人推荐该选项。

UseLegacyTray - 安装旧版机器人托盘,而不是 UiPath 助理。

To switch to Assistant after install, run REMOVE=UseLegacyTray.

Packages - 安装活动包。没有 DesktopFeatureRobot 参数便无法使用它。

StartupLauncher - 在 Windows 启动时运行机器人。没有 DesktopFeatureRobot 参数便无法使用它。

JavaBridge - 安装 UiPath Java Bridge,以实现更出色的 Java 应用程序集成和自动化。请注意,安装 Java Bridge 可能会延长安装时间。没有 DesktopFeatureRobot 参数便无法使用它。

ChromeExtension - 安装 UiPath Google Chrome 扩展程序。没有 DesktopFeatureRobot 便无法使用它。

EdgeExtension - 安装基于 Microsoft Edge Chromium 的 UiPath 扩展程序。如果没有 Robot 参数,则不能使用。

CitrixClient - 安装 UiPath Citrix 客户端扩展程序。没有 DesktopFeatureRobot 便无法使用它。

JavaScriptAddOn - 安装机器人 JavaScript 插件以支持机器人 JavaScript SDK。

APPLICATIONFOLDER

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

NUGET_OPTIONS

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

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

它可用于安装和升级。

PACKAGES_FOLDER

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

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

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

如果不提供此参数,则默认文件夹是 %userProfile%\.nuget\packages

For installations on Windows Server machines (that enable concurrent execution - HD Robots), you must provide paths that are specific to each user. Read more about using the same path for multiple robots

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

For information on how to change the download folder for packages after installation, see Managing Activities Packages.

CUSTOM_NUGET_FEEDS

让您可以为 Studio 和/或机器人添加自定义 NuGet 活动订阅源。此命令仅添加或更新现有的订阅源列表。

必须使用字符串类型的键值对来填充。有效的位置包括在线订阅源、文件夹路径和共享网络驱动器。确保提供的订阅源可被给定计算机上的所有用户访问。以分号 (;).分隔多个订阅源

示例:CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"

ENFORCE_SIGNED_EXECUTION

可选。让您可以强制机器人仅执行签名的包。可以在全新安装或更新实例时使用。如果部署时不指定此参数,则不启用包签名。

它支持以下选项:

  • 1 - The Robot is able to download, install, or execute only packages author or repository signed by UiPath. If you want to add your own certificate as a trusted source, you have to do so by modifying the nuget.config file. To learn how to do this, please see this page.
  • 0 - 不在您的机器人部署中实施任何包签名规则。

For information on how to enforce signed execution after installation, see Signing Packages .

CODE

许可您的 Studio 实例。

CONNECTIONSTRING

Automatically connects the Robot to Orchestrator on-premises using the connection string while also installing it. Please note that the following are required:

  • 必须将 UiPath.Orchestrator.dll.config 文件中的 WindowsAuth.Enabled 参数设置为 true
  • 必须将 WindowsAuth.Domain 参数设置为有效域
  • the Service Mode Robot
  • a Standard Machine configuration has to be in place.
Automatic enrollment with standard machines using the connectionstring can only be used with Orchestrator v2020.10.

CHROME_INSTALL_TYPE

通过策略自动安装 Chrome 扩展程序。

它支持以下选项:

  • GLOBAL - The Chrome Extension is automatically installed per system, the equivalent of calling the /ChromeGlobal command using the SetupExtenstions tool.
  • STORE - The Chrome Extension is automatically installed per system via policy, the equivalent of calling the /ChromePolicyGlobal command using the SetupExtenstions tool.

DISABLE_SECURE_XAML

允许为安装为 Windows 服务的机器人禁用 XAML 文件的安全性。未受保护的 XAML 文件允许用户读取并修改流程文件和逻辑。

它支持以下选项:

  • 0 - 默认选项。如果使用,则为 Windows 服务机器人启用 XAML 文件的安全性。
  • 1 - 为 Windows 服务机器人禁用 XAML 文件的安全性。
This parameter can only be used during a clean install or upgrade.

SERVICE_URL

允许您定义用户将使用交互式登录连接的 Orchestrator 实例的 URL。

所提供的 URL 保存在 uipath.config 文件中,并且仅保存为用户模式机器人。对于服务模式安装,该参数将被忽略。

运行安装程序以从较早版本进行更新或更改现有安装时,如果要将 Robot 从服务模式切换到用户模式(不包括 RegisterService 选项),则支持使用此参数。

TELEMETRY_ENABLED

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

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

  • TELEMETRY_ENABLED=0
这将禁用 Studio 和 Robot 的遥测。

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

  • TELEMETRY_ENABLED=1

For more information about usage data collection and how to change telemetry settings, see the Opting Out of Telemetry document.

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

  • 命令行参数描述
  • 示例

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新