Already a NinjaOne customer? Log in to view more guides and the latest updates.

Find and Manage Endpoints from the Devices Search Page

Topic

This article explains how to utilize the Devices search page to locate managed devices and run actions on them. 

Environment

  • NinjaOne platform
  • All operating systems

Description

You can access the Devices search page from the left-side navigation pane in NinjaOne. This page allows you to find devices by filtering by their organization, location, operating system, role, health status, and more.

Where to Find the Devices Search Page

Click Devices in the left navigation pane on your NinjaOne console.

Devices search page.png
Figure 1: Where to find the Devices search page in NinjaOne

The data in most of the default columns is clickable and will direct you to different locations/actions:

  • Device: Go to the device dashboard.
  • Health Detail: View information and take action.
  • Organization: Go to the organization dashboard.
  • Location: Go to the Location tab within the organization dashboard.

Features and Table Settings

Select a topic to learn more:

Pagination

If you have 150 or more devices in NinjaOne, the list of devices will be split into pages, and arrows will display at the top of the list. Use the < > arrows to view additional devices; each page displays up to 150 devices.

devices pagination.png
Figure 2: View additional devices

Column Management

Move your cursor over the column name to see if it is sortable. An arrow will display if you can change the order from ascending to descending. Click the column header to sort it; an arrow displays when a column order changes.

devices_sort column.png
Figure 3: Sort a column

Click the Table settings button (gear icon) to add or remove columns from the board and change the order in which they display. For more information about this tool, refer to the section of this article titled Changing and Adding Columns

devices_table settings.png
Figure 4: Table settings button

Toggle Activities

The Activities log is hidden by default; click Toggle Activities to display the data.

devices_toggle activities.png
Figure 5: Show activities on the Devices search page

Health Detail

The Health Detail column shows health status icons; move your cursor over the icon to see details.

Click the icon to see if you can take action on the device. For more information about running actions on devices, refer to the section of this article titled Running Actions on Devices.

devices_health icon_action.png
Figure 6: Take action on health icons on the Devices search page

Load Group

Groups will filter the table to show data for a selected device group. NinjaOne has several built-in search groups that you can view by clicking this button. Select a group to apply it to the Devices search page.

To learn how to create custom groups, refer to our Search and Grouping document.

devices_load group.png
Figure 7: Load groups on the Devices search page

Search Filters

Use the drop-down menus at the top of the page to find specific devices based on the selected criteria. Your custom table settings stay the same.

devices search filters.png
Figure 8: Device search filters

After you interact with the search filters, additional options appear:

  • Reset filters: Click this hyperlink to clear all filters.
  • Save group: Save the filter as a search group. You can access the search group by clicking the Load group button. 

devices search filters_reseet or save.png
Figure 9: Reset search filters or save search group

Export Search Data

Click to export visible data into a .csv file.

You can add or remove columns for the exported data; refer to the Changing and Adding Columns section of this article to learn more.

devices_export.png
Figure 10: Export search data

Refresh data

Click the refresh icon to keep data up to date. This button updates any data affected in real time, such as a new health condition or last uptime. 

device search_refresh.png

Figure 11: Refresh device data

Changing and Adding Columns

The Devices search page displays certain information by default, but users can customize it to meet their data and reporting needs. Column customization includes adding and filtering custom fields, which can be exported with device data into a spreadsheet.

When you add a multiline custom field column to the page, the first line of the custom fields will be displayed in the table, followed by an ellipsis (...). You can move your cursor over the custom field to view the remainder of the content.

These settings save to the local storage, meaning changes persist even after the user logs out and logs back in on the same computer or browser.

To customize the dashboard, perform the following steps:

  1. Click the gear icon (table settings icon.png) in the top right corner of the page.
    The Table settings configuration modal displays.
  2. Make any necessary changes to the sort order and use the Columns field to add more data columns to the table. Click into the field to view all options or begin typing the column's name and select the applicable option from the auto-complete suggestions.

    You cannot exceed 20 columns in the table settings editor. You will see a notification once you reach the maximum number of columns, and the Columns drop-down menu will be disabled, as shown in Figure 12. You cannot remove the default Device and Health Status columns.
  3. To change the display order of the columns, click and hold the column title and "drag" it up or down to change the layout.
  4. Activate the Stacked toggle switch to condense the organization, location, and policy into the same column as the device name.

example of table settings configuration.png
Figure 12: Example of table settings configuration with the stacked data toggle switch (click to enlarge)

stacked device data.png
Figure 13: Example of stacked device, organization, and policy data in the first column

If you stack the Device column, the organization, location, and policy columns are no longer needed, which means you can remove those columns from the maximum threshold.
  1. Click Save.
    The dashboard updates to reflect the user's preferences.

Adding Software Columns to the Device Search Page

Users can add up to five software columns to the Devices search page from the Table settings configuration modal.

  1. Click the Table settings gear icon.
  2. Click the Columns drop-down menu, and then select Software.
  3. Select the checkbox next to the software name to add it as a column on the search page. You can select a maximum of five software, and it must not exceed the required maximum of 20 columns in the table. The text below the Add Software modal title will inform you of the current number of columns selected.
    • Software you previously added to the search page will appear greyed out in the search results.
  4. Click Add.

devices search_add software.png
Figure 14: Add software columns to the Devices search page (click to enlarge)

  • Users cannot use the software columns to sort the table.
  • Software tooltips indicate when multiple versions of software are present on a device. The search row value will present the version and a tooltip that displays the versions and publishers.
  • When selecting column options from the drop-down list, optional columns will no longer have checkboxes; users can click anywhere on the row to select.
  • Text over software in the data table displays the vendor or publisher name of that software (for example, Google Chrome displays "Google, Inc.").

Running Actions on Devices

Depending on permissions and the device's status (it may need to be turned on or connected to the NinjaOne agent), you can perform actions on the device by selecting the checkbox to the left of the device name and using any of the qualified options that display at the top of the table.

devices search_run actions.png
Figure 15: Run actions on devices from the Devices search page 

The actions you see at the top of the device list depend on several factors, such as:

  • Whether you enabled integration, application, patching, or other features at the policy level
  • What policy is managing the device
    • Select devices of the same type to change the policy for multiple devices
  • Device health status
  • Device uptime status
  • Device type
    • You must run scripts and specific ad hoc actions on devices of the same device type
    • The Run option will not display if you select devices of different types 
    • The selected devices must be the same type to change the role for multiple devices

Common Action Descriptions

  • When running a script on an offline device, the script will be queued to run on the next check-in. You can cancel queued scripts.
  • When running a custom script, the system will prompt you to specify any parameters (optional) and whether you wish to run the script as System, the current user, or using credentials from your credential store.
ActionDescription
Run

Run a product (remote, patching, or backup tools), automation, start maintenance mode, enable Wake-On-LAN, or reboot the device. 
When running an automation, you will choose from a list of actions or scripts to run on the device(s). This option is similar to the action button found on the device dashboard. 
Some examples of actions that may be available under the Run menu are:

CreateCreate a Scheduled Task or ticket for the selected device(s). Refer to Ticketing: Resource Catalog to learn more about NinjaOne Ticketing.
EditUpdate the device's policy, organization or location, device role, assigned user, tags, or asset status. You can also use this option to enable backup or delete the device. Refer to Delete or Remove a Device for more information about the different removal options.

Maintenance Mode for All Devices

Selecting a checkbox for a single or multiple devices of the same type or policy provides action items. If you select devices with different types or policies, these actions are narrowed down to Run → Maintenance. From here, you can start maintenance mode immediately or set it to run and end at a specific time.

Maintenance mode is intended to suppress notifications and other selected features for devices. Refer to Maintenance Mode for more details.

devices search_run maintenance mode.png
Figure 16: Run maintenance on devices from the Devices search page 

Once maintenance mode starts, an icon displays in the Health Detail column for its duration. Click the icon and then click the arrow to see action options. You can either change the maintenance details for that specific device or turn off maintenance mode altogether.

manage maintenance mode.png
Figure 17: Manage maintenance mode on devices from the Devices search page

Additional Resources

Refer to the following resource(s) to learn more about device management in NinjaOne:

FAQ

Next Steps