PDQ Inventory Filters: Usage & Examples

Purpose:

You wish to understand how to use and combine filters in PDQ Inventory’s dynamic collections and reports.

Resolution: 

PDQ Inventory offers a number of different filtering options for its dynamic collections and reports to help you easily identify specific computers. Filters are split up into four sections that determine what computer attribute the filter is comparing, a value to compare that attribute to, and rules for what type of comparison is being made. These sections are represented by the “Filter”, “Column”, “Comparison”, and “Value” columns in the Filtering Window when creating a dynamic collection or a report. Here you can see these columns along with an incomplete filter as shown when creating a new dynamic collection:

1.png


Depending on the comparison type that is set, there may also be a second “Value” column available. For example, the “Version Between” comparison has a second value available to set an upper and lower bound for your comparison.

In addition to the value filters, each collection or report will also have at least one group filter. In the example above, this is the “All” group filter. There are four different group filter options available:

All: This group filter will be considered true if a machine matches all of the value filters in the group.
Any:  This group filter will be considered true if a machine matches at least one of the value filters in the group.
Not All:  This group filter will be considered true if a machine matches some or none, but not every value filter in the group.
Not any:  This group filter will be considered true only if a machine matches none of the value filters in the group.

 

When adding one or two simple filters to a collection or report, these filters can usually be read similarly to a natural language sentence structure. For example, this set of filters will find all computers which have an application whose name contains “Google Chrome”

2.png

This works similarly when filtering for a specific version of an application. The following set of filters will find all computers which have version 88.0.4324.190 of Google Chrome. Since both of those filters are located under the same “All” group, they will be evaluated together. Any computers which have an application containing the name “Google Chrome” but at a version other than 88.0.4234.190 will not show up in the results, nor will any computers which have an application whose name does not contain “Google Chrome” at version 88.0.4324.190.

3.png

While these filters which search for computers that do meet a set of criteria are usually relatively simple, filtering for computers which do not meet those criteria can be a little more confusing at first. The best way to set up these filters will depend on whether each computer has a one-to-one or a one-to-many relationship with the values being filtered. For example, one computer will only have one OS and one hostname, so these are one-to-one relationships. One computer will most likely have multiple applications installed and might have more than one display connected, so these are considered one-to-many relationships.

With a one-to-one relationship, filtering for machines that don’t meet certain criteria is fairly straightforward. Most comparisons in filtering contain an inverse - the “Equals” comparison can be inverted by using the “Does Not Equal”, the “Contains” comparison can be inverted by using “Does Not Contain”, and so on. Here is an example of a collection to find all machines whose hostname does not begin with “LT” by using one of these filters:

4.png

Filtering for machines that don’t meet particular criteria for a one-to-many relationship is a bit different. Instead of changing the comparison, you will need to change the group filter from “All” to either “Not All” or “Not Any” while leaving the comparison value the same as it would be in a collection searching for computers which do meet that criteria. This is because each filter in PDQ Inventory is evaluated against all values for a given computer. Filtering for computers with an application name that does not contain “Google Chrome” for example will show all computers that have any application other than Google Chrome installed instead of all computers without Google Chrome.

5.png

In some cases, you may want to update a particular value in multiple collections at once. For example, if you have multiple collections that filter computers based on the most recent version of an application you will want to update that application version. You can do this by using custom variables. To manage your custom variables, go to Options > Variables from the main PDQ Inventory console. Once you specify a name and a value for a variable, you will be able to reference that variable in your filters. Then the next time that value changes and you want to update your collections, you can edit the value of the variable and every collection using the variable will be updated as well. Here you can see an example of a variable and how to properly reference it in a collection.

6.png

As with all things, be sure to test your filters and verify the results. It can be helpful to know of a small handful of machines that do meet the criteria for whatever collection you’re creating as well as a small handful of machines that do not meet the criteria so that you can quickly validate the results. 

 

See Also: 

Article - PDQ Inventory Filters: Advanced Usage & Examples

Video - Viewing and Creating Collections in PDQ Inventory

Still have a question or want to share what you have learned? Visit our Community Discord to get help and collaborate with others.