# Client Task Management

**Client Task Overview**

Client tasks automate system management activities, such as product deployment, upgrades, and updates.

1. **Client Task Catalog**

   Applies the concept of logical objects to ePO client tasks. You can create client task objects for a variety of purposes without the need to assign them immediately. You can treat these objects as reusable components, when assigning and scheduling client tasks.

2. **Client Tasks**

   Can be assigned at any level in the System Tree and are inherited by groups and systems lower in the tree. As with policies and policy assignments, you can break the inheritance for an assigned client task.&#x20;

3. **Client Task Objects**

   Can be shared across multiple registered ePO servers in your environment. When client task objects are set to be shared, each registered server receives a copy after your Share Client Task server task runs. Any changes made to the task are updated each time it runs. When a client task object is shared, only the owner of the object can modify its settings. An administrator, on the target server that receives a shared task, is not the owner for that shared task. None of the users on the target server is the owner for any shared task objects that the target receives. If modifications are necessary, the administrator can duplicate the task, and then make modifications on the duplicated task.

{% hint style="info" %}
You can export and import client tasks for use with other ePO servers.&#x20;

**Note**: The product extensions installed on ePO server determine which client tasks are available for a specific application.
{% endhint %}

### **Client Tasks**

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/n6a40KbCJgNjhQr4_0LgfF6UJ7ILiraZz.png" alt="Menu &#x26;gt; Client Tasks"><figcaption><p><em><strong>Menu</strong></em> > <em><strong>Client Tasks</strong></em> </p></figcaption></figure>

* **Client Task Catalog**: View and create client tasks
* **Client Task Assignments**: Assign and manage client tasks from the System Tree group/subgroup levels
* **Client Task Comparison**: Compare client tasks with similar characteristics

#### **Client Task Catalog**

Use the Client Task Catalog to add and manage client tasks. A client task must be enabled and assigned to your managed systems to be available to be used in the ePO environment.

Some commonly used client tasks for Trellix Agent include:&#x20;

* **Trellix Agent Statistics**: Collects network bandwidth saved by the RelayServer, Peer to Peer, and SuperAgent hierarchical features
* **Trellix Agent Wakeup**: Triggers an immediate Agent-Server Communication; this applies to Windows operating systems only
* **Mirror Repositories**: Specifies a location on the managed system to replicate contents from the repository; this applies to Windows operating systems only
* **Product Deployment**: Install a product on managed systems&#x20;
* **Product Update**: Update a product on managed systems

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/jRS3N7EXH-cjtx0l_oP-XZXNNkHrRhX2Q.png" alt="Menu &#x26;gt; Client Task Catalog"><figcaption><p><em><strong>Menu</strong></em> > <em><strong>Client Task Catalog</strong></em></p></figcaption></figure>

{% hint style="info" %}
As additional products are checked into ePO, client tasks for those products will be added.\
**Example**: Endpoint Security Threat Prevention will add the On-Demand Scans and Restore from Quarantine client tasks.
{% endhint %}

#### **Client Task Assignments**

From the Client Task Assignments page, you can view and manage client task assignments. You can also get to this page from the **System Tree** > **Assigned Client Tasks** tab.

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/a6Xks6vzDD6P6SEt_5n_-HttN63yI-Kxv.png" alt="Menu &#x26;gt; Client Task Assignments or System Tree &#x26;gt; Assigned Client Tasks tab"><figcaption><p><em><strong>Menu</strong></em> > <em><strong>Client Task Assignments</strong></em> or <em><strong>System Tree</strong></em> > <em><strong>Assigned Client Tasks</strong></em> tab</p></figcaption></figure>

### **Client Task Comparison**

The Client Task Comparison tool is used to compare client tasks that are similar. This allows you to determine which settings are different and which are the same.

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/WjUW0_9aIKCMKSoR_k3CyxVItdGF5lfEf.png" alt="Menu &#x26;gt; Client Tasks &#x26;gt; Client Task Comparison"><figcaption><p><em><strong>Menu</strong></em> > <em><strong>Client Tasks</strong></em> > <em><strong>Client Task Comparison</strong></em></p></figcaption></figure>

### **Client Task Approvals**

With ePO - On-prem, the administrator has the option to require an approval process before a new or updated client task is pushed out, reducing the risk of an error and assuring quality control.

As an administrator you can create permission sets for different policy user levels. You can choose client task management users need approval to make task changes The Permission Sets allow some client task users not only to create and modify client tasks, but also to approve or reject client tasks created by other users. To manage client task creation, you can create permission sets for users who can create and modify specific client tasks. For example, you can create permission sets that allow one user to change tasks and another user permission to approve or reject those changes.

> ### Client Task Approvals: Server Settings <a href="#card-title-21" id="card-title-21"></a>
>
> As an administrator, you can lock down creation access for client tasks by configuring user accounts to require approval first when attempting to create client tasks.

<figure><img src="/files/irlne8cq49Z3ANYTLhiu" alt="" width="338"><figcaption><p>Select <strong>Menu</strong> > <strong>Configuration</strong> > <strong>Server Settings</strong>.</p></figcaption></figure>

<figure><img src="/files/d2hIs6EULMPLmixqYaZW" alt=""><figcaption><p>Navigate to and select <strong>Approvals</strong> under the Setting Categories column and click <strong>Edit</strong>.</p></figcaption></figure>

<figure><img src="/files/ShbS4vjHhvc8IBRQ3TM5" alt=""><figcaption><p>Select the <em>Users need approval for client task changes</em> option and click <strong>Save</strong>.</p></figcaption></figure>

> ### Summary <a href="#card-title-25" id="card-title-25"></a>
>
> The client task approval step is now completed. Next, we need to create a permission set that forces user accounts to have an administrator review the client task creation.

> ### Client Task Approvals: Permission Sets <a href="#card-title-27" id="card-title-27"></a>
>
> Now you can create and assign the newly created permission set rules for the user account.

<figure><img src="/files/czeTL38Rky8Fc5PPs0px" alt="" width="314"><figcaption><p>Select <strong>Menu</strong> > <strong>User Management</strong> > <strong>Permission Sets</strong>.</p></figcaption></figure>

<figure><img src="/files/alNXSNmbcEAHs6mpwCnI" alt=""><figcaption><p>Click <strong>New Permission Set</strong> to create a new default entry. For this example, we are creating the permission set named <em>Client Task Approver</em>.</p></figcaption></figure>

<figure><img src="/files/poTPAqTuxag6O0uhr5hl" alt=""><figcaption><p>On the Permissions Set page, navigate to <strong>Client Task Management</strong> and click <strong>Edit</strong>.</p></figcaption></figure>

<figure><img src="/files/34QLhwjL0IxIqTiA08Vw" alt=""><figcaption><p>Select the <em>No Permission – Users cannot approve or decline task change requests</em> option and click <strong>Save</strong>.</p></figcaption></figure>

<figure><img src="/files/WAFTB4r9UNVEUhUhz67T" alt=""><figcaption><p>Navigate to a product entry in the list and click <strong>Edit</strong>. For this example, we will use <strong>Trellix Agent</strong>.</p></figcaption></figure>

<figure><img src="/files/uwMZN3lMhBjRq1GPaDBs" alt=""><figcaption><p>Select the <em><strong>View and change settings</strong></em> option for the <em>Trellix Agent: Tasks</em> entry and click <strong>Save</strong>.</p></figcaption></figure>

> ### Summary <a href="#card-title-34" id="card-title-34"></a>
>
> Once you have created the permission set, you can edit it to either assign it to an existing user or create a new user and assign it to that user.

***

### **Sharing Client Task Objects**

Client task objects can be shared across multiple registered ePO servers in your environment. When client task objects are set to be shared, each registered server receives a copy after your Share Client Tasks server task runs. Any changes made to the task are updated each time it runs.&#x20;

When a client task object is shared, only the owner of the object can modify its settings. Administrators on the target server that receives a shared task are not owners for that shared task. None of the users on the target server are owners for any shared task objects the target receives.&#x20;

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/9bNknPy3qLEsMk-C_WiCKHpVGFBsOmHeq.png" alt=""><figcaption></figcaption></figure>

### **Deleting Client Tasks**

To delete client tasks:

1. In the left pane of the Client Tasks Catalog, select a **Client Task Type**.\
   **Example**: **McAfee (Trellix) Agent** > **Product Update**.
2. In the right pane, select a client task.
3. Click the **Delete** link for the selected task.
4. When prompted, ensure you understand how this will affect other systems and click **OK**.\
   **Note**: This also removes the task from where it was assigned in the System Tree.

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/qEXsWthipla7o0Ps_QUYXnUt_e3rFQaFu.png" alt=""><figcaption></figcaption></figure>

### **Managing Client Tasks from the System Tree**

You can also manage client tasks from the System Tree.&#x20;

From the **Assigned Client Tasks** tab, you can:

* **Reset Inheritance**: The Broken Inheritance shows which systems or groups do not inherit task. From this column, you can also reset the inheritance for a specific System Tree object. To do this, click the blue hyperlink from the **Broken Inheritance** column, select an entry in the **Node Name** column, then click **Reset Inheritance**.
* **Edit Assignment**: Click the **Edit Assignment** link to launch Client Task Assignment Builder within the Client Task Catalog.
* **New Client Task Assignment**: Select **Actions** > **Edit Assignment** to launch Client Task Assignment Builder within the Client Task Catalog or click the default link to the right of the **Actions** drop-down.

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/uZ9ldOTG-1Xf_ihO_aMPBLtPxAaMEXLje.png" alt=""><figcaption></figcaption></figure>

From the **Systems** tab, you can:

* **Modify Tasks on a Single System**: Edit tasks for selected system
* **Run Client Task Now**: Run a client task for a selected system

<figure><img src="https://training.trellix.com/content/elearningngx/AhnSgBAy7j7hIT_7H3aY2w/1693969305/0088YmZiUEJFNUlneVVCNnVIVG9rc3ZsOUtjbnk2Yk5iN1AvYUNTQWlxV0NxUVIvbzFnKzYwdnFDczFXSmY3TEk0Rw==VHVlIFNlcCAwNSAxNTowMTo0NSBFRFQgMjAyMw==/eot/scormcontent/assets/aVlCVqSGFYZ4QtK0_hcTQhjjYR8CHB8d0.png" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sirogy.gitbook.io/trellix-epolicy-orchestrator-on-prem-5.1/product-management/client-task-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
