Menu

Bulk device operations

A properly formatted CSV file can be used to configure numerous devices in one bulk configuration operation. Bulk configuration operations options include assigning and un-assigning devices, pushing profile updates, device deletions, managing device tags, rebooting and factory resetting devices, and locking/unlocking devices.

To bulk configure devices, select the BULK ACTIONS button from the lower left-hand side of the Knox Configure dashboard, or any main menu item selected from the left-hand navigation menu.

If you need instructions on how to prepare a CSV file for any bulk device operation, select one of the options displayed within the Bulk actions screen and refer to the Instructions for all bulk actions link displayed on the lower, left-hand side, of the screen.

Follow the directions on both the left and right side of the screen for preparing a CSV file with one device ID per row, then upload the CSV file into the portal. Do not include any empty rows within the CSV file as instructed. Select the GOT IT button to move back to the screen selected from the Bulk actions screen.

Assign or un-assign devices in bulk

When necessary, administrators can lock or unlock up to 10,000 devices in a single CSV bulk lock operation. Available devices display within the Devices screen > DEVICES tab. Unassigned devices available for profile assignment are designated as Unassigned within the STATUS column. To list all devices, regardless of their state, refer to the CLEAR FILTER option at the bottom of the STATUS column drop-down menu.

For more information on assigning or un-assigning devices and their required device states, go to: Deploy devices

To assign or un-assign devices in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select either ASSIGN DEVICES or UNASSIGN DEVICES depending on your organization’s device assignment requirements.

  1. Browse for a properly formatted CSV file containing the existing device IDs you intend to assign or un-assign. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
  2. If assigning devices, select both the profile and license the assigned devices will use with Knox Configure. Optionally select Update configured devices without requesting end-user consent to assign devices without device user permission. By using this option, the user can still keep using their device while the IT admin makes the change or update. Once the update is made, IT admins can also check the status of the update without having to configure the user interface.
  3. Select SUBMIT to upload the file into the console. The change of the device state can be verified within the Devices screen by selecting the DEVICES tab and checking the STATUS column. The STATUS column can be filtered as needed.

Push profile updates in bulk

Admins can bulk update up to 10,000 device configuration profiles using a properly formatted CSV file and significant save time when devices require the same profile update.

For information on pushing individual device updates, go to: Deploy devices

To push device profile updates in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select PUSH PROFILE UPDATE.

 

  1. Browse for a properly formatted CSV file containing the IDs of the devices whose profile you intend to update. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
  2. Within the Select items to push field, select whether Only changed items are updated for device profile pushes, or if a Full profile update is required to update the entire device profile.
  3. Optionally select Push update without requesting end-user consent to update device profiles without device user permission.
  4. Select PUSH NOW to upload the file into the console without delay. Select SCHEDULE to upload the new device profile assignments at an admin determined time. The change of the device state can be verified within the Devices screen by selecting the DEVICES tab and checking the STATUS column. The STATUS column can be filtered as needed.

Delete devices in bulk

Admins can upload a CSV file to delete up to 10,000 devices from Knox Configure administration. If any of the deleted devices are using a Dynamic (Per seat) license, the associated license seats are revoked, and available to assign to other devices.

To delete devices in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select DELETE DEVICES.

  1. Browse for a properly formatted CSV file containing the device IDs you intend to delete from Knox Configure. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
  2. Select SUBMIT to upload the file into the console. The change of the device state can be verified within the Devices screen by selecting the DEVICES tab and checking the STATUS column. The STATUS column can be filtered as needed.

Manage tags in bulk

Tags can be optionally applied to specific devices to provide more refined search criteria when numerous Knox Configure managed devices share configuration attributes and are difficult to distinguish from one another. Up to 10,000 devices can have their tags bulk managed using a properly formatted CSV file.

Devices must be in an unassigned, profile assigned, error, cancelled by user, configured, failed to configure, updates pushed, or locked state to have tags managed in bulk with a CSV file.

To manage device tags in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select MANAGE DEVICE TAGS.

  1. Browse for a properly formatted CSV file containing the device IDs whose tags you intend to manage. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
  2. Configure the CSV file with device IDs in one column and the tags to apply to a listed ID in the second column.
  3. Select the Overwrite existing tags option to overwrite existing device tag assignments with the tags in the uploaded CSV file.
  4. Select SUBMIT to upload the file into the console. The change of the device state can be verified within the Devices screen by selecting the DEVICES tab and checking the STATUS column. The STATUS column can be filtered as needed.

Reboot or factory reset devices in bulk

Admins can bulk reboot or factory reset up to 10,000 devices using either a Setup or Dynamic edition Knox Configure profile with a CSV file. A reboot push command can be triggered by an admin without the device user's consent.

To reboot or factory reset devices in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select REBOOT/FACTORY RESET DEVICES.

 

  1. Browse for a properly formatted CSV file containing the device IDs you intend to reboot or factory reset. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
  2. Refer to the Select action field and determine whether this bulk update is intended to Reboot devices or Factory reset devices.
  • Reboot devices(s) — The device will be reset and maintain configurations previously set by the IT admin.
  • Factory reset device(s) — The device will be reset to factory standard specifications. This means the device will have no restrictions or customization once reset and will need to be configured again.
  1. Select SUBMIT to upload the file into the console. The change of the device state can be verified within the Devices screen by selecting the DEVICES tab and checking the STATUS column. The STATUS column can be filtered as needed.

Lock or unlock devices in bulk

When necessary, administrators can lock or unlock up to 10,000 devices in a single CSV bulk lock operation. When a device locks, contact information (company name, phone number and Email) displays within the lock screen to assist the device user unlock their device. Additionally, the device's locked status displays within both the Knox Configure Dashboard and Profiles tab.For information on locking individual devices, go to: Lock and unlock devices.

To bulk lock or unlock devices in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select either LOCK DEVICES or UNLOCK DEVICES depending on your organization’s requirements.

 

  1. Browse for a properly formatted CSV file containing the device IDs you intend to lock or unlock. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
  2. Select SUBMIT to upload the file into the console. The change of the device state can be verified within the Devices screen by selecting the DEVICES tab and checking the STATUS column. The STATUS column can be filtered as needed.

Map devices to Custom IDs in bulk

A custom ID is an ID that you create to map to an IMEI or SN, which are no longer accessible by device apps that are not DO or PO. Company apps deployed through KC can use it to identify the company approved device and allow use only for these devices.

NOTE—Custom IDs can only be used for devices with Knox version 3.7 or higher.
NOTE—Starting from Android 10 (Q OS), device ID information (that is, the IMEI or serial number) cannot be obtained by third-party apps (partner apps) due to changes in Android’s privacy and security policies. The READ_PRIVILEGED_PHONE_STATE permission is only granted to apps signed with the platform key and privileged system apps..

Custom IDs can be updated easily either individually for a device or in bulk. To see how to update it for a single device, see Device details and logs.

To update Custom IDs in bulk:

  1. Select BULK ACTIONS from the bottom of the left-hand navigation menu.
  2. Select CUSTOM ID, it is the last item in the screen (you might have to scroll down to see it).

  1. Browse for a properly formatted CSV file containing the device IDs in first column and unique Custom ID in second. If needed, select the Download CSV template link to utilize an existing template for easier creation and submission of the CSV file.
    NOTE—The devices must pre-exist in your account for the successful operation.
  2. Select SUBMIT to upload the file into the console. The update can be verified within the Devices screen by selecting the DEVICES tab and checking the Device details column in Devices > Device ID. The columns in Devices tab can also be edited to show devices by Custom ID. To do this, click on three dots and check Custom ID. You can also search devices using custom ID.