Run script

The Run script action allows you to run a script from a local directory or a network path on the device.

General
Type Run script
Name

Actions are easier to comprehend and manage over time when they have a suitable name that accurately expresses what they do.

Script engine The script engine to use when executing the script:
  • Windows only - Batch, VBScript, Windows PowerShell
  • macOS only - Bash, Zsh, AppleScript
  • Windows and macOS - JavaScript, PowerShell (Core)
Script Select the path to the script file that will be executed.
Arguments Insert the arguments for the script file.
Directory Select the working directory.
Advanced
Context The level at which the action is executed, User or Device.
Display The way the process should be started:
  • Normal - the default Microsoft Windows settings are used.
  • Hidden - the application will be launched hidden.
  • Minimized - the application will be minimized at launch.
  • Maximized - the application will be maximized at launch.
Engine arguments Insert the arguments you want to pass to the script engine.
Success return codes The return code(s) that will be evaluated against the set filtering. You can specify multiple return codes by delimiting them with spaces.
Redirect standard output to variable The temporary variable to which the standard output of a command line program is stored. This option is available only if Display is set to Hidden.
Redirect error output to variable The temporary variable to which the standard error of a command line program is stored. This option is available only if Display is set to Hidden.
Place return code in variable The temporary variable to which the return code of a command line program is stored.

Filters
Here you can define conditions which determine if the action will be executed. For more information, see Filters.

In the Edit output variable dialog box you open by clicking on the browse button browse-icon-1x of the Redirect standard output to variable, Redirect error output to variable, Place return code in variable fields, you can create new variables or change existing ones and use them to store the standard output, error output or return code. Note that the resulted variables exist only temporarily until the action is executed; they are not saved anywhere and they are displayed only in the package you configured them. After the action is executed, the variables are discarded.



Edit output variable dialog box

Element Description
Variable New or existing variable in which you want to store information.
Sensitivity
  • Not sensitive - The variable is logged in the log file and it is visible on Liquit Workspace UI.
  • Sensitive - The variable is not logged in the log file and it is hidded on Liquit Workspace UI.
  • Current variable sensitivity - In case of an already existing variable, it takes its already configured sensitivity.
Trim value Removes all whitespace from the front, end or both.
Append to existing value (if it exists) It appends the new variable at the end of the existing one.

Agent

It requires the Agent to be running.

Supported platforms

Platform Supported
Web No
Windows Yes
macOS Yes