Run Diagnostics on a remote computer or unattended from command line:

The Diagnostic Tool contains functionality to allow silent execution (without user intervention). This can be especially helpful on when you'd like to run the diagnostic utility on a user's machine, but do not want to disturb the user.

These switches can be appended to both the Windows or OSX version from the command prompt or terminal, respectively.

When run without switches, the Umbrella Diagnostic will launch a user interface and, waits for the user to submit information. When running remotely, you almost always want the --silent option.

The following switches can be appended to the command in order to automate the silent execution of the Diagnostic and direct the output:

-d, --domain=VALUE

A specific domain to target with tests (e.g. ProblematicDomain.com)

-s, --silent

Automatically run tests in silent mode (will not show the UI or new windows; defaults to -i output)

-i, --internet

Output all results to diagnostic.opendns.com; destination URL will print to console as 'appspot=URL'

-o, --output=VALUE

Output to a file, which will print to console as 'outputFile=FILE'; can be a full path, make sure to use "quotes" if needed

-c, --console

Output all results to console as text

--erc

Force the Roaming Client tests to be performed even if it's not installed.

--noerc

Skip the Roaming Client tests even if it's installed

-h, -?, --help

Display this usage statement

If run without -o or -c arguments, -i is the default output; meaning there will be a URL shown on the screen. You're expected to copy that URL and send it to Support.

If the utility is run with -o or -c, then -i must be explicitly set if desired as additional output. We would recommend specifying -i in addition to -o or -c when running with those parameters.

You may specify multiple output formats if desired.

Example usage

This command will automatically run the diagnostic, displaying nothing to the user, and includes specific checks for "ProblematicDomain.com". Then, the diagnostic submits results to opendns.appspot.com, and Prints 'appspot=URL' to the command prompt/console with the resulting appspot URL to submit to Support.

UmbrellaDiagnostic.exe --domain=ProblematicDomain.com --silent

This command automatically runs the diagnostic, displaying nothing to the user. The diagnostic then creates an output file at C:\windows\temp\diag.txt on the machine local to the diagnostic tool.