8.2 Initiating a Scan

The Device Scanner CLI can be launched without any arguments, in which case it uses default settings to scan the device and save the scan file. If you want to customize the scan settings, you can distribute a batch or script file that starts the Device Scanner CLI executable with the desired arguments. The following sections explain the command line usage and provide examples:

8.2.1 Usage

zesscancli [/all] [/usb] [/rsd] [/c | /comment] [/f | /filename] [/s | /silent]

The arguments, which are optional, can be placed in any order. You can also substitute a dash (-) for the forward slash (/). For example, /all or -all.

/all: Scans all device types. Stores the results in USB Devices format and Removable Drives format in the scan file. This is equivalent to populating the USB Devices and Removable Drives lists in the Device Scanner application.

/usb: Scans USB devices. Stores the results, including removable storage devices, in USB Devices format only. This is equivalent to populating only the USB Devices list in the Device Scanner application.

/rsd: Scans removable drives. Stores the results in Removable Drives format only. This is equivalent to populating only the Removable Drives list in the Device Scanner application.

/c or /comment: Adds a comment to each scanned device. If no comment is specified, the default is computer\user - device class for USB devices and computer\user for removable drives.

/f or /filename: Saves the scan file with the specified path and filename. You can use any combination of path and filename:

  • Filename only: Saves the file, with the specified filename, to the default directory.

  • Path and filename: Saves the file, with the specified filename, to the specified directory.

  • Path only: Saves the file, with the default filename, to the specified directory. You must append a backslash to the final directory in the path (for example, c:\scanfiles\).

The default filename is zesscan-machine_name-MMddyyyyHHmmssffff.xml and the default path is the Device Scanner CLI executable directory.

/s or /silent: Suppresses error messages.

8.2.2 Examples

Example 1: zesscancli

This scan uses the default settings. All devices are scanned. A default comment (computer\user - device class for USB devices and computer\user for removable drives) is added to each device. The scan data is saved with the default filename (zesscan-machine_name-MMddyyyyHHmmssffff.xml) in the zesscancli executable directory.

Example 2: zesscancli /usb /f myscan.xml

Scans all USB devices and saves the data in USB device format to the myscan.xml file in the zesscancli executable directory.

Example 3: zesscancli -rsd -c "removable drive"

Scans all removable storage devices, adds removable drive as a comment on all devices, and saves the data with the default filename in the zesscancli executable directory.

Example 4: zesscancli /filename s:\scans\ /silent

Scans all devices, suppresses any scanning error messages, and saves the data to the default filename in the s:\scans directory.