Skip to main content

Command line

The general command line syntax for Snow Inventory Agent for Windows is:

snowagent.exe [options] [<command> [<arguments>]]

Global options

Global optionDescription
-w <dir>Override working directory otherwise inherited from shell/environment
-vEnable verbose mode, bump all logging to max level (enable all tags)
-c <dir> snowagent.configRead the configuration file from the given location instead of the default one.
This should be considered a one-time operation as it does not change other behaviors of the agent.
-data-dir <dir>Override data directory (regardless of configuration)
-log-dir <dir>Override log directory (regardless of configuration)
-? or -hPrint help text and exit

Commands

CommandDescription
copyrightShow copyright notice
legacycleanupUninstall any existing Snow Inventory Client for Windows 3.x
manifestPrint the manifest in JSON format and exit
scanScan the current device and create a snowpack file in the target destination (as set by configuration). This will start a scan regardless of any schedule or other configuration. It will not start a scan if there is a running scan in progress. After the scan has completed the agent will exit. The scan result is not automatically sent.
sendSend files from the data directory. Files that are successfully sent are deleted
startStart (if not running) a service or daemon
stopStop any running service or daemon
testRun a self-test. Check configuration and server connectivity, then exit with a 0 (if successful) otherwise with a non-zero exit code
updateCheck for updates now, and install if any are found.
  • Option: -package <location>
    Function: Use an update package from a specific location
Updates can be provided from Snow Inventory Server or a local .snowpack file.
Note: When updating the snowagent.exe file and JAR files, such as the Snow Inventory Oracle Scanners, the accompanying SIGN file must also be included.
versionPrint the current snowagent version and exit

sc commands

The Windows agent can be triggered by the use of sc, a Windows command. All sc commands are asynchronous.

CommandDescription
sc control SnowInventoryAgent5 128Performs a full scan and then sends the data.
sc control SnowInventoryAgent5 129Sends data.
sc control SnowInventoryAgent5 130Requests an update from a Snow Inventory endpoint.
sc control SnowInventoryAgent5 131Performs a full scan without sending the data.
sc control SnowInventoryAgent5 132Aggregates and sends metering data only (without performing a full scan). Can be used in virtual environments during logoff.