Common Command Line Options

By default, the following options apply to coverage collection for IIS applications. To collect coverage for desktop applications, specify Command Line Options for Desktop Applications.

`-register`

Registers the coverage service port.

`-unregister`

Unregisters the coverage service port.

`-coverageDataDir <path>`

Specifies the path to the coverage data output directory.

`-uninitialize`

Restores the original web server environment and settings when errors occur.

`-scope <path>`

Specifies the path to the coverage scope configuration file. It is required if the scope is different from the default.

`-port <port number>`

Specifies the port number to use when starting the coverage agent if the default port is unavailable.

`-skipValidation`

Enables using a self-signed SSL certificate.

`-useSsl`

Enables connecting via HTTPS.

`-connectionTimeout <seconds>`

Specifies the timeout for a connection with the coverage agent. The default value is 2 seconds.

If you provide 0 or a negative value, the connection attempt will not timeout, which may lead to a considerable slowdown or cause the tool to hang indefinitely.

`-certificateHash <SSL certificate hash>`

Specifies the hash of the SSL certificate for the port that is used by the coverage agent.

`-certificatePath <path>`

Specifies the path to a PFX file that stores the SSL certificate.

`-certificatePassword <password>`

Specifies the password for the SSL certificate stored in a PFX file.

`-maxCoverableLines <max number of lines>`

Specifies a limit for the number of lines that can be covered.

`-multiUser`

Enables collecting coverage information for multiple users. By default coverage information is collected for a single user.

`-skipRegistration`

Enables running the application without registering the coverage service port. It is assumed that the port is already registered. This option allows running the application without admin privileges.

`-removeCertificate`

Removes the SSL certificate when the port is manually unregistered with the -unregister switch.

`-displayAppId`

Prints the 'appid' of the dotTEST IIS Manager.

`-appLocationInclude <path>`

Specifies the path to a file or directory containing application assemblies. This path is used to calculate checksums — either for each method within the assemblies, or for the entire application. Ant-style wildcards can be used to specify patterns. Alternatively, you can specify a .lst file containing a list of paths or patterns (each line in the file will be treated as a single entry).

`-appLocationExclude <path>`

Narrows the scope defined by the -appLocationInclude property by excluding specified items.

`-flushing <seconds>`

Specifies the frequency at which collected coverage data is written to disk. This setting is enabled by default with a value of 10 seconds. To update the interval, set a value greater than 1 second. To disable data flushing, set the value to 0 or less.

`-nonInteractive`

Disables all user input in the command line interface after the application starts.

`-help`

Displays the command-line help.

Command Line Options for Desktop Applications

`-app <path>`

Specifies the full path to the tested application for which coverage will be collected.

`-workingDir <path>`

Specifies the path to the working directory.

`-appArgs <argument>`

Specifies the application command line arguments.