Command Line Interface step

  1. Click Command Line Interface to add the Command Line Interface step to your automation.

  2. Click the header to enter a name for the step.

  3. Type the Command Line Message(s) that should be executed at the command line as part of this automation.

  4. Set the Timeout for this step's operation, in seconds. The default is 5.

  1. Click </>.

  2. Click to return to edit mode.



You can optionally set conditions that will determine whether this step should be executed.

  1. Click to expand Conditional .

  2. Click Query condition.

    A menu with a list available conditional query options displays.

    1. Select an option, type a value, and click .

    2. Comparison operators control conditional matching. Click the comparison operator to open a menu to select a different operator.

    3. Click in the Query condition text box again to add additional query options.

    1. By default, the step will run if the query conditions are met, and will be skipped if the conditions are not met. To change the default behavior:

      1. Click Then Run, Otherwise Skip >.

      2. For Then, click to select an action to be performed when the query conditions are met:

        • If Goto step is selected, click Select a step name... and select the name of the step.

          Note To use the Goto step functionality, you must enter a name for steps during configuration of the step.

        • (Optional) If Exit, Abort, or Skip are selected, for Optional reason, type a message that will appear in the run details.

      3. For Otherwise, click to select an action to be performed when the query conditions are not met.

Comparison operators

Operator Matches if the current value of the query option...
contains Contains the value entered in the Query condition text box.
< Is less than the value entered in the Query condition text box.
<= is less than or equal to the value entered in the Query condition text box.
<> Does not equal the value entered in the Query condition text box.
= Equals the value entered in the Query condition text box.
> Is greater than the value entered in the Query condition text box.
>= is greater than or equal to the value entered in the Query condition text box.
endswith Ends with the value entered in the Query condition text box.
startswith Begins with the value entered in the Query condition text box.

Advanced Options allow you to configure what actions to take when the step produces an error, and what actions to take when the step has completed successfully.

  1. Click Advanced Options.

  2. Enable Wait if Offline to allow this step to be queued while the device is offline and completed the next time it connects. Any actions that can be taken while the device is offline, will still be taken.

  3. Click On Error to select what should happen when the step produces an error:

    • End: The automation will end when this step produces an error.

    • Continue: The automation will proceed to the next step when this step produces an error.

    • Retry: The automation will retry the step when it produces an error.

      • Select the number of times to retry the step. If the step does not succeed within the selected number of times, the automation will end.

  4. Enable On End to select an action that should happen when the step ends:

    1. Select whether the on end action should take place Always, When successful, or When errored.

    2. Select an action, either:

      • Goto step: click Select a step name... and select the name of the step.

        Note To use the Goto step functionality, you must enter a name for steps during configuration of the step.

      • Exit

      • Abort