Previous Topic: listSWP—List Software Policies Linked to Computer GroupNext Topic: Example


modify—Modify Computer Groups

The action allows you to modify computer groups.

This action has the following format:

compgroup action=modify 
name=group_name
[newName=new_name] 
[comment=comment] 
[{queryName=query |sdQuery=sdquery|noQuery}]
[engineName=engine_name
[enginePeriod=engine_evalution_frequence]]
[InheritPerms[={y|n}]]
comment

Specifies a comment.

Note: To erase an existing comment, enter the empty string ("").

engineName

Specifies the name of an engine that will process the group evaluation. If an empty string is coded then any engine can process the query

If currently no query is assigned to the group a warning is given and the parameter is ignored.

enginePeriod

Specifies in minutes the period in which the engine will re-evaluate the group. If not coded 1 min is assumed.

If currently no query is assigned to the group and no special engine to process the evaluation then a warning is given and the parameter is ignored.

inheritPerms

This optional parameter specifies if the group being modified is a security group or not.
If “InheritPerms=n” is coded then the specified group will not inherit permissions to its members and therefore is no security group any longer.
If “InheritPerms” or “InheritPerms=y” is coded then the specified group will inherit permissions to it members and therefore becomes a security group.
If the parameter is not coded then the permission inheritance settings of the group are not changed.

name

Specifies the name of a computer group to be modified.

newName

Specifies the new name of the computer group.

noQuery

A possibly coded query is deleted.

query

Indicates that the template is also a query group. The query coded has to be a USD 4.0 SP1 legacy query.

queryName

Specifies the name of the query to be used for evaluating the group.

sdQuery

Specifies the legacy query to be used for evaluation of the group. The query has to be compliant with SD 4.0 SP1.

Note: Parameters not coded will leave the related attributes unchanged.