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.
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:
On the Device groups page, select New Device Group in the upper-right corner of the page. The Create Device Group panel opens.
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.
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:
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:
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.
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
deviceNamesdon’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.