View and manage devices

If your organization has devices enrolled in multiple Knox cloud services, the Knox Admin Portal offers two consolidated views that display cross-service information about devices:

• The common device list, which provides information about all the uploaded and approved devices across your Knox services.
• The device search page, which shows consolidated information about a single device.

If you’re a managed service provider admin, device and service information is limited to the customer you’re currently managing.

Common device list

To make it easier for you to keep track of devices across different Knox services, the common device list consolidates information about all your uploaded and approved devices.

To go to the common device list, click Devices in the bottom-left corner of the Knox Admin Portal navigation pane.

On this page, you’ll find:

• A DEVICES tab to check the status of your devices and jump to device lists in other services to manage them.
• A COMMON TAGS tab to create and assign tags to organize, sort, and search your devices.
• A BULK ACTIONS tab for easy upload of devices, with each device associated with up to 10 device tags.

DEVICES tab

The list shows common device information, such as the device IMEI/MEID, model name, and device status for each service. If a device has more than one IMEI, the primary IMEI is shown by default, with the secondary IMEI shown as a tooltip when you hover over the primary IMEI. In the tabs above the list, click a service name to jump to information about that service for the devices you’re currently seeing. To see all the service details in a sliding panel, click the device IMEI/MEID.

You can also sort the list by column and apply filters to one or more columns. To remove any filters that you applied, click Clear all filters.

By default, 25 devices are shown per page. You can also select whether you want to see 50 or 100 devices on each page instead.

To perform an action on certain devices, select them in the list. Above the list, you’ll then see links to the service consoles the devices are associated with. Select a service to go to a filtered view of that service’s device list, which only shows the devices you selected from the common device list.

Search for one or more devices in the list

Using the search bar, you can search for single or multiple devices in the common device list.

• Single device — Enter a device IMEI or serial number containing a minimum of 3 characters.
• Multiple devices — Enter a maximum of 100 exact device IMEIs and serial numbers, separated by commas. You can also click  on the right side of the search bar to upload a CSV file containing up to 100 device IMEIs or serial numbers you want to find. 

To add filters to your search, click . In the Filters dialog, select the related service information you want to filter by, then click APPLY FILTERS. You can also clear any filters you applied previously by clicking CLEAR FILTERS, then APPLY FILTERS again.

Configure the device list

To customize the columns in the common device list, click Settings. You can select which services you want to see in the list, as well as specific device information related to each service. If you can’t see or select a particular service, make sure you’re registered for it and that the service is shown on the portal.

Assign and remove common tags

You can assign up to 10 common tags to devices. The tags assigned to a device are also shown in the device details.

When you assign a common tag to a device, the information is shown in the device list and the device details. It is also shown in the common tag list.

To assign common tags, select one or more devices, click Actions > Assign common tags, enter the tag names, and click Save. You can select from an existing tag or add a new tag.

To remove assigned tags from devices, select the devices and click Actions > Remove common tags.

Export device information

To export common device information, click Download as CSV. You’re then able to choose whether you want to include all available columns in your export, or just specific columns that you select. By default, the columns shown in the device list are pre-selected.

COMMON TAGS tab

The list shows information about any tags that you create for the common device list in the Knox Admin Portal, such as the tag name, number of devices associated with it, and its last modified date. You can sort the list by column to lookup the common tags. To see all the tag details in a sliding panel, click the common tag name.

Search by common tags

Using the search bar, you can search for all devices associated with a common tag. To search, enter at least three characters of a tag name. You can also include numbers and alphabets from local languages, such as Korean and Japanese. No special symbols are supported in the search.

Create common tags

To create one or more common tags, click Create tags, enter the tag names, and click Save. The tags show in the common tags list.

Rename a common tag

Renaming a common tag has no effect on the devices assigned to it.

To rename a common tag, click the tag name in the list, modify its name in the Edit common tag dialog that appears, and click Save. The tag name is updated in the common tags list.

Delete common tags

Deleting a common tag removes it from the common tags list and also removes it from any device that it’s assigned to.

To delete one or more common tags, select the tags, and click Actions > Delete tags. Alternatively, click the tag name in the list, click Delete in the Edit common tag dialog, and confirm to permanently delete the tag.

BULK ACTIONS tab

You can assign up to 10 common tags to multiple devices in a single bulk action. Use the provided CSV template to add, assign, and remove common tags in bulk.

To download the CSV template, click Assign common tags, and click Download CSV template on the page. You must provide device IMEIs and corresponding common tags in the template. If you specify a new tag, it’s added to the common tag list after upload.

To assign common tags, click Assign common tags, browse and select the CSV file, and click Submit. You can also overwrite or remove any common tags assigned to devices.

Device search

In the search bar at the top of the Knox Admin Portal, enter a device IMEI or serial number to view Knox service information for that device on a centralized page. If the device you’re searching for has two SIMs, you can enter either the primary or secondary IMEI to view its information.

You can also click SEE MORE DETAILS to go to a filtered view of the common device list, which only shows information about the device you searched for.

The device search page displays the following:

Delete devices from Knox cloud services

As an admin, you can delete devices across Knox cloud services from the Devices page on the Knox Admin Portal, without the need to navigate to individual services. To do so, you must have access to the services and the Delete devices common permission assigned to your role.

Manually delete devices from Knox cloud services

1. Select one or more devices in the Devices page.

2. Click Actions > Delete device. This option is disabled if you don’t have the right permissions. The Delete device dialog displays.

