Skip to navigation

Manage device groups

A device group is a named set of devices that golden configuration trees, compliance plans, and Studio workflow tasks target as a single unit. You can build a group from Inventory Manager tags or from device names. You can also see which trees and plans use each group and how its devices performed in their latest compliance checks.

How device groups work with Inventory Manager tags

Keep these behaviors in mind when you build and maintain a device group:

  • Membership is a snapshot: A group contains the devices you selected when you saved it. If tags or inventories change later in Inventory Manager, the group doesn’t update. To bring a group up to date, add devices to it again.
  • Devices can come from more than one source: One group can hold devices you selected by name and devices you selected by Inventory Manager tag, including devices from more than one inventory.
  • Access control applies: You can only see and select the inventories, tags, and devices that your Inventory Manager permissions allow.
  • Consumers don’t change: Golden configuration trees, compliance plans, and Studio tasks use a tag-built group the same way they use any other device group.

Before you begin

Before you work with device groups, confirm that:

  • You have access to Configuration Manager.
  • To build groups from tags, the devices you want are in an inventory in Inventory Manager and have tags applied. See Tags and organization.
  • Your Inventory Manager permissions give you access to the inventories and tags you want to use. See Security and access control.

View device groups

To see all device groups, select Device Groups from the Configuration Manager left navigation bar. The Device groups page opens with a list of every group you can access. To view device groups through the Collection window instead, expand the Device Groups navigation category using the arrow on its left and select the View All <#> Results button from the bottom of the expanded list.

Device groups page

On the Device groups page, use the search box above the upper-right corner of the list to find a group by name, description, OS mix, or tag. You can sort the group list by Name, Status, and Last Run by selecting the relevant column’s header. You can also filter the list by Status, OS Mix, Tags, and Last Run by selecting the filter icon to the left of the relevant column’s header.

Create a device group

Configuration Manager provides two ways to create a device group: the Create Device Group panel and the Create modal.

There is no way to modify a device group’s metadata, including its name and description, after creation. Ensure these fields are set as desired when creating a device group.

Use the Create Device Group panel

The Create Device Group panel lets you name the group and select its devices by name or by Inventory Manager tag during the creation process. To create a device group this way:

1

On the Device groups page, select New Device Group in the upper-right corner of the page. The Create Device Group panel opens.

2

Enter a group name and optionally a description.

3

Select devices using one or both tabs:

  • Name: Lists every device available to you, with its Device OS and Source. Search the list, or filter and sort by name, device OS, or source. Select the checkbox for each device you want to add.
  • Inventory Tags: Select an Inventory, then select one or more Tags. The table lists the devices in that inventory that match the selected tags. To narrow the results, filter by Device Name or Device OS. Select the checkbox for each device you want to add, or select the checkbox in the header row to select every device in the list.

To add devices from another inventory, select a different Inventory and repeat. Devices you’ve already selected stay selected when you switch inventories.

If you want to see all of the inventory tags assigned to a device, view the device’s details page. See View and manage devices to learn more.
4

Select Create in the bottom-right corner of the panel.

The new group appears on the Device groups page with a status of Not Run.

Use the Create modal

To create a device group with the Create modal:

1

In Configuration Manager, select the Create (+) button at the top of the left navigation bar.

2

In the Create modal, select Device Group from the dropdown.

3

Enter a name and optionally a description.

4

Select the Create button at the bottom of the modal. The device group’s details page opens.

When you create a device group using the Create modal, you have to add devices to the group after creation.

Device group view

To view a group’s details, select its name on the Device groups page. The top of the details page summarizes the group. Below the summary, the Devices and Recent activity tabs show the group’s members and compliance history, respectively.

Devices tab

The Devices tab lists every device in the group. From this page you can:

  • View devices from Inventory Manager in the format <inventory-name>::<device-name>. Select a device’s name to navigate to its device details page.
  • Remove devices from the group using the Remove button under the Actions column.
  • Search by name, device OS, or source, and sort or filter any column. Change the number of devices shown at once using the Items per page dropdown in the bottom-left corner of the page.

Recent activity tab

The Recent activity tab lists each golden configuration tree and compliance plan that uses the group. A row appears as soon as you add the group to a tree or plan, even before any compliance check runs.

Compliance plans and golden configuration trees are listed in the format Golden Configuration: <tree-name> or Compliance Plan: <plan-name>. Each entry links to the golden configuration tree’s details page or the compliance plan’s details page. You can sort and filter the table by any column, or use the search bar above the right side of the table.

The columns show compliance details as of the most recent compliance check. If no check has been run, the Status column shows Not Run. Otherwise, it shows Compliant if every device is compliant, and Non-Compliant if even one device fails compliance. Non-compliant devices in the Result column include devices that failed compliance checks as well as devices that failed to connect.

The Recent activity tab gives summary information only. To see which devices failed compliance and which failed to connect, select the tree or plan and open its compliance report.

Add devices to a group

To add devices to a group:

1

Select Add Devices from the upper-right corner of the page. The Add Devices to Group panel opens.

2

Select devices on the Name tab, the Inventory Tags tab, or both. Step 3 of Use the Create Device Group panel describes how to use these tabs.

3

Select Add Devices in the lower-right corner of the panel.

A confirmation message shows how many devices were added to the group.

Remove devices from a group

Removing a device takes it out of the group only. The device stays in its inventory or source system.

  • Remove one device: On the Devices tab, select Remove in the device’s row.
  • Remove several devices: Select the checkbox for each device, then select the delete icon above the table.

Delete a device group

You can’t delete a device group while a golden configuration tree or compliance plan uses it. Configuration Manager returns an error if you try. Remove the group from each tree and plan listed on its Recent activity tab first.

To delete a group, open it and select Delete. Deleting a group doesn’t delete its devices.

Device groups in Studio workflows

The Create Device Group and Add Devices to Group Studio tasks have inventoryTags and deviceNames inputs. To use the inventoryTags input, select an Inventory, then select one or more tags. When the task runs, it adds the devices in that inventory that match the selected tags.

Keep these behaviors in mind:

  • One inventory per task: Each task covers one inventory. To add devices from several inventories, add an Add Devices to Group task for each additional inventory.
  • Both inputs are optional: If you set deviceNames, inventoryTags, or both, the task adds those devices. If you leave both empty, Create Device Group creates a group with no devices.
  • Existing workflows keep working: Workflows that use only deviceNames don’t need changes.

If the user running the task doesn’t have access to the selected inventory, the task uses a different inventory that the user can access and adds devices from it. The group can end up with devices you didn’t intend to include. Make sure the account that runs the workflow has access to the inventory selected in the task.

Upgrade behavior for Platform 6.7

Upgrading to Platform 6.7 doesn’t delete any device group data, including associations with golden configurations and compliance plans. However, existing groups don’t show compliance runs from before the upgrade. They show Not Run until a new compliance check runs, even if the group was checked previously.