Returns the UNIX group profile for a group with the specified name in the zone.


IGroupUnixProfile GetGroupUnixProfileByName(string name)


Specify the following parameter when using this method:

Parameter Description


The name of the UNIX group profile for which you want to retrieve information.

Return value

The GroupUnixProfile object for the specified group name in the selected zone, or null if no group unix profile is found.


The name you specify should be the UNIX group name for the group if it differs from the Active Directory name for the group.


GetGroupUnixProfileByName may throw one of the following exceptions:

  • NotSupportedException if the zone schema is not supported.
  • ApplicationException if there is more than one instance of the specified group in the zone.


The following code sample illustrates using this method in a script:

'Specify the zone you want to work with
set objZone = cims.GetZone("")
'Get the UNIX profile for the group “berlin_qa”
set objGrp = objZone.GetGroupUnixProfileByName(“berlin_qa”)
'Display the GID for the group “berlin_qa”
wScript.Echo “GID: “ & objGrp.GID