At Library > Modules, you can configure and manage Modules. Modules are containers for the Tasks that you can execute on Agents. Modules hold information about how these Tasks should be executed, such as Task settings, order of execution of Tasks, parameters and conditions. When configuring Modules, use the Tasks tab to manage the Tasks in the Module.
Tasks are actions that you can perform on an Agent. With a Task you can, for example, install software on Agents, manage users and groups in Active Directory, query security risks on Agents or query mailboxes on Microsoft Exchange servers.
- When adding a new Task to a Module, you can select Tasks from the various libraries in the Select Task window. See Tasks for an overview of all libraries and the Tasks they contain.
- You can use the Instant Search field when selecting Tasks. To find a specific Task, simply start typing part of its name. As you type, the list will be filtered to show only items that contain the search term. Alternatively, you can just browse the tree of available Tasks.
- When selecting a Task for a Module, you can open all libraries in the Select Task window at once: right-click and select Expand all. To close all open libraries, right-click and select Collapse all.
- You can also select and open items in the Select Task window using the keyboard. Use TAB and ENTER to go to libraries and topics. To select a Task in a topic, select the relevant topic and type 1 to open the first Task, type 2 for the second Task, etc.
- To create a duplicate of a Task, select it and click Duplicate. Creating a duplicate of a Task is useful when you need to configure a new Task that only slightly differentiates from an already existing Task in the Module. By changing the values and settings of a duplicated Task, you can customize it to your needs. This saves configuration time.
- You can add multiple Tasks to a Module.
- To create sets of Tasks, right-click the Tasks tab and click Add Separator. Separators are a visual aid to enhance readability in Modules that contain many Tasks; they do not affect the execution order of Tasks, but make it possible to configure visible sections of Tasks that, for example, are related to each other. In addition, it is possible to add a descriptive text to a set of Tasks.
- The name of a separator can contain a maximum of 255 characters.
- The description of a separator can contain a maximum of 4000 characters. The use of hyperlinks is supported.
- To change the order of execution of Tasks in the Module, select a Task and use the arrow buttons. Likewise, use the arrow buttons to move any separators up or down the list of Tasks.
- To set conditions on a Task, select the Task and click Conditions. Task conditions determine whether a Task in a Module should be executed, skipped or failed. See Conditions.
- You can copy and paste Tasks from one Module to another. If a Task contains parameters, only their placeholders will be copied, as text: the corresponding Module parameters will not be copied, but have to be created manually.
- Alternatively, if you want to create a new Module quickly for a specific Task, right-click the Modules node and click Quick Task. This opens the Select Task window immediately; a new Module will be created automatically. After configuring the selected Task, it will be added to this Module. This functionality is also available from the Action menu.