ILSCli - ILS Command Line Interface
pre-condition: your device has the ILSCli installed
If not, see How to download and install ILSCli for more details.
ILS makes all necessary commands available to you via the command line through ILSCli. You can use this for convenient control of your licenses and devices via shell scripts or an interactive shell. Be aware that ILSCli uses the settings from the IlsConfig.json file if you don't supply any options.
Usage
ILSCli is organized hierarchically. Calling ILSCli without any arguments will give you an overview of the usage and the primary commands or better "topics" you can work on. At the time of writing these are
ILSCli device
ILSCli license
ILSCli service
In general, you can append the option "-h", "-?" or "--help" to any of the above calls to get an information about the "subcommands" that are available for the topic, e.g.:
ILSCli device -?
will show you all available subcommands for the topic "device".
The same applies when you go further down the hierarchy by using subcommands such as
ILSCli device info -?
This will display all arguments, options or sub-subcommands (currently none) to the "device info" command.
Overview
Use this as a quick overview of what kind of commands are supported at the time of writing, but stick to the above rules and investigate the commands and options interactively with on of the help-options "-?", "-h", "--help". Not all changes or additions might be documented here.
Working with devices
The device commands look for the settings of the actual device (the device you're working on!) if you don't supply any other options. To query this information, you should first call
ILSCli device determine
This will setup the data for the actual device that will be used as a default from then on.
Determine device identifiers
ILSCli device determine [options]
Used to get all device identifiers for a certain device.
Try
ILSCli device determine -?
for a list of options and their meaning.
Get information about a device
ILSCli device info [-i <path of device file>]
This command will extract information from the actual device you're working on or from the given device file if you use the option "-i".
Add a device
ILSCli device add [-u localhost:5000 -s -i c:\hostinfo.json]
Adds the actual device to the ILS server. If you supply the example options, the device that is defined in c:\hostinfo.json will be added to the ILSServer running https (-s) at "localhost:5000" (-u) with data given in file c:\hostinfo.json (-i).
Get a device list from server
ILSCli device list [-u localhost:5000 -s]
Gets a device list from an ILS server running https (-s) at localhost:5000. If you don't use any options, the server that is setup in the configuration of your actual device will be used.
Working with licenses
See
ILSCli license <command> -?
for a list of arguments and options.
Get information about a license
ILSCli license info -i <path of device file>
This command will extract information from the given license file.
Download a license
ILSCli license download licenskey [options]
Downloads a single license with the given licensekey for the actual device from the server. Use the according options to override the default settings for the actual device.
Download all licenses for a given device
ILSCli license downloadall [options]
Downloads all licenses for the actual device. See the options to override the default behaviour.
Backup a license to local conputer
ILSCli license backup licensekey [options]
A backup license can be restored via "publishing" via ILSCli license publish
.
Publishing a license
ILSCli license publish -u localhost:5000 -s -i c:\licinfo.json
Adds a license to an ILS service running https (-s) at localhost:5000 with data given in file c:\licinfo.json.
Working with service
Get all licenses for an account
ILSCli service licenses -u localhost:5000 -s -i c:\licinfo.json
Get all licenses from an ILS service running https (-s) at localhost:5000 with data given in file c:\licinfo.json.