Device Properties step

The Device Properties step allows you to update the Remote Manager properties of a device, such as the group that the device is a member of, or device tags. This is helpful to automate device management.

For example, you might create two groups for new devices: Provisional, and Completed. You can then create an automation that runs against all devices in the Provisional group, and when the automation completes successfully for each device, the last step uses the Device Properties step to move the device from the Provisional to the Completed group.

  1. Click Device Properties to add the Device Properties step to your automation.

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

  3. Click Add field to display a list of device properties that can updated.

    • Move to group: Select the group that the device should be moved to.
    • Overwrite Tags: Type the tags will be used in place of existing tags.
    • Append Tags: Type the tags that will be added to the existing tags.
    • Remove Tags: Type the tags that will be deleted.
    • Maintenance Mode: Toggle off to move the device out of Maintenance mode, toggle on to move device into Maintenance mode.
    • Set Description: Type a description to be added.
    • Set Notes: Type notes to be added.

  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