Command line
The general command line syntax for Snow Inventory Agent for Windows is:
snowagent.exe [options] [<command> [<arguments>]]
Global options
Global option | Description |
---|---|
-w <dir> | Override working directory otherwise inherited from shell/environment |
-v | Enable verbose mode, bump all logging to max level (enable all tags) |
-c <dir> snowagent.config | Read 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 -h | Print help text and exit |
Commands
Command | Description |
---|---|
copyright | Show copyright notice |
legacycleanup | Uninstall any existing Snow Inventory Client for Windows 3.x |
manifest | Print the manifest in JSON format and exit |
scan | Scan 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. |
send | Send files from the data directory. Files that are successfully sent are deleted |
start | Start (if not running) a service or daemon |
stop | Stop any running service or daemon |
test | Run a self-test. Check configuration and server connectivity, then exit with a 0 (if successful) otherwise with a non-zero exit code |
update | Check for updates now, and install if any are found.
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. |
version | Print 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.
Command | Description |
---|---|
sc control SnowInventoryAgent5 128 | Performs a full scan and then sends the data. |
sc control SnowInventoryAgent5 129 | Sends data. |
sc control SnowInventoryAgent5 130 | Requests an update from a Snow Inventory endpoint. |
sc control SnowInventoryAgent5 131 | Performs a full scan without sending the data. |
sc control SnowInventoryAgent5 132 | Aggregates and sends metering data only (without performing a full scan). Can be used in virtual environments during logoff. |