GetGroupUnixProfileByName

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

Syntax

IGroupUnixProfile GetGroupUnixProfileByName(string name)

Parameter

Specify the following parameter when using this method:

Parameter Description

name

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.

Discussion

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

Exceptions

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.

Example

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

...
'Specify the zone you want to work with
set objZone = cims.GetZone("ajax.org/UNIX/Zones/test_lab")
'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
...