3. (Optional) Enter a reason for deleting the devices, and click Delete.

A notification is shown to confirm whether the devices were successfully deleted or not.

• If the deletion is successful, the device is deleted from all supported services in the Knox Admin Portal, including Knox Remote Support.
• If the deletion fails or is only partially successful, you’ll see a notification with a link to download a CSV file containing information about each failed deletion.

Use a CSV file to delete devices in bulk

1. Open the BULK ACTIONS tab on the Devices page.
2. Click DELETE DEVICES. The Delete devices page displays. You can use the Download CSV template option to save a copy of the template, if required.
3. Click BROWSE to select the CSV file that lists the devices to be deleted.
4. Click Continue. The Delete device dialog displays.
5. Enter a reason for deleting the devices, and click Delete.

If the deletion is successful, the device is deleted from all supported services in the Knox Admin Portal, including Knox Remote Support. If the deletion fails or is only partially successful, you’ll see a notification with a link to download a CSV file containing more information.

Reassign license keys

In addition to viewing devices and their assigned licenses, you can also reassign different license keys to active or expired devices on the Devices page.

You can use this feature with devices that are assigned a license key for a Knox Suite Plan, Knox E-FOTA, Knox Asset Intelligence, Knox Manage, or Knox Manage for Wearables.

To reassign licenses:

1. Select one or more devices in the Devices page. You can select up to 100 devices. The Reassign license key page opens and lists the licenses you have access to.
2. Search for and select the license you want to reassign to your selected devices.
3. Click Assign.
4. (Optional) If more than one license seat may get assign to a device, the Duplicate license seats used dialog displays. To proceed, select Confirm to assign the license anyway. To remove the duplicate licenses, you must manually unenroll the device first.

The license are updated and the changes are shown in the common device list.

Assign Knox Mobile Enrollment profiles

Knox Mobile Enrollment is an automated EMM enrollment tool that helps you bulk-enroll corporate devices right out of the box. You can use Knox Mobile Enrollment profiles to define the EMM your device enrolls into, how the device gets enrolled, and what the devices can do during and after enrollment.

You can assign and unassign Knox Mobile Enrollment profiles to devices from the Devices page in Knox Admin Portal.

Assign a profile

1. Click Devices on the Knox Admin Portal navigation pane. The Devices page displays.
2. Select the devices to which you want to apply a Knox Mobile Enrollment profile.
3. Click Actions > Knox Mobile Enrollment > Assign profile. The Assign profile page opens and shows a list of available profiles.

   If no profile is available, click Create new profile. For more information, see Create profiles in the Knox Mobile Enrollment guide.

4. Select a profile and click Assign.

The profile is applied to the selected devices. If a profile was already assigned to a device, it is overridden by the new profile you just assigned.

Unassign a profile

1. On the Devices page, select the devices from which you want to remove profiles.
2. Click Actions > Knox Mobile Enrollment > Unassign profile. The Unassign Knox Mobile Enrollment profile dialog displays.
3. Click Unassign.

Assign Knox E-FOTA campaigns

Knox E-FOTA campaigns are used to apply firmware updates to devices. For more information see Introduction to campaigns.

You can manage the firmware updates from the Devices page in Knox Admin Portal by assigning or unassigning campaigns to selected devices.

Assign a campaign

1. Click Devices on the Knox Admin Portal navigation pane. The Devices page displays.

2. Select the devices to apply a Knox E-FOTA campaign.

3. Click Actions > Knox E-FOTA > Assign campaign. The Assign campaign page opens and shows a list of available campaigns. You can click a campaign to view detailed information.

   If no campaign is available, click Create campaign. For more information, see Create a campaign in the Knox E-FOTA guide.

4. Select a campaign and click Assign.

5. The Reassign campaign dialog displays if a device is already associated with a campaign. Click Reassign to assign the selected campaign instead.

The campaign is applied to the selected devices.

Unassign a campaign

1. On the Devices page, select the devices from which you want to remove a campaign.
2. Click Actions > Knox E-FOTA > Unassign campaign.
3. Click Unassign in the Unassign campaign dialog that displays.

Assign Knox Configure profiles

With Knox Configure profiles, you can configure settings, such as restrictions, apps, and content, for your enterprise devices when they’re deployed or updated. For more information see About Knox Configure profiles.

You can apply or remove Knox Configure profiles from devices using the Devices page.

Assign a profile

1. Click Devices on the Knox Admin Portal navigation pane. The Devices page displays.

2. Select the devices to apply a Knox Configure profile.

3. Click Actions > Knox Configure > Assign profile. The Assign profile page opens and shows a list of available profiles.

   If no campaign is available, click Create campaign. For more information, see Create a campaign in the Knox Configure guide.

4. Select a profile and click Assign.

5. (Optional) If a profile was already assigned to the selected devices, choose whether to continue using the current license for the new profile:

   • Click Keep licenses to use the current license with the new profile
   • Click Select new license to use a different license with the new profile

6. The Select license page opens. Select a license to use for the new profile and click Assign.

7. (Optional) If the license does not have enough seats for the number of devices you selected, use the Enter license key or Get a license options on the Select license page to get additional licenses. For more information, see Enter a license key and Get a license in the Knox Configure guide.

The profile is applied to the selected devices.

Unassign a profile

1. On the Devices page, select the devices from which you want to remove a profile.
2. Click Actions > Knox Configure > Unassign profile.
3. Click Unassign in the Unassign Knox Configure profile dialog.