Groups

Groups allow you to target a set of devices based on a defined scope, such as location, client properties, or sensor data. Groups are commonly used for device targeting in both OneSite Anywhere and OneSite Health. In OneSite Patch, Business Units are the default as they have additional properties to standard Groups.

You can use Groups to select a set of machines to which you apply client settings, pre-stage content for content push policies, or apply targeted health policies and baselines.

To access Groups, click Assets > Groups from the side bar navigation from the Admin Portal.

This will open the Groups page showing all groups and if integrated with Microsoft Configuration Manager (ConfigMgr), ConfigMgr collections. When integrated with ConfigMgr, the collections and Groups will display together. To only see the Adaptiva Groups, select the Groups folder on the left or to see only the ConfigMgr Collections, select that folder in the left pane.

Group settings

When creating or modifying a Group, you will have multiple settings to configure. Below is a description of each setting and some possible use cases.

General settings

Name

• Choose a unique Name that helps identify your device group.

  • E.g. Adaptiva Developer Clients.

Description

• Optionally, you can add a description to add additional context.

Evaluation Schedules

• Membership Evaluation evaluates new client Devices to assess if they belong to a particular Group. By default, Membership Evaluation is triggered upon saving your Group and will only run once. You can periodically run Membership Evaluation again based on a chosen Schedule.

• Use case

  • You have a Group that is comprised of Linux devices. The schedule you have chosen runs Membership Evaluation daily at 4 AM. A new Linux device is added to your organization at 2 PM on Monday, but does not yet belong to a particular Group. At 4 AM Tuesday Membership Evaluation is run and thus your new Linux device is now added to your Linux Group.

Group scopes

With Group Scopes you can scope devices by Location, SQL query, Sensor, and by directly selecting desired Devices.

Multiple Group Scopes can be selected at a time, however, we recommended to primarily use SQL queries and Sensors for a more comprehensive approach.

You can verify your scope by clicking Save to save the new Group and then Show Members > Evaluate Memberships in the Group Scopes section.

Locations

• You can browse and choose a Location that will add all of the Location's Devices to this Group.

• Use case

  • You have created a new Location and want to create a new Group based off of this Location's Devices.

SQL Queries

SQL Queries is an advanced setting, please reach our to our Support team for assistance. We recommend that you create, run, and debug any query in SQL Management Studio to ensure that it works as intended. For all SaaS solutions, this will require our Support team to build the query.

• For on-premises solutions, SQL Queries allow you to more granularly add Devices to a group based on specific queried Device properties.

• Examples:

  • This query returns the adaptivaclientid for all records where the machine_name matches any name specified in the IN list.

  SELECT adaptivaclientid
  FROM a_adaptivaclientdata
  WHERE machine_name IN (
    'machineA',
    'machineB',
    'machineC'
  );

  • This query finds all devices running a server OS in specified data centers and returns their device IDs.

  SELECT device_id 
  FROM a_AdaptivaClientDetails 
  WHERE operating_system LIKE '%server%' AND location IN (
    'datacenter1',
    'datacenter2',
    'datacenter3'
  );

Devices

• By clicking Browse you can see all available Devices from every Location. You can select multiple Devices from this table or search and sort to find specific Devices.

• Use case

  • You know exactly which devices you'd like to add to a Group, so you select Devices > Browse and select multiple Devices from the table.

Sensors

• Sensors allow you to gather data from or perform tasks on multiple endpoints simultaneously at scale.

• Use case

  • You have created a Sensor that retrieves details about the currently installed Operating System. You create a Group called Windows and choose the OperatingSystem Sensor under Group Scopes. After saving your Group, the Membership Evaluation will run. All devices that are found with a Windows OS, will be added to this Group.

  

Base Scope

• Base scope allows you to create logic gates to include or exclude certain Devices from your Group.

• Use case

  • You have Wi-Fi and VPN devices and would like to exclude Default devices from your group. You can select the OR operator and add an existing group for All WiFi Clients and All VPN Clients. This will add in both WiFi and VPN clients and exclude Default devices.

Creating a Group

In the example below, we'll be creating a new Group that will include only Windows client Devices and exclude Linux devices and will run daily at 2 AM.

This example will take approximately 5-10 minutes to complete.

1. Click + New to create a group and enter the following

   General Settings

   • Name

     • Enter Clients - Windows ONLY.

   • Description

     • For our example, we'll leave this blank since it is self-explanatory.

   • Evaluation Schedules

     1. Click Browse and select the Schedules folder then the select Daily at 2 AM schedule from the table.

     2. Click OK

        
2. Select Base Scope from the Group Scopes section.

3. Select Add Operator > NOT from the more options ellipses next to Select Operator.

   
4. Select Add Group from the more options ellipses.

5. Select existing Clients-Linux from the table.

6. Click OK.

   
7. Click Save

   
8. Select Show Members > Evaluate Membership to verify the correct client Devices were added to your Group. Since we have a schedule, this would trigger daily at 2 AM, but we can select Evaluate Membership to trigger immediately.

   

More Options

You can perform additional operations on the Group by clicking the More dropdown.

• New Group - Create a new group.

• Open Group - Open a group in a separate tab.

• Show Changes - Show the changes from the previous version.

• Save As - Save the group with a new name.

• Delete - Permanently delete the group.

• Export - Export the group as an .obex or .json file.

• Show References - View and change the group hierarchy.

• Manage Permissions - Apply custom permissions to the group.

• Sync Policies - Force the immediate sync of group policies.