Robot
2024.10
true
Robot User Guide
Last updated Jul 15, 2024

UiPathRobot.msi Command Line Parameters

You can install the Robot by running the UiPathRobot.msi installer from the command line.

See the following sections for descriptions of the available parameters and a few usage examples.

Note:
  • Administrator rights are required to execute these commands.
  • Using the /passive option of msiexec.exe to run an unattended installation is not supported.

Command Line Arguments Descriptions

The following table lists all available command line parameters.

When entering paths, consider the following:

  • If you need to use environment variables such as %USERNAME% or %USERPROFILE%, the % special character needs to be escaped as follows:
    • When the setup is invoked from Command Prompt, use ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
    • In batch scripts, use ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
    • In PowerShell console or scripts - no escaping is needed.
    • When using Active Directory domain accounts, it is recommended to specify the domain name in the folder structure too, such as C:\packages\^%UserDomain^%.^%Username^%.
  • If you need to use paths with spaces, they must be wrapped as follows:
    • In Command Prompt, surround with double quotes (" "). For example, UiPathRobot.msi APPLICATIONFOLDER="C:\folder name".
    • In PowerShell, surround with single and double quotes ('" "'). For example, ./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'.

Command

Description

/q

Helps you install the specified UiPath® features silently, without displaying the user interface.

/l*vx <LogFile>

Generates an installer log file at the specified path. Starting with v2018.4.2, this file can also include licensing information if you license Studio or Robot at install time.

You can send the file further to our support team if, for any reason, you encounter difficulties during the installation process.

ADDLOCAL

Enables you to select what features to install. If ADDLOCAL is used, only the features specified in it are installed. If ADDLOCAL is not used, the following features are installed: the Robot in service mode, the activities packages, and the JavaScript add-on.

It supports the following options:

DesktopFeature - indicates that you want to install the Robot feature.
Robot - Installs the Robot in user mode or service mode, as well as the Assistant. It cannot be used without DesktopFeature.
  • To install the Robot in service mode, also add the RegisterService option. This is the recommended choice for unattended Robots.
  • To install the Robot in user mode, do not add the RegisterService option. This is the recommended choice for attended and development Robots.
Note: If you convert the Robot from service mode to user mode, the Robot might not be able to access the .xaml files from the original NuGet Packages folder. For details on how to resolve this, see the NuGet packages not accessible after migration troubleshooting article.
StartupLauncher - Runs the Robot at Windows startup. It cannot be used without the Robot argument.
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 Robot argument.
ChromeExtension - Installs the UiPath® Google Chrome Extension. It cannot be used without the Robot argument.
FirefoxExtension - e.g. : UiPathRobot.msi ADDLOCAL=Robot,ChromeExtension,FirefoxExtension /Q
EdgeExtension - Installs the UiPath Microsoft Edge Chromium-based Extension. It cannot be used without the Robot argument.
CitrixClient - Installs the UiPath® Citrix Client Extension. It cannot be used without the Robot argument.
JavaScriptAddOn - Installs the Browser Embedding add-on for robot.
VMwareExtension - Installs the UiPath® Extension for VMware Horizon. It cannot be used without the Robot argument.
WindowsRdpExtension - Installs the UiPath® Extension for Microsoft Remote Desktop. It cannot be used without the Robot argument.

MSIINSTALLPERUSER

Enables you to install only for the current user. To install per user, add MSIINSTALLPERUSER=1. To install per machine, do not include this parameter.

The following options are not available in per-user installations: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.

APPLICATIONFOLDER

Enables you to install the Robot in a custom location.

NUGET_OPTIONS

This parameter is recommended if you are working in an offline environment. If set to DisableOnlineFeeds, this parameter helps you disable the online UiPath® official and Community feeds for the Robot - only the Orchestrator and local feeds are taken into consideration.

Please note that the URL feeds are not deleted from the configuration files, just ignored.

It can be used for both installations and upgrades.

PACKAGES_FOLDER

Enables you to change the download location of your workflows and their dependencies for Studio and/or Robot. This folder can be user specific or accessible by all users from a machine. This parameter can be used for both service mode or user mode robots. If you do not provide this parameter the default folder is %userProfile%\.nuget\packages.
Note: When changing the packages folder, make sure that all the users that need to execute processes have read access to this folder.
Note: When using the PACKAGES_FOLDER parameter, there are some limitations. Find out more in the custom package folders and network paths documentation.
  • 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.

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

CUSTOM_NUGET_FEEDS

Enables you to add custom NuGet activities feeds for Studio and/or Robot. This command only adds or updates the existing list of feeds.

It must be populated with key-value pairs of type string. Valid locations include online feeds, folder paths, and shared network drives. Make sure that the provided feeds are reachable by all users from a given machine. Separate feeds with semicolons (;).

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

ENFORCE_SIGNED_EXECUTION

Optional. Enables you to enforce your Robots to execute only signed packages. It can be used at clean installs or updates of your instances. If this parameter is not specified at deploy-time, package signing is not enabled.

It supports the following options:

  • 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 - No package signing rule is enforced on your Robot deployment.

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

CODE

Licenses your Robot instance.

CLIENT_ID and CLIENT_SECRET

Automatically connects the Robot to Orchestrator using client credentials while also installing it.

Example: UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k

CHROME_INSTALL_TYPE

Allows you to choose the installation method for the Chrome extension. This parameter requires the installer to run with admin rights. If it's omitted, the most appropriate installation method is selected automatically.

It supports the following options:

  • POLICYOFFLINE - The Chrome Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the /Chrome-Policy-Offline command using the SetupExtensions tool.
  • POLICYONLINE - The Chrome Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the /ChromePolicyGlobal command using the SetupExtensions tool.
  • MANUALPERMACHINE - The Chrome Extension is installed for all users, the equivalent of calling the /ChromeGlobal command using the SetupExtensions tool.
  • NATIVEHOSTONLY - Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the /ChromeNativeHostGlobal command using the SetupExtensions tool.
Note: The old installation methods names (STORE, GLOBAL) are kept for backwards compatibility.

EDGE_INSTALL_TYPE

Allows you to choose the installation method for the Edge extension. This parameter requires the installer to run with admin rights. If it's omitted, the most appropriate installation method is selected automatically.

It supports the following options:

  • POLICYOFFLINE - The Edge Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the /Edge-Policy-Offline command using the SetupExtensions tool.
  • POLICYONLINE - The Edge Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the /Edge-Chromium-PolicyGlobal command using the SetupExtensions tool.
  • MANUALPERMACHINE - The Edge Extension is installed for all users, the equivalent of calling the /Edge-Chromium-Global command using the SetupExtensions tool.
  • NATIVEHOSTONLY - Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the /Edge-Chromium-NativeHostGlobal command using the SetupExtensions tool.
Note: The old installation methods names (STORE, GLOBAL) are kept for backwards compatibility.

DISABLE_SECURE_XAML

Allows you to disable security of XAML files for Robots installed as a Windows service. Unsecured XAML files allow users to read and modify the process files and logic.

It supports the following options:

  • 0 - The default option. When used, it enables security for XAML files for Windows service Robots.
  • 1 - Disables security for XAML files for Windows service Robots.
Note: This parameter can only be used during a clean install or an update.

SERVICE_URL

Allows you to define the URL of the Orchestrator instance users will connect to using Interactive Sign-In.

The provided URL is saved in the uipath.config file, and it's only saved for user-mode Robots. For service-mode installations, the argument is ignored.
When running the installer to update from an older version or change your existing installation, this parameter is supported if you are switching the Robot from service mode to user mode (the RegisterService option is not included).

ORCHESTRATOR_URL

In a clean installation, you can specify the main Orchestrator URL, used for retrieving auto-update information (e.g. https://orchestrator.local/organizationName/tenantName).

TELEMETRY_ENABLED

Allows you to disable the usage data collection and can be done at install time for the Robot.

Telemetry is enabled by default for Studio and Robot. To disable it, use the following value for the parameter whenever you perform a clean installation or an update:

  • TELEMETRY_ENABLED=0

If you want to enable telemetry, do not include the parameter, or include it with the following value:

  • 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

Allows you to enable the Picture in Picture functionality of the machine during the UiPath® command-line installation.

To enable it, use the following parameter:

  • ENABLE_PIP=1

Example:

UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ENABLE_PIP=1

INSTALLER_LANGUAGE

Enables you to select the display language of the installer. If not specified, the language settings in Windows determine the installer language. To specify the language, enter the parameter INSTALLER_LANGUAGE=<language_code>. The following options are available:
  • Chinese (Simplified): INSTALLER_LANGUAGE=2052
  • French: INSTALLER_LANGUAGE=12
  • German: INSTALLER_LANGUAGE=7
  • Japanese: INSTALLER_LANGUAGE=17
  • Korean: INSTALLER_LANGUAGE=1
  • Portuguese (Portugal): INSTALLER_LANGUAGE=22
  • Portuguese (Brazil): INSTALLER_LANGUAGE=1046
  • Russian: INSTALLER_LANGUAGE=25
  • Spanish (Spain): INSTALLER_LANGUAGE=10
  • Spanish (Mexico): INSTALLER_LANGUAGE=2058
  • Turkish: INSTALLER_LANGUAGE=31
ASSISTANT_OPTIONSAllows you to specify whether to enable or disable the Marketplace widget for Assistant.
  • To enable the widget, use ASSISTANT_OPTIONS=EnableMarketplace or do not include the parameter.
  • To disable the widget, use ASSISTANT_OPTIONS=DisableMarketplace.
ORCHESTRATOR_AUTO_SIGNINIf you install the attended robot in user mode and your environment is configured to use SSO with Azure Active Directory, this enables automatic sign-in to your account. This parameter must be used together with ORCHESTRATOR_URL.
To enable this option, use ORCHESTRATOR_AUTO_SIGNIN=1
PROXY_SCRIPT_ADDRESS

The address of the script that determines how and when to use the proxy. Should contain the URI of the script file, for example, http://localhost/proxy.pac.

Note:
  • If you use this parameter, do not use other proxy-specific parameters.

  • When all parameters are present in the UiPath.config file, only the ScriptAddress key is used.

PROXY_ADDRESS

To be used together with:

  • PROXY_BYPASS_LOCAL_ADDRESS

  • PROXY_BYPASS_LIST

Or with:

  • PROXY_USER_NAME

  • PROXY_PASSWORD

  • PROXY_DOMAIN

The address of the proxy server, either IP or domain name. For example, http://my.proxy.net:8008.

PROXY_BYPASS_LOCAL_ADDRESS

To be used together with:

  • PROXY_ADDRESS

  • PROXY_BYPASS_LIST

Allows direct connection for local addresses, bypassing the proxy server.

Set it to 1 to bypass the local address, or to 0 otherwise.

PROXY_BYPASS_LIST

To be used together with:

  • PROXY_ADDRESS

  • PROXY_BYPASS_LOCAL_ADDRESS

The list of addresses that connect directly to the internet, bypassing the proxy server. Should contain RegExr strings that contain the URIs of servers to bypass. For example, "server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}".

PROXY_USER_NAME

Requires PROXY_PASSWORD.

The username credential for proxy server authentication.

PROXY_PASSWORD

The password associated with the username for proxy server authentication.

PROXY_DOMAIN

The domain where the proxy server resides, required for authentication.

Performing a Synchronous Installation

If you want to make additional configurations after the installation is completed, you can run the installer synchronously. This enables you to add other commands to be performed after the installer finishes, For example, you can install and also set up a robot connection or configure feeds.

The following scripts perform the installation and enable you to add other commands to be performed if the installation is successful.

:: Runnning the MSI synchronously
start /wait /b UiPathRobot.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"
):: Runnning the MSI synchronously
start /wait /b UiPathRobot.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"
)

Examples

These examples have been written considering that you are already in the directory in which the UiPathRobot.msi installer is located. You can do this with the following command, for example: cd D:\UiPathInstaller.
  • Install the Robot in user mode only for the current user - UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Robot
  • Silently install the Robot - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,StartupLauncher,JavaBridge /Q
  • Silently install the Robot and the Chrome Extension via policy - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
  • Silently install the Robot as a Windows service and connect it to Orchestrator -

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

  • Silently install the Robot as a Windows service, and add two custom activity feeds - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
  • Silently install and license a Robot registered as a Windows service and the local activity feed - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,CODE=1234567890 /Q
  • Install Robot as a Windows service, and disable the official online feeds - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
  • Uninstall the Chrome Extension - UiPathRobot.msi REMOVE=ChromeExtension /Q
  • Set up the auto-update connection during attended robot installation -

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

  • Set up the auto-update connection during unattended robot installation -

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

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.