This document describes how you can create device queries in the Device Explorer using the Device Query. A query acts as a ruleset for filtering devices to view collections for informational reporting purposes. From the main Devices page, select the Device Explorer tab. Initially, all devices in your zone are listed in the table. Use queries to filter this list of devices.

The following topics are described here:

From the Device Explorer page, you can create and save queries that filter devices into lists according to the criteria in the saved query.

device-explorer.png

Device Query

From the Device Query, select up to 10 criteria and save the query to filter devices according to your needs. This saved query is available in a query selector and can be reused, or duplicated and amended. A list of devices appears below the query, which can be exported to a CSV file.

Create a query

Select Attributes and find the type you want to add to your query. Refer to the Attributes Reference list for more information about the attributes.

  1. Go to the Attributes menu and select from the list of options.

  2. Select a Condition. The available conditions depend on the attribute selected.

  3. In the Value field, enter a corresponding value to filter by or select from the options, depending on the attribute.

  4. Use the operators AND, OR, and NOT, and apply Subsets, as needed.

    • AND lists devices where ALL the criteria specified are true

    • OR lists devices where ANY of the criteria specified are true

    • NOT lists devices where the criteria specified are NOT TRUE

  5. Select Save Query. Enter a unique name up to 64 characters in length. The new query can be found in the Saved Queries selector.

You can create a new query from an already existing query. Open the query to use, modify the query as needed. Save using a unique name.

Example queries

Example of a CPU and IP address filter query:

query-example-cpu.png

Example of an agent version query:

query-example-agentversion.png

Delete a query

If you are creating a new query and want to start over, select Clear All. This resets all entries that were made.

To delete a saved query, open the query from the Saved Queries selector and click Delete Query. Confirm your selection. The query is removed from the Saved Queries selector.

View saved queries

You can view a list of queries from the Saved Queries selector. Click the down arrow to open a list of all queries. If this list is empty, you have no save queries.

query-selector.png

Show or hide Query details

It is possible to hide the details of a query. To do this, select the arrow above the query details.

cpu-example.png

When the query details are hidden, a number indicates how many criteria were used to create the query. Select the arrow to show the full details again.

query-hide-details.png

Attributes Reference

Attribute

Description

Active Directory OU

Active directory organizational unit filter path, if configured

Agent Version

Version of the Automox agent running on the device.

CPU

Model of the CPU

Custom Name

Name assigned to the device by the user

Date Added

When the device was first added to Automox

Device Name

Permanent device name (hostname)

Device UUID

Universally unique identifier for the device

Disk

Type and size of installed storage drives

Distinguished Name

Unique name for the device in your active directory - organizational unit

FQDN

Fully qualified domain name

Group

Name of the group that the device is assigned to

Group ID

Group ID that the device is assigned to

IP Address

IP address assigned to the device

Last User Login

The name of the user who last logged in to the device

Model

Type of computer

NIC

Network interface controller

OS

This is the OS type of the device, either macOS, Windows, or Linux

OS Family

Operating system: Windows, Mac, or Linux

OS Version

Operating system build number

PowerShell Version

Version number of the installed build (Windows only)

Private IP Address

Private IP address assigned to the device

RAM

RAM in bytes

Serial Number

This lists the serial number for a device

Service Tag

Tag number that comes from the manufacturer

Software Name

Name of the software package

Software Version

Version number associated with the software

Tags

User defined label that is assigned to a device

Vendor

Device manufacturer

Version

Main board model

Note: You can create queries that include filtering devices by Software Name, Software Version, and Tag, however, the corresponding data is not included in CSV export files.

Conditions and Values

Depending on the attribute selected, you can select from different conditions. The value field then allows you to enter text or select from corresponding values.

Example of condition selection:

query-condition.png

Example of value selection:

query-value.png

Devices Table

You can view the list of devices that have been filtered by the query. The table includes the same data as the list of attributes, which is reflected in the column headers.

device-explorer-table.png

You can find data by using the search bar on the devices table. This is a single term search.

Note: Currently, the search scope is limited to Custom Name, Device Name, and Device UUID.

Show/hide columns

The devices table has a default setting of data that can be changed. You can hide, show, and rearrange the columns of data in the list of devices.

work-with-columns.png
  1. Select Columns to view the complete list of columns available.

  2. Drag and drop column names to the position desired. The table adjusts automatically.

  3. Select or clear the checkbox for any column to show or hide that data. This has no effect on the results of any export, which includes the full set of data.

Device Details Sidebar

You can view various statuses and basic details about individual devices directly from the Device Explorer > Devices table. By selecting a device, you open the details sidebar where you can directly take action on the individual device.

Note: You must have the required permissions to take actions on the device. See Roles and Permissions.

device-details-sidebar.png

Interacting with the device details sidebar:

  1. From the Devices table, select the corresponding checkbox to view the device details sidebar for a device. 

  2. View status and connection details about a device.

  3. You can restart, scan, or delete the device directly from the sidebar. Follow any corresponding prompts related to the selected action.

  4. You can view the number of Available Patches. 

    • This status indicates if applicable patches have been detected. Note that these are not necessarily associated with a scheduled policy. 

    • To view a list of available patches for a device, click the Device Name to open the Device Details page. Go to the Software section. The Status column lists any available patches. Search for Update Available.

    • It is recommended that you scan the device to ensure that this status is accurate.

The information provided in this sidebar is an excerpt of the details provided on the current Device Details page. For more information about this data, see Device Details Fields. See also What Statuses Found in the Automox Console Mean.

Note: The Export CSV does not include this sidebar status information. See the next section for details about the CSV file.

Export the Device List to a CSV File

You can export the results of any query by selecting the Export CSV button. This exported file only includes the devices from the results of the query. The data exported includes the following information (refer to the Attributes Reference for descriptions)

CSV Export

Attribute equivalent

agentVersion

Agent Version

CPU

CPU

createdAt

Date Added

customName

Custom Name

deviceUuid

Device UUID

DISKS

Disk

DISTINGUISHED_NAME

Distinguished Name

FQDNS

FQDN

ipAddrs

IP Address

ipPrivateAddrs

Private IP Address

lastLoggedInUser

Last User Login

MODEL

Model

name

Device Name

NICS

NIC

organizationalUnit

Active Directory OU

osFamily

OS Family

os

OS

osVersion

OS Version

PS_VERSION

PowerShell Version

RAM

RAM

serial

Serial Number

serverGroup

Group ID

serverGroupName

Group Name

SERVICETAG

Service Tag

VENDOR

Vendor

VERSION

Version

Note: You can create queries that include filtering devices by Software Name, Software Version, and Tag, however, the corresponding data is not included in CSV export files.

Related Topics

Was this article helpful?
0 out of 0 found this helpful