- Release Notes
- Getting Started
- Setup and Configuration
- Automation Projects
- Dependencies
- Types of Workflows
- File Comparison
- Automation Best Practices
- Source Control Integration
- Debugging
- The Diagnostic Tool
- Workflow Analyzer
- About Workflow Analyzer
- ST-NMG-001 - Variables Naming Convention
- ST-NMG-002 - Arguments Naming Convention
- ST-NMG-004 - Display Name Duplication
- ST-NMG-005 - Variable Overrides Variable
- ST-NMG-006 - Variable Overrides Argument
- ST-NMG-008 - Variable Length Exceeded
- ST-NMG-009 - Prefix Datatable Variables
- ST-NMG-011 - Prefix Datatable Arguments
- ST-NMG-012 - Argument Default Values
- ST-NMG-016 - Argument Length Exceeded
- ST-DBP-002 - High Arguments Count
- ST-DBP-003 - Empty Catch Block
- ST-DBP-007 - Multiple Flowchart Layers
- ST-DBP-020 - Undefined Output Properties
- ST-DBP-023 - Empty Workflow
- ST-DBP-024 - Persistence Activity Check
- ST-DBP-025 - Variables Serialization Prerequisite
- ST-DBP-026 - Delay Activity Usage
- ST-DBP-027 - Persistence Best Practice
- ST-DBP-028 - Arguments Serialization Prerequisite
- ST-USG-005 - Hardcoded Activity Arguments
- ST-USG-009 - Unused Variables
- ST-USG-010 - Unused Dependencies
- ST-USG-014 - Package Restrictions
- ST-USG-020 - Minimum Log Messages
- ST-USG-024 - Unused Saved for Later
- ST-USG-025 - Saved Value Misuse
- ST-USG-026 - Activity Restrictions
- ST-USG-027 - Required Packages
- ST-USG-028 - Restrict Invoke File Templates
- Variables
- Arguments
- Imported Namespaces
- Recording
- UI Elements
- Control Flow
- Selectors
- Object Repository
- Data Scraping
- Image and Text Automation
- Citrix Technologies Automation
- RDP Automation
- Salesforce Automation
- SAP Automation
- VMware Horizon Automation
- Logging
- The ScreenScrapeJavaSupport Tool
- The WebDriver Protocol
- Test Suite - Studio
- Extensions
- Troubleshooting
Studio User Guide
Command Line Parameters
UiPathStudio.msi
or UiPathStudioCloud.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.
- Changing an existing installation by running the installer from the command line in silent mode is not supported. However, you can run the installer in silent mode to update from an older version.
- Using the
/passive
option of msiexec.exe to run an unattended installation is not supported.
The following table lists all available command line parameters.
All parameters can be used for clean installations, but only the following are supported when updating from an older version or changing an existing installation:
- Enabling / disabling features using
ADDLOCAL
. Please note that the Robot cannot be disabled. SERVICE_URL
- available when switching the Robot from service mode to user mode by not including theRegisterService
argument.-
NUGET_OPTIONS
,ENFORCE_SIGNED_EXECUTION
,DISABLE_SECURE_XAML
, andTELEMETRY_ENABLED
- not available for changing existing installations.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. IfADDLOCAL
is used, only the features specified in it are installed. IfADDLOCAL
is not used, the following features are installed: Studio, 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 Robot and Studio features.Studio
- Installs Studio.ExcelAddin
- Installs the StudioX Excel Add-in. It cannot be used withoutStudio
.Robot
- Installs the Robot in user mode or service mode, as well as the Assistant.- 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.Packages
- Installs the activities packages. It cannot be used without theDesktopFeature
andRobot
arguments.StartupLauncher
- Runs the Robot at Windows startup. It cannot be used without theDesktopFeature
andRobot
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 theDesktopFeature
andRobot
arguments.ChromeExtension
- Installs the UiPath Google Chrome Extension. It cannot be used without theDesktopFeature
andRobot
arguments.EdgeExtension
- Installs the UiPath Microsoft Edge Chromium-based Extension. It cannot be used without theRobot
argument.CitrixClient
- Installs the UiPath Citrix Client Extension. It cannot be used without theDesktopFeature
andRobot
arguments.JavaScriptAddOn
- Installs the Robot JavaScript add-on to support the Robot JavaScript SDK.SapPlugin
- Installs the SAP Solution Manager plugin. Requires the SAP Connector for Microsoft to be installed on your machine. On clean installs, you must also provide an address for the instance using theSAP_SOL_MAN_HOST
parameter. It cannot be used withoutStudio
.MSIINSTALLPERUSER
This parameter enables you to install Studio and Robot either per user or per machine.
If the parameter is not included, the installation is per machine. If you addMSIINSTALLPERUSER=1
, the installation is per user.The parameters is usable only when performing a clean installation.
SAP_SOL_MAN_HOST
Hostname or IP address for your SAP Solution Manager instance. Required for clean installs if theSapPlugin
argument was provided for theADDLOCAL
option.For exampleUiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address
APPLICATIONFOLDER
Enables you to install Studio and Robot in a custom location.
NUGET_OPTIONS
This parameter is recommended if you are working in an offline environment. If set toDisableOnlineFeeds
, 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.Note: TheNUGET_OPTIONS
parameter does not disable the online UiPath official and Community feeds for Studio.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 and 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 thePACKAGES_FOLDER
parameter, there are some limitations. For more information, see Custom Package Folders and Network Paths.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 -
UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%
. - In batch scripts - use
%
-UiPathStudio.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^%
. - 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.
Note: When using thePACKAGES_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.
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 thenuget.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 Studio instance.
CONNECTIONSTRING
Automatically connects the Robot to Orchestrator on-premises using the connection string while also installing it. Please note that the following are required:
- the
WindowsAuth.Enabled
parameter from theUiPath.Orchestrator.dll.config
file has to be set totrue
- the
WindowsAuth.Domain
parameter has to be set to a valid domain - the Service Mode Robot
- a Standard Machine configuration has to be in place.
Note: Automatic enrollment with standard machines using theCONNECTIONSTRING
can only be used with Orchestrator v2020.10.CHROME_INSTALL_TYPE
Automatically installs the Chrome Extension via policy.
It supports the following options:
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
Allows you to disable security ofXAML
files for Robots installed as a Windows service. UnsecuredXAML
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 forXAML
files for Windows service Robots.1
- Disables security forXAML
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 theuipath.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 (theRegisterService
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 Studio and Robot.
Note: This parameter can only be used during a clean install or an update.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
Note: This disables telemetry for both Studio and Robot.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:
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENABLE_PIP=1
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, useORCHESTRATOR_AUTO_SIGNIN=1
.ENFORCE_DEFAULT_SERVICE_URL
For user-mode installations, this parameter enforces the default service URL.
To enable this option, useENFORCE_DEFAULT_SERVICE_URL=1
.ORCHESTRATOR_URL
must also be enabled. - To install the Robot in service mode, also add the
UiPathStudio.msi
installer is located. You can do this with the following command, for example: cd D:\UiPathInstaller
.
- Install Studio, a Robot as a Windows service and the activities packages -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages
- Install Studio and a Robot in user mode only for the current user -
UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Studio,Robot
- Silently install the entire Desktop suite -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,StartupLauncher,JavaBridge /Q
- Silently install the entire Desktop suite and the Chrome Extension via policy -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,ChromeExtension CHROME_INSTALL_TYPE=STORE /Q
- Silently install Studio, the Robot as a Windows service and the activities packages, all in the
D:\UiPath
folder -UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages APPLICATIONFOLDER=D:\UiPath /Q
-
Silently install the Robot as a Windows service and connect it to Orchestrator -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q
- Silently install Studio, the Robot as a Windows service, and add two custom activity feeds -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1, https://my.custom.nuget.feed; FeedName2, D:\RPA\Activities\Packages\" /Q
- Silently install and license Studio, a Robot registered as a Windows service and the local activity feed -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages CODE=1234567890 /Q
- Install Robot as a Windows service, and disable the official online feeds -
UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds