Skip to main content

Command line

You can scan computers by executing the Agent application Alvao.AgentService.exe from command line.

Parameters​

  • /dd - performs hardware scan of the computer where the Agent is run.

  • /dsw - performs full software scan including files on all hard drives without exceptions.

  • /dssw - performs normal software scan. All scans named above can be started at the same time and the Agent will run them one after another.

  • /f [path] - output folder where the scan files will be saved . If this parameter is not specified, the path specified in the Agent settings (the Settings option after starting the Agent from the Windows Start menu) is used.

  • /l [file] - the agent will generate a log to the file specified after the parameter.

  • /v [number] - logging detail will be set to the specified level (only works with the /l parameter). Levels: 0 = Status and errors, 1 = Normal, 2 = Full.

  • /s - the agent will start covertly, i.e. no information window will be displayed on the screen.

  • /h - a help window for command line parameters will be displayed.

  • /u [parameter-and-value-list] - updates the Agent's parameters in the appsettings.json file and in the C:\Program Data\ALVAO\Asset Management Agent\AgentData.json file. Provide a semicolon-separated list of <parameter-name>=<value> pairs for each parameter that you want to set.

    Example:

    Alvao.AgentService.exe /u "RestApiUrl=https://contoso.onalvao.com/AlvaoRestApi;AuthenticationCode=Password123;RestApiContactIntervalMinutes=120"

    Refer to the configuration files mentioned above for the list of available parameters. If you need to use ";\ characters in a parameter value, escape them with an additional \ character. For example, the value A"B;C\D must be passed as A\"B\;C\\D. The Agent service automatically applies the updated parameters without requiring a restart.

    The /u command-line parameter is available starting from ALVAO version 26.1 Patch.

Output files​

The application generates output files with the .scan extension. The names of files are automatically created by adding the suffix _sw for software scan, _sw_full for full software scan, and _hw for hardware scan after the computer name. For example - output files from a computer PC102 have names: PC102_sw.scan, PC102_sw_full.scan, and PC102_hw.scan.

Example​

Alvao.AgentService.exe /dd /dssw /f D:\Scan

The application performs hardware and normal software scan, and saves the scan files to the D:\Scan folder.