Command Line Arguments



ISL AlwaysOn is controlled through command line parameters. When installing ISL AlwaysOn through product pages, the same parameters are used as a whole command line in the CGI parameter cmdline.

Important: These command line arguments are discarded when passed to push upgrade of ISL AlwaysOn from ISL Conference Proxy, so you cannot use them when doing a push upgrade. They are also not used when ISL AlwaysOn management dialog or setup is started from a non-admin or non-system account. In order to allow the ISL AlwaysOn management dialog (and use command line arguments) under system account please add the command line option ignore_system_account.

An example of a valid URL is the "Add this computer" button on the remote access tab after you login to your ISL Online account.

If you right-click on that button (marked with red in the screenshot below) and copy the link, then paste it into a text editor, you will be able to inspect it and use it as a starting point for constructing a custom link for the desired customized installer.

That link looks like this:


  • GRANTBLOB is your unique grant blob - this is the part of the link that tells the program which user to add this computer to. Wherever you see a reference to a blob or grant blob in examples below, replace it with the appropriate value for your case.
  • USERCODE is a customization identifier, basically it tells the program to check if there are any default customizations set for your user and use it.

We can now proceed to the list of available parameters and their syntax.

Command Line Arguments

 Installer will not display the wizard and the background window.
Note: The setup will not be started if ISL AlwaysOn is already installed on that computer.
 Installer will not display the wizard and the background window. The installation progress window will not be shown as well.
Note: The setup will not be started if ISL AlwaysOn is already installed on that computer.
password <default password>
Set the Main Access Password of the computer if the password has not been set yet.
description <computer description>
Specify the description of the computer. Description text can also specify environment variables that are available to ISL AlwaysOn process and some additional variables. Variables have the following for $[<variable-name>]:
  • name (computer name as it would be seen in ISL AlwaysOn web page without "description" command line option) (e.g. description "My PC - $[name]")
  • system variables:
    • You can access any environmental variable on the computer, on Windows machines they can be listed with command set in the command prompt and on Linux machines they can be listed using envcommand in the terminal. Some examples:
      • $[OS] - Windows - OS version of the Windows machine
      • $[USERNAME] - Windows - Username of the user registering the AON computer
      • $[LOGNAME] - Linux - Username of the user registering the AON computer
      • example: description "PC - $[OS] - $[USERNAME]" will be shown as PC - Windows_NT - User 
Note: When using system variables in computer Name/Alias field be aware that environmental variables could potentially contain sensitive information you might not want to appear in the application.
tags "tag1, tag2, tag3"
Comma separated tags which should be added to the computer and are accessbile when viewing the computer list.
push_upgrade (true|false)
Enable or disable automatic software updates initiated from the ISL Conference Proxy server - this options is useful for corporate environments where administrator wants to update multiple computers simultaneously.
record <path to recordings>
Specify the session recordings folder. When an ISL Light session is recorded the recordings will be placed in the specified folder.
Specifying the shutdown parameter will stop all ISL AlwaysOn services on the local computer. Use shutdown_silent to disable user interaction.
grant_password <connection_password>
Define a new granted Connection Access Password. This option is used together with the option grant_silent.
Specify this option to allow the ISL AlwaysOn management dialog (and use of command line arguments) when running the executable from a non-privileged account.
Upgrade the ISL AlwaysOn program first and then perform actions that are specified with parameters.
share <path>
Option share is used to add a shared folder - during installation, a dialog for adding a new file share will pop up, with the provided location already entered, allowing you to set the authentication and access parameters, then confirm it by clicking OK.

Steps for preparing a custom executable

These are general steps that need to be done:

  1. Get the default link for granting access to your user as described in the introduction section above, this will be your starting point.
  2. Make a list of the desired command line arguments that you wish to use (check the syntax section).
  3. URL-encode your command line arguments from the previous step. You can use any URL-encoding page, but we also have a page for this purpose: Link for URL encoding
  4. Insert the command line arguments before the grant+%22GRANTBLOB%22 part of the link replace grant with grant_silent if desired.

NoteTo ensure the command line arguments are passed and handled correctly the grant GRANTBLOB argument should be the last part of the generated link. So the link should have the following form: <basic link>+"?cmdline"+<command line parameters>+"=grant"<GRANTBLOB>


The following example will show you how to create a silent installer which could be used for deployment:

  1. Following the instructions we have obtained a link that looks like this:
  3. Let us say we want to use the following command line parameters: /VERYSILENT password "topsecret" description "test $[name] - $[nifs] - $[mac]"
  4. We encode them using our URL encoder and get the following result: %2FVERYSILENT+password+%22topsecret%22+description+%22test+%24%5Bname%5D+-+%24%5Bnifs%5D+-+%24%5Bmac%5D%22
  5. Now we need to add these encoded arguments to our link. The easiest way to do it is to insert them at the beginning of the cmdline part and add a trailing + (encoded space), so we get this:
  6. Since we want to make a completely silent installer for deployment purposes, we will replace grant with grant_silent. This is the end result:

Connect to computer using command line arguments

It is possible to connect to remote computer with specific options to be passed to ISL Light 4.0.4+.

Please see the command line argument page in the ISL Light manual for more information on what can be used with ISL Light.

The command to be used for connecting to an unattended remote computer is --stream-options. Below table shows the parameters that can be passed.

--stream-options <options> (ISL Light 4.0.4+)
Disable or enable specific stream options when connecting to an ISL AlwaysOn computer using command line arguments. Users can specify the following options:
_download_client=false (disable/enable downloading of ISL Light Client, ISL Light fast will be used - false/true)
small_foot=false (disable/enable small footprint GUI on remote computer - false/true)
total_control=false (disable/enable total control option - option to disable/enable user to use keyboard and mouse - false/true)
black_screen=false (disable/enable black screen once connected to remote computer - false/true)
leave_background=false (disable/enable remote desktop background when connected - false/true)
stream_high_color=false (disable/enable remote computer to stream in high color - false/true)
minimized_client=false (disable/enable minimising of ISL Light client on remote side once connected to computer - false/true)
User defined stream options can also be disabled here
Tags: isl alwayson, customization, command line arguments, url, syntax, custom executable

Was this article helpful?