How to Use

Server licence users: There is another way of using command line arguments - as a part of a customization. Please refer to this topic for more information.

Command Prompt method

1. Download ISL Light to a directory on your hard drive (we will use c:\isltmp for this example).
2. Click Start - Run.
3. Enter either cmd (Windows 2000 or newer) or command (Windows Me or older) and press enter.
4. Navigate to the directory where you saved ISL Light Desk or ISL Light Client executable:

cd C:\isltmp

5. Start ISL Light with the desired command line arguments, e.g.:

ISLLight.exe --on-load "customization?disable_sessions=true"

Windows Shortcut method

1. Download ISL Light to a directory on your hard drive (we will use c:\isltmp for this example).
2. Right-click on your desktop, select New and then Shortcut.
3. Select the location of the ISL Light executable - for this example, it is c:\isltmp\ISLLight.exe
4. Click Next.
5. You can change the name of the shortcut if you wish and then press Finish.
6. Edit shortcut properties - right-click on the shortcut you created and select Properties.
7.  Append the desired command line arguments in the Target field and click OK.
8. You can run the program by double-clicking the shortcut.

Example of how the Target field in Properties for ISL Light shortcut should look like:

"C:\isltmp\ISLLight.exe" --username \\isl\tim --password demo

URL method

The usual way to start ISL Light is to use the following link:

http://www.islonline.net/start/ISLLight

Server licence users: You should use the following link: http://localhost:7615/start/ISLLight

To add command line arguments, append ?cmdline= to the link and then specify the desired arguments. These arguments need to be URL encoded - you can use our URL encoding page: click here.

Step-by-step example:

1. Let us say we want to use the following command line arguments for ISL Light:

--get-code --username demo --password demo --on-load "customization?disable_computers=true"

2. Copy and paste the command line arguments into our URL encoding page and click URL Encode. Copy and paste the result (URL encoded text):

--get-code+--username+demo+--password+demo+--on-load+%22customization%3Fdisable_computers%3Dtrue%22

3. Append the URL encoded text to the original link, together with the ?cmdline= parameter, and you will have created a working link:

http://www.islonline.net/start/ISLLight?cmdline=--get-code+--username+demo+--password+demo+--on-load+%22customization%3Fdisable_computers%3Dtrue%22

Server licence users: Your link will look like this: http://localhost:7615/start/ISLLight?cmdline=--get-code+--username+demo+--password+demo+--on-load+%22customization%3Fdisable_computers%3Dtrue%22

If you use a more advanced link to start ISL Light, e.g. http://www.islonline.net/start/ISLLight?platform=win32, the procedure is a bit different, since this link already includes parameters (parameters start after the ? sign). You need to use &cmdline= instead of ?cmdline= and then follow it with the URL encoded command line arguments, like in this example:

http://www.islonline.net/start/ISLLight?platform=win32&cmdline=--get-code+--username+demo+--password+demo+--on-load+%22customization%3Fdisable_computers%3Dtrue%22

Server licence users: Your link will look like this: http://localhost:7615/start/ISLLight?platform=win32&cmdline=--get-code+--username+demo+--password+demo+--on-load+%22customization%3Fdisable_computers%3Dtrue%22