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