Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. IT Analytics Help
  3. Section XVI. System Administration
  4. Automating Host Group Management
  5. Organize clients by attribute

Organize clients by attribute

Description

This groupClientsbyAttributes utility enables you to organize clients within a host group, based on client attributes. This utility will create host groups named for each attribute value, underneath a parent host group, as shown in the following example.

Example of Organizing Clients by Geographical Location:

Create a host group named Geography. This will be the destination group that will be used to organize the clients by location.

Then, create an attribute named Geography.

For a subset of a host group's clients, set their Geography attribute value to London and for another subset of clients, set their Geography attribute to New York.

Use the following groupClientsbyAttributesutility to organize the clients that have a Geography attribute configured.

execute server_mgmt_pkg.groupClientsbyAttributes(300000, 302398, 1, StringObjectListType(stringObjectType('Geography')));

Where 300000 is the group ID of the root group, Global; 302398is the ID of the Geography group you just created.

Additional References:

See Identifying a host group ID.

Usage

execute server_mgmt_pkg.groupClientsbyAttributes(<source_Group_ID>, <destination_group_ID>, <cascade_Source_Group>, StringObjectListType(<attribute_List>));

Where:

source_Group_ID is the numeric identifier of the host group for which you want to group the clients.

See Identifying a host group ID.

for the steps for finding a group ID.

destination_group_ID is the numeric identifier of the group under which you want to group the clients.

cascade_Source_Group is a numeric flag that indicates if you want this utility to process the source host group's sub-groups and organize those clients in the destination group.

attribute_Listis a comma-separated list of attribute names, each enclosed in straight single quotes. These names are used to create the sub-groups that organize the clients underneath the source group.

Feedback

Was this page helpful?
Previous

Move or copy clients

Next

Move host group

Feedback

Was this page helpful?