Adds a partial profile for the specified group to the zone.


IHierarchicalGroup AddGroupPartialProfile(DirectoryEntry groupDE)
IHierarchicalGroup AddGroupPartialProfile(SearchResult groupSR)
IHierarchicalGroup AddGroupPartialProfile(string groupDn)
IHierarchicalGroup AddGroupPartialProfile(IAdsGroup groupIAds)


Specify one of the following parameters when using this method.

Parameter Description


The directory entry for the group for which you want a partial profile.


The directory entry for a group specified as a search result.


The group specified as a distinguished name.


The IADs interface to the group.

Return value

The hierarchical group object that represents the group profile.


This method creates a new group profile with values set for the Cims and Group properties. If the zone is an SFU zone, then this method also sets a value for the NISDomain property. You can then add other properties to the profile.

The profile is not stored in Active Directory until you call the Commitmethod.

The AddAccessGroup(DirectoryEntry groupDE) and AddAccessGroup(SearchResult groupSR) methods are available only for .NET-based programs; call Userfor VBScript.


If you pass a null parameter, AddGroupPartialProfile throws the exception ArgumentNullException.


The following code sample illustrates using the AddGroupPartialProfile method in a script:

// Get the zone object
IHierarchicalZone objZone = cims.GetZoneByPath("cn=" + strZone + "," + strContainerDN) as
// Load the unix profiles associated with the group
// Determine if the specified group is already a member of the zone.
// This method will either return a blank objGroupUnixProfile
// or one containing data
IGroupUnixProfile objGroupUnixProfile;
if (objZone.GetGroupUnixProfileByName(strUnixGroup) == null)
    // Add this zone to the group
    objGroupUnixProfile = objZone.AddGroupPartialProfile(strGroup);
    objGroupUnixProfile.Name = strUnixGroup;
// Save