Category filter

How to Add Device Groups via CSV?

Groups are an integral tool in managing users and endpoints in an organization. Organizing devices into groups enables IT administrators to efficiently manage the tasks at scale. For example, to deploy certain apps or policies to devices owned by users of a specific department. Here the groups should be categorized based on the departments of the organization. Policies in Hexnode can be targeted at device groups.

Besides manual device group creation and dynamic allocation of device group members, you can also bulk import devices to groups via a CSV file. This allows you to add a vast number of devices to a group without any hassle of manually adding individual devices. CSV import even allows you to create new groups and allocate members to an existing or new group.

To add bulk devices with a CSV,

  1. Login to your Hexnode UEM portal.
  2. Go to Manage.
  3. From Device Groups select Add Bulk Devices with CSV.

Follow the steps to complete the group creation.

1. Upload CSV

Upload a CSV file containing the group name, serial number/device ID/UDID/IMEI number of the member devices, and a description for the device group. You can add the device to either an existing group or a new group. You can also remove the current devices from the group prior to adding new ones.

Uploading the CSV file for bulk enrollment.

Notes:


If you are adding the device to an existing group, it will be added automatically. But if you have given a new group name in the CSV, the group will be created first, and then the devices will be added to it.


A sample CSV will be of the following format.

bulk enrollment with csv for device groups

  • groupname – It will be identified as name of the group.
  • members – It will be identified as the serial number / device ID / UDID / IMEI number of the devices to be added to the group.
  • description – It will be identified as the description of the device group.
Notes:


If you add multiple devices to a group, separate the member devices of the group using “semicolon” in the column named members in the CSV file.

2. Verify CSV

You can verify the details uploaded in the CSV file.

First, you have to map the CSV file attributes with that of the Hexnode device group. On proceeding, after uploading the CSV file, you will be asked to Map the Keys in the CSV with that of Hexnode’s. If your CSV file has the same column names as discussed earlier, the attributes will get automatically mapped. However, if your column names are different, you will have to manually map the keys.

Mapping keys of imported CSV file attributes with the device group.

If you select “members” from the drop-down against the “Group Name”, your “Group Name” will be identified in terms of the “members” listed in the CSV file. Similarly, if you choose “members” from the drop-down against the “Description” in the Map Keys pop-up. The group “Description” will be identified in terms of the “members” in the CSV file. If you are adding devices to an existing device group and require the existing devices in the group to be removed, you can check Remove existing devices in the group(s).

If you want to create a new device group, add the group name and the list of the devices in the CSV file. Then, check Create non-existing groups during CSV verification. This action will create a new group for you. If the group name is the same as that of an existing group, no new group gets created. The devices included in the CSV file will be merged with the existing group.

If you want to add a device to an existing group, state the name of the group into which you want the devices added and then uncheck Create non-existing groups.

Once you Map the Keys you can verify your CSV file.

Verify the keys and attributes of the CSV file uploaded for bulk enrollment.

3. Summary

The devices will be added to the groups and the final summary of the process will be shown here. Click on Finish to view the device groups with the devices added to it.

Added Bulk devices into device groups by uploading CSV file.

If you find your Status to be “updated partially” it means you either have a disenrolled or a device that is not yet enrolled in Hexnode, added to the group. Else, you have entered an incorrect serial number in the CSV file. Such devices will not be added to the group. The devices that were not added to the group will be listed under Devices Added Except the Ones With Serial Number/Device Id/UDID/IMEI Number.

Add bulk devices to a device group with/without removing existing members.

  • Managing Users and Groups