> For the complete documentation index, see [llms.txt](https://docs.guardware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guardware.com/documentation/protect/users-and-devices/protect-devices.md).

# PROTECT Devices

The **PROTECT Devices** section displays all devices running the GuardWare PROTECT Agent within your organisation.

**To view PROTECT devices:**

Navigate to **DEVICES > PROTECT**.<br>

<figure><img src="https://2233655803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6thNYq9Il6WA2mTbj6X%2Fuploads%2FkX6vYcTvUAzJmEct5DxV%2Fimage.png?alt=media&amp;token=db473c3c-7c58-4645-aa09-ba8cf2c9a0da" alt=""><figcaption></figcaption></figure>

## **Device Table Details**

<table data-header-hidden><thead><tr><th width="184"></th><th></th></tr></thead><tbody><tr><td><strong>DEVICE NAME</strong> </td><td>Name of the device where PROTECT Agent is installed.</td></tr><tr><td><strong>LAST USER</strong></td><td>Name of the user who was last online in the device.</td></tr><tr><td><strong>LAST ONLINE</strong></td><td>Last online date and time of the user.</td></tr><tr><td><strong>USERS</strong></td><td>Number of active PROTECT users on the device. <strong>Click any record</strong> to view user details like username, UPN, last online and login timestamp, and first login timestamp. For details on more actions, see Users Details.</td></tr><tr><td><strong>VERSION</strong></td><td>Version of the installed PROTECT Agent.</td></tr><tr><td><strong>OS</strong></td><td>Operating System of the device.</td></tr><tr><td><strong>LOCATION</strong></td><td>Location of the device.</td></tr><tr><td><strong>CREATED DATE</strong></td><td>When the device first registered with PROTECT.</td></tr><tr><td><strong>STATUS</strong></td><td>Status of the PROTECT Agent; you can enable or disable PROTECT Agent from here. </td></tr></tbody></table>

## **Assign Commands**

Commands are instructions you give the device to do something right away. You can assign certain commands to the devices when you want to tell the agent to perform a specific task immediately.&#x20;

To assign a command:

1. Navigate to **DEVICES > PROTECT**.
2. Select the device where you want to send the command and click **Assign Command**. <br>

   <figure><img src="https://2233655803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6thNYq9Il6WA2mTbj6X%2Fuploads%2FtvthMSdZYxvlERirHsgU%2Fimage.png?alt=media&amp;token=0f786750-7f31-4a97-91c3-8d3cb36acb86" alt=""><figcaption></figcaption></figure>
3. Select the command you want to assign and click **Confirm**. Only one command can be assigned at a time.&#x20;

### Commands

#### 1. Refresh Icons

Use the **Refresh Icons** command if icon overlays are missing in protected files or do not update after updating file protection settings.

For example, if you install new applications, such as AutoCAD or Microsoft Word, on a device with PROTECT installed, protected files associated with those applications may not show icon overlays right away. In that case, you can use **Refresh Icons** to update the icons.

#### 2. Encrypt Files

Use the **Encrypt Files** command to apply protection to all files on the device. Files are encrypted according to the policies configured in the user policy.

#### 3. Decrypt Files

Use the **Decrypt Files** command to remove protection from all protected files for the user. This step is especially required before uninstalling PROTECT from a device. Uninstalling PROTECT without first removing protection from your protected files will make them inaccessible afterwards.

#### 4. Disable Agent

Use the **Disable Agent** command to turn PROTECT off for the device. When the agent is disabled, all users on that device lose access to PROTECT features and all protected files.

#### 5. Enable Agent

Use the **Enable Agent** command to turn PROTECT on for the device. Users on the device can only access PROTECT features if PROTECT is enabled on the device.

#### 6. Disable User <a href="#id-1.-enable-disable-user" id="id-1.-enable-disable-user"></a>

Use the **Disable User** command to turn PROTECT off for the last online user on the device. When the user is disabled, they lose access to PROTECT features and all protected files.

#### 7. Enable User <a href="#id-1.-enable-disable-user" id="id-1.-enable-disable-user"></a>

Use the **Enable User** command to turn PROTECT on for the last online user on the device.&#x20;

#### 8. Uninstall&#x20;

Use the **Uninstall** command to remove PROTECT from the device. Before uninstalling, make sure you decrypt all protected files first if you want the users on the device to access the files later. If PROTECT is uninstalled without decrypting the protected files, users will no longer be able to access those files. To decrypt the files, use the [Decrypt Files](#id-3.-decrypt-files) command.

## Maintenance Mode

### Log Settings

The **Log Settings** section lets you manage log collection for selected devices and view the collected PROTECT agent log files.

#### Enable/Disable Log Collection

1. Navigate to **DEVICES > PROTECT** and click **Maintenance Mode**.
2. Select the device whose logs you want to collect and click **Log Settings**. Only one device can be selected at a time.
3. Use the toggle next to a user to enable or disable log collection for that account.&#x20;

<figure><img src="https://2233655803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6thNYq9Il6WA2mTbj6X%2Fuploads%2F0k5lOVyCSGlXnSsjDTtu%2Fimage.png?alt=media&amp;token=410fbfab-8a70-4187-8af2-c8c32ad7597b" alt=""><figcaption></figcaption></figure>

Once the logs are ready, you can view the log files in the **Agent Log Files** section. Use the search field, date range, and other filters to update the results based on your search and filter criteria.<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.guardware.com/documentation/protect/users-and-devices/protect-devices.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.