Documentation

Execute a program on the target system (Windows only)

Exit code, Running time

Program path

Executable program including its absolute path. This path or specific executable must be allowed in the Run Programs section of the remote WinAgent configuration.

Command line arg.

Command line arguments for the executable.

Timeout

The executable will be terminated after the timeout period, if still running. If set, this timeout overrides the default timeout in the remote WinAgent configuration (Default process timeout).

Execute one instance only

Only one instance of the executable is allowed if checked. If the executable is already on the running program list of the target system, it will not be started again.

Hide window during execution

If this checkbox is set, the WinAgent hides the windows of the executed application.

Suppress running time

If this checkbox is set, the running time of each check is not saved to the database and its value is no longer visible in the values section. Its value is also no longer available for use in alarm limit specifications.

Exit code

The exit code returned by the executable. Usually an exit code of 0 means there were no errors during the execution, however, the exit code depends on the executable.

Running time

The duration of the remote program execution (in s). This value and alarm limit is only available if the Suppress running time parameter is not enabled.

Error code

Generic job error code (see section Job error codes)

C:\Windows\system32\cmd.exe

/C FOR /F %G IN ('wmic service w32time get state /value ^| findstr "State=Running"') Do exit /B 0

%SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe

if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1}