- Restarting Robot Components
- Windows Sessions
- Login Using Thales Luna Credential System
- Login Using NShield Key Storage Provider
- Redirecting Robots Through a Proxy Server
- Executing Tasks in a Minimized RDP Window
- Using Mapped Network Drives
- Stopping a Process
- Disable Stop Button
- Custom Package Folders and Network Paths
- CrowdStrike Integration
- Robot Citrix Apps Virtualization
- Common Connection Errors
- Unresponsive Robot Over RDP
- Duplicate Execution Logs
- Frequently Encountered Robot Errors
- Increased Process Execution Duration
- Enforced Package Signature Verification
- Message Too Large to Process
- Errors When Running as Administrator
- NuGet Packages Not Accessible After Migration
- User Access Control Prompt and UI Automation Activities
- .NET required during installation
- Assembly Cannot Be Loaded From Network Or Azure File Share
- Activities cannot find .NET Runtime
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.
- 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^%
.
- When the setup is
invoked from Command Prompt, use
- 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"'
.
- In Command Prompt,
surround with double quotes (
Command |
Description |
---|---|
|
Helps you install the specified UiPath features silently, without displaying the user interface. |
|
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. |
|
Enables you to select what features to install. If
It supports the following options:
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.
|
|
Enables you to install only for the current user. To install
per user, add The following options are not available in per-user installations: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE. |
|
Enables you to install the Robot in a custom location. |
|
This parameter is recommended if you are working in an
offline environment. If set to
Please note that the URL feeds are not deleted from the configuration files, just ignored. It can be used for both installations and upgrades. |
|
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
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 information on how to change the download folder for packages after installation, see Managing Activities Packages. |
|
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:
|
|
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:
For information on how to enforce signed execution after installation, see Signing Packages. |
|
Licenses your Robot instance. |
|
Automatically connects the Robot to Orchestrator using client credentials while also installing it. Example: |
|
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:
Note: The old installation methods names (
STORE ,
GLOBAL ) are kept for backwards
compatibility.
|
|
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:
Note: The old installation methods names (
STORE ,
GLOBAL ) are kept for backwards
compatibility.
|
|
Allows you to disable security of It supports the following options:
Note: This parameter can only be used during a clean install or
an update.
|
|
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
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 |
|
In a clean installation, you can specify the main
Orchestrator URL, used for retrieving auto-update
information (e.g.
|
|
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:
If you want to enable telemetry, do not include the parameter, or include it with the following value:
For more information about usage data collection and how to change telemetry settings, see the Opting Out of Telemetry document. |
|
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:
Example:
|
|
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
|
ASSISTANT_OPTIONS |
Allows you to specify whether to enable or disable
the Marketplace widget for
Assistant.
|
ORCHESTRATOR_AUTO_SIGNIN |
If 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
|
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_"