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
...
Doc Feedback