Web Services Reference › Methods › Units and Groups › Unit Groups › CreateUnitGroup2

CreateUnitGroup2

Creates a unit group. If you do not specify the the parent group, the new unit group is created under the group Computers and Users. You can link existing computers to the newly created unit group by specifying their UUIDs, or you can link all discovered computers to the unit group. You can attach a query, specified by its uuid, to the newly created group for evaluating the group members.

Note: When the parameter computerUUIDS is specified and linkAllComputers is set to true, the parameter linkAllComputers takes precedence, which means that computerIds are ignored and all computers discovered under the domain or enterprise are linked to the newly created group. When the query to be linked to the group is specified (to create a dynamic group) and the computers to be associated with the group are also specified (to create a static group), the API returns an error.

Parameters

xsd:string sessionId (m)

Specifies the session id obtained from the login to the web service.

xsd:string parentUnitGroupId

Specifies the UUID of the parent group for the unit group to be created. By default, the “Computer and User” group is set as the parent group.

CreateUnitGroupProperties2 createUnitGroupProperties (m)

Specifies the properties required to create a unit group. Setting all the structure members is not mandatory.

ArrayOfstring computerUUIDS

Specifies the list of computer uuids to be linked to the group.

xsd:boolean linkAllComputers

Links all registered computers in the domain or enterprise to the group. If set to true the value of parameter computerUUIDs is ignored.

Return Values

xsd:string uuidOfCreatedUnitGroup

Indicates the UUID of the new unit group, if created successfully.

Remarks

If parameter computerUUIDS is assigned a value (that is, the list of computer uuids is provided and the parameter linkAllComputers is set to true) the value of linkAllComputers overrides the value of parameter computerUUIDS

If the query to be linked to the group (which creates a dynamic group) and the computers to be associated with the group (which creates a static group) are both specified at the same time the API returns an error.

More information:

CreateUnitGroupProperties2