GetGroupUnixProfile
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 ...