# Devices

## User Guide: Playbook MDM <a href="#user-guide-playbook-mdm" id="user-guide-playbook-mdm"></a>

### Devices <a href="#devices" id="devices"></a>

The [***Devices***](https://ems.bluefletch.com/playbook/devices) subtab of ***Playbook MDM*** is focused on features for managing all of the organization's devices. From this page, a device administrator can see a list of all devices, monitor their compliance through the statuses of their [plays](/bluefletch-enterprise/product-guides/portal/playbook-mdm/plays.md), reallocate devices between [deployment groups](/bluefletch-enterprise/product-guides/portal/playbook-mdm/deployment-groups.md), and troubleshoot or manage individual devices through logs, forced synchronization, and a [remote control platform](/bluefletch-enterprise/product-guides/portal/remote-control.md).

<figure><img src="/files/qFYEriEsl0l2Y7Idyy8h" alt="" width="563"><figcaption></figcaption></figure>

#### Device List <a href="#device-list" id="device-list"></a>

From the main ***Devices*** page, an administrator can see a paginated list of all devices and can search by terms to filter the list. Search terms are listed in a tooltip when hovering the cursor over the search bar and are formatted as "deviceId:\[device serial number]" to search by device ID or "name:\[deployment group]" to search by deployment group, for example.

<figure><img src="/files/VeyrZwpjbZiicpGHeO8d" alt="" width="563"><figcaption></figcaption></figure>

The ***Devices*** list has five columns by which to sort the data, many of which are also available for filtering within the search bar: *Device ID*, *Brand/Model*, *Deployment Group*, *Last Device Sync* (date and time), and *Last Known* (user ID, site ID, and IP address).

Each device is color-coded green or red to indicate its compliance status as compliant or non-compliant, respectively. Compliance is determined by whether or not all plays on the device were run successfully, which can be viewed in detail on a device's [summary](#device-summary) page. The list can be filtered to show only compliant or non-compliant devices through the filter icon within the search bar.

<figure><img src="/files/2lWmkVfTwYHyYi4TeyD2" alt="" width="563"><figcaption></figcaption></figure>

There are three buttons on the main ***Devices*** page for broad management of one or more devices from the list: **Change Deployment Group**, **Remove Deployment Group**, and **Delete**. All buttons are deactivated until at least one device in the list is check-marked.

<figure><img src="/files/Mdv72XpIwZqTRTo5hT2w" alt="" width="563"><figcaption></figcaption></figure>

**Change Deployment Group** moves the selected devices from one deployment group to another. The administrator selects the devices' new deployment group with the options in the *Add Deployment Group* selector.

<figure><img src="/files/aj5WtxRmfNn79Tf1dfIw" alt="" width="563"><figcaption></figcaption></figure>

**Remove Deployment Group** removes the selected devices from their current deployment group. These devices will need to be re-added to another deployment group in order to be actively managed again.

<figure><img src="/files/Luw8mi1RcfqQyo8scoFy" alt="" width="563"><figcaption></figcaption></figure>

**Delete** removes devices entirely from their deployment group and the ***Devices*** list.

<figure><img src="/files/TotOW4IU9mWC6rmjVOWz" alt="" width="563"><figcaption></figcaption></figure>

Clicking on a particular device ID proceeds to its ***Device Summary*** page, which contains more detailed information and features for manipulating that device individually.

#### Device Summary <a href="#device-summary" id="device-summary"></a>

<figure><img src="/files/uGyz1VMbE3xkBZcq3RMN" alt="" width="563"><figcaption></figcaption></figure>

The features available from a ***Device Summary*** page include:

* a list of the device's product and analytical information, such as *IP Address*, *OS Build*, and *First Reported Time*.
* a list of ***Plays on Device*** that provides the status of each play; this can help determine how a device got out of compliance.
* an options menu containing the buttons **Change Deployment Group**, **Remove Deployment Group**, **Request Application Log Uploads**, **View Uploaded Application Logs**, **Force Sync**, **Delete Device**, **Find Device**, and optionally **Remote Control**, if the organization has requested that BlueFletch turn on that feature.
* a **Detailed Device View** button which navigates to that device's [***Device Details Dashboard***](/bluefletch-enterprise/product-guides/portal/support-agent/device-details.md).

<figure><img src="/files/vhip8hQqY5NnipCG6kL3" alt="" width="563"><figcaption></figcaption></figure>

**Request Application Logs Uploads** prompts the device to upload each of its application logs. Once this is complete, all the device's logs will be listed if the user selects **View Uploaded Application Logs**.

<figure><img src="/files/RhkQZR0cbyZztHw3xuG9" alt="" width="563"><figcaption></figcaption></figure>

**Force Sync** sends a message to the device forcing it to run the [Playbook Agent](/bluefletch-enterprise/product-guides/playbook-agent.md)'s synchronization action which checks for any new plays, or plays that have been changed since the device was last synced, and runs them.

**Remote Control** opens a Remote Control window to [view and virtually handle a device from the BlueFletch Portal](/bluefletch-enterprise/product-guides/portal/remote-control.md). The device must have the BlueFletch [Remote Control Agent application](/bluefletch-enterprise/product-guides/device-applications/device-remote-control.md) installed.

<figure><img src="/files/R4KKRioVfXkD4DPLA8ar" alt="" width="563"><figcaption></figcaption></figure>

**Find Device** prompts the [Support Application](/bluefletch-enterprise/product-guides/support-application.md) to chime and open an alert on the device requesting the user to return the device to a charger immediately.


---

# 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://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/playbook-mdm/devices.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.
