GetGroupByPath
Returns an Active Directory group object with all of its related Centrify-specific data given the path to the object.
Syntax
IGroup GetGroupByPath(string path)
Parameter
Specify the following parameter when using this method:
Parameter | Description |
path |
The LDAP path or distinguished name of the group object you want to retrieve. |
Return value
The group object as:
Centrify.DirectControl.API.IGroup
Discussion
This method returns the group object using the LDAP path or distinguished name of the object. The LDAP path to a group uses the following format:
LDAP://[domain/]attr=name,[...],dc=domain_part,[...]
For example, if you use the default parent location for groups in the domain arcade.com, the LDAP path for the IT Interns group is:
LDAP://cn=IT Interns,cn=Users,dc=arcade,dc=com
The method returns the group object as Centrify.DirectControl.API.Group.ObjectName.
Exceptions
GetGroupByPath throws an ArgumentException if the group path is null or empty.
Example
The following code sample illustrates using this method in a script:
...
string strParent = "CN=zones,CN=Centrify,CN=Program Data";
if (args.Length != 2)
{
Console.WriteLine("Usage:");
Console.WriteLine(" test_remove_group.exe \"cn=sample_group,ou=groups,dc=domain,dc=tld\" \"default\"");
return;
}
string strGroup = args[0];
string strZone = args[1];
//Need to obtain an active directory container object
DirectoryEntry objRootDSE = new DirectoryEntry("LDAP://rootDSE");
DirectoryEntry objContainer = new DirectoryEntry("LDAP://" + strParent + "," + objRootDSE.Properties["defaultNamingContext"].Value.ToString());
string strContainerDN = objContainer.Properties["DistinguishedName"].Value as string;
//Create a CIMS object to interact with AD
ICims cims = new Cims();
//Note the lack of the cims.connect function.
//By default, this application will use the connection to the domain controller
//and existing credentials from the computer already logged in.
//Get the group object
IGroup objGroup = cims.GetGroupByPath(strGroup);
//Get the zone object
IZone objZone = cims.GetZoneByPath("cn=" + strZone + "," + strContainerDN);
...