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

LinkComputersToUnitGroupByName

The LinkComputersToUnitGroupByName API is used for linking array of computers identified by hostnames to a computer group.

Note: When the web service is connected to a domain manager, if you use this api to link a computer to a group replicated from the enterprise manager, an error is returned. On a domain manager the composition of only local groups (groups created in the domain manager) can be altered.

Parameters

xsd: string sessionId (m)

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

dsm: unitGroupPropertiesByName (m)

Specifies the unit group name to which the given computers need to be linked. It contains two fields: (a) unitGroupName - Used for specifying the name of the computer group to link (b) ObjectPreference - Used for specifying the preference.
If set to LOCALLY, this parameter searches for groups that are created locally. If set to REPLICATE, searches for replicated groups. This is applicable when DM is linked with EM.

arrayOfComputerPropertiesByName (m)

An array of computer hostnames that need to be linked to a specified unit group. It contains three fields: (a) computerName - hostname of the computer to be linked to group (b) ObjectPreference (c) domainName - This field is applicable when ObjectPreference is set to REPLICATE.

Return Values

This is a void method that does not expose a return value.

Remarks

None