GetDirectoryEntry

Returns a DirectoryEntry object for the Active Directory group account from Active Directory.

Syntax

DirectoryEntry GetDirectoryEntry()

Return value

The directory entry for the UNIX group profile associated with the Active Directory group.

Discussion

The DirectoryEntry object represents the service connection point associated with the group in the zone.

This method can only be used in .NET programs because DirectoryEntry is a .NET-specific class for directory objects. This method cannot be used in COM-based programs.

Exceptions

GetDirectoryEntry throws an ApplicationException if the directory object cannot be retrieved—for example, if it has not been committed.

Example

The following code sample illustrates using GetDirectoryEntry in a script:

...  
//Identify the group you want to work with
IGroup group = cims.GetGroup("LDAP://CN=oracle1, CN=Users, DC=ajax, DC=org");   
// Get the directory entry
DirectoryEntry groupEntry = group.GetDirectoryEntry();   
// Rename the group
groupEntry.Rename("CN=oracle_dbas");  
...