Returns the UNIX group profile for a specified group in the zone.
Syntax
IGroupUnixProfile GetGroupUnixProfile(IGroup group)
Parameter
Specify the following parameter when using this method:
| Parameter | Description |
|
group |
The group for which you want to retrieve profile information. |
Return value
The GroupUnixProfile object for the specified group in the zone.
Discussion
This method uses the Centrify.DirectControl.API.IGroup group returned by a Cims.GetGroup or Cims.GetGroupByPath call to retrieve the group profile.
Exceptions
GetGroupUnixProfile may throw one of the following exceptions:
- ArgumentNullException if the specified parameter value is null.
- 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")
'Identify the Active Directory group object
set objGrp = cims.GetGroupByPath("LDAP://CN=berlin_qa,CN=Users,DC=ajax,DC=org"))
set objGrpProfile = objZone.GetGroupUnixProfile(objGrp)
'Display the UNIX profile name for the group “berlin_qa”
wScript.Echo objGrpProfile.Name
...
Doc Feedback