Endpoint Services, Jamf Pro, Computer and Mobile Device Searches
Systems
Jamf Pro
Affected Customers
University of Illinois IT Pros leveraging Technology Services Endpoint Services Jamf Pro
Actions
- General Information
- Configuring Search & Inventory Display Preferences
- Simple Searches
- Advanced Searches
General Information
Jamf Pro allows administrators to search, view, and report on inventory information for enrolled computers and mobile devices.
There are two primary search methods:
- Simple Searches - Best for quick, one-off look-ups of specific devices or users
- Advanced Searches - Used for complex queries with multiple criteria. These can be saved, reused, and exported/emailed.
Additionally, the Jamf Pro Dashboard, provides a customizable, at-a-glance overview of your environment.
Configuring Search & Inventory Display Preferences
Search Preferences
By default, inventory searches return results matching the exact input ("Exact Match"). This search behavior can be changed on a per-user basis and has separate configurations for the different inventory record types (Computers, Mobile Devices, and Users).
To configure a Jamf Pro user's search preferences:
- In the Jamf Pro console, navigate to Account settings → Account Preferences in the top right.
- Select Search Preferences along the top the top.
- After selecting the desired inventory type (Computers, Mobile Devices, or Users), you can modify the search behavior for that inventory type's fields.
- Exact Match – results must match input exactly
- Contains – partial matches (similar to using wildcards)
- Once you've changed your desired search preferences, click 🖫Save in the bottom right.
Inventory Preferences
The Computer Inventory Display and Device Inventory Display settings allow each Jamf Pro user to choose which attribute fields are displayed in the results of a simple computer or mobile device search. The field columns appear in alphabetical order per category based on the attribute fields selected.
To configure a Jamf Pro user's Inventory Display settings:
- In the Jamf Pro console, click Settings in the sidebar.
- Navigate to Settings in the left-hand sidebar
- In either the Computer management or Device management section, depending on the desired endpoint type, click Inventory display.
- Click the Edit button in the bottom right.
- On each pane, select or deselect the checkbox for each attribute field you want to display or remove.
- Click 🖫Save in the bottom right.
Simple Searches
Simple inventory searches allow administrators to locate inventory records in Jamf Pro based on endpoint attributes, such as Device Name, Serial Number, Model, Operating System, and IP Address. They are best for quick, one-off look-ups of specific devices or users.
To perform a simple search in Jamf Pro:
- In the Jamf Pro console, navigate to Computers or Devices → Search Inventory in the sidebar, depending on the desired endpoint type.
- In the Search... text box, enter any endpoint attributes that you'd like to search by, such as Device Name, Serial Number, Model, Operating System, and IP Address. You may also change the adjacent dropdown to change the type of inventory record that you're searching for (Computers, Applications, Printers, etc.)
- Click the Search button to perform the search and return relevant inventory records.
Tips:
- To view all enrolled devices, click the Search button with a blank query field.
- Wildcards, represented by the (*) character, may be used to find inventory records beginning with (e.g., EPS*), ending with (e.g., *EPS), or containing values (e.g., *EPS*).
- Wildcards are not necessary if you've modified your Jamf Pro account's Search Preferences from 'Exact Match' to 'Contains'
Advanced Searches
Advanced inventory searches allow administrators to locate inventory records in Jamf Pro based on multiple endpoint attributes at once. They allow for complex filtering with multiple criteria and data exporting and can be saved, allowing it to be viewed again in the future.
To perform/create an advanced search in Jamf Pro:
- In the Jamf Pro console, navigate to Computers or Devices → Search Inventory in the sidebar, depending on the desired endpoint type.
- Click the + New button in the top right to create a new advanced search
- If you wish to save the advanced search, allowing it to be viewed again in the future from the Search Inventory page, check the Save this search checkbox. Provide an appropriate name for it, being sure to place your Jamf Pro site prefix at the beginning.
- On the Criteria tab of the advanced search, add and customize search criteria to find the desired inventory records:
- Click the + Add button on the right.
- Click the Choose button for the criteria you want to add.
- Initially, only your 30 most frequently used criteria are listed. To display additional criteria, click Show Advanced Criteria in the top right.
- Choose an operator from the Operator pop-up menu.
- Enter a value in the Value field or, if applicable, browse for a value by clicking the ⋯ button.
- Repeat steps a through d to add additional criteria as needed.
- Choose an operator from the And/Or pop-up menus to specify the relationships between the criteria.
- To group criteria and join multiple operations, choose parentheses from the pop-up menus around the criteria you want to group.
- Operations in the search take place in the order they are listed (top to bottom)
- On the Display tab of the advanced search, select the attribute fields you want to display in your advanced search results.
- Advanced searches will default to the attribute fields configured in your Inventory Display settings.
- On the Reports tab of the advanced search, advanced computer search reports may be downloaded or can be emailed instantly or on a defined schedule:
- Select a file format for the report (.csv, .tsv, XML).
- Select the inventory item on which to base the report results.
- Click the Download Report button. The report downloads immediately.
- If saving the advanced search, click 🖫Save in the bottom right, otherwise, click the 🔍︎ Search button to view the advanced search results.
- After saving the advanced search, click the View button to view the advanced search results.
To view advanced searches that were previously saved:
- In the Jamf Pro console, navigate to Computers or Devices → Search Inventory in the sidebar, depending on the desired endpoint type.
- Select the saved advanced computer search you wish to view.
- Within the advanced search:
- Click the View button in the bottom right to view the advanced search results.
- Click the Edit button in the bottom right to modify the advanced search.
- Click the Clone button in the bottom right to create a copy of the advanced search.
- Click the Delete button in the bottom right to delete the advanced search.
- Navigate to the Reports tab to download a copy of the advanced search report.
Advanced Search Operators
| Operator | Definition | Example |
|---|---|---|
| is | Matches the specified string exactly | The criteria "'Computer Name' is 'Test Computer 6'" includes computers with the name "Test Computer 6". By contrast, a computer with the name "Test Computer 7" is not included. |
| is not | Matches values that do not match the specified string exactly | The criteria "'Display Name' is not 'CIO iPad'" includes all devices except those with the exact display name "CIO iPad". By contrast, a device with the display name "'CIO iPad Old'" is not included. |
| like | Matches value that contain the specified string | The criteria "'Computer Name' like 'AP Science Mac'" includes computers with names such as "AP Science Mac 1", "AP Science Mac 2", and "AP Science Mac 3". |
| not like | Matches values that do not contain the specified string | The criteria "'Display Name' not like 'Staff'" includes devices with display names such as "Student A", "Student B", and "Smith Personal iPhone". |
| has | Matches applications or files that are present on a device | The criteria "'Licensed Software' has 'Microsoft Excel'" includes computers that have Microsoft Excel currently installed. |
| does not have | Matches applications or files that are not present on a device | The criteria "'Licensed Software' does not have 'Microsoft Word'" includes computers that do not have Microsoft Word currently installed. |
| matches regex | Matches values that match the specified regular expression (regex). | The criteria "'Computer Name' matches regex '^LAB-.*$s'" includes computers with names such as "LAB-ART-101", "LAB-CS-101", and "LAB-CS-102". |
| does not match regex | Matches values that do not match the specified regular expression (regex). | The criteria "'Display Name' does not match regex '^HS'" includes devices with display names such as "iPad HS loaner" and "11 HS iPad". |
| before (yyyy-mm-dd) | Matches events that occurred before a specified date | The criteria "'Last Inventory Update' before (yyyy-mm-dd) '2024-05-01'" includes computers or mobile devices that updated their inventory before 01 May 2024. |
| after (yyyy-mm-dd) | Matches events that occurred after a specified date | The criteria "'Last Check-in' after (yyyy-mm-dd) '2024-05-01'" includes computers or mobile devices that checked in with Jamf Pro after 01 May 2024. |
| more than x days ago | Matches events that occurred more than a specified number of days ago | The criteria "'Last Enrollment' more than x days ago '30'" includes computers or mobile devices that completed an enrollment more than 30 days ago. |
| less than x days ago | Matches events that occurred less than a specified number of days ago | The criteria "'Last Inventory Update' less than x days ago '14'" includes computers or mobile devices that have updated their inventory less than 14 days ago. |
| current | Matches values when a value is consistent with what Jamf Pro identifies as the most recent version | The criteria "'JAMF Binary Version' current" with the Value field left blank includes computers that have the current version of the jamf-pro binary installed. |
| not current | Matches values when a value is not consistent with what Jamf Pro identifies as the most recent version | The criteria "'JAMF Binary Version' not current" with the Value field left blank includes computers that do not have the current version of the jamf-pro binary installed. |
| greater than | Matches operating system versions that are greater than the specified version | The criteria "'Operating System Version' greater than '13'" includes computers that have macOS 13.0.1 or later installed. |
| less than | Matches operating system versions that are less than the specified version | The criteria "'Operating System Version' less than '14'" includes computers that have macOS 13.6.7 or earlier installed. |
| greater than or equal | Matches operating system versions that are greater than or equal to the specified version | The criteria "'OS Version' greater than or equal '16'" includes mobile devices that have iOS, iPadOS, or tvOS 16.0 or later installed. |
| less than or equal | Matches operating system versions that are less than or equal to the specified version | The criteria "'OS Version' less than or equal '17'" includes mobile devices that have iOS, iPadOS, or tvOS 17.0 or earlier installed. |
| member of | Matches computer, mobile device, or user values that are members of a specified smart or static group | The criteria "'Computer Group' member of" with the Value field containing the name of an existing smart or static group includes members of the specified smart or static group. |
| not member of | Matches computer, mobile device, or user values that are not members of a specified smart or static group | The criteria "'Mobile Device Group' not member of" with the Value field containing the name of an existing smart or static group includes computers, mobile devices, or users that are not a member of the specified smart or static group. |