directoryentry（DirectoryEntry简介）

DirectoryEntry是.NET Framework中的一个类，用于访问和操作Active Directory（AD）中的对象。它可用于创建、修改和删除AD中的对象，例如用户、组、计算机等。在本文中，我们将深入探讨DirectoryEntry的用途、特性和使用方法。

DirectoryEntry的用途

DirectoryEntry可用于多种任务，例如：

1.创建和管理用户账户

您可以使用DirectoryEntry来创建和管理AD中的用户账户。例如，以下代码片段创建一个新的用户账户： ```csharp // 创建一个新的DirectoryEntry对象来表示新账户的属性 DirectoryEntry newUser = new DirectoryEntry(\"LDAP://CN=John Smith,OU=Users,DC=domain,DC=local\"); // 设置新用户的属性 newUser.Properties[\"givenName\"].Add(\"John\"); newUser.Properties[\"sn\"].Add(\"Smith\"); newUser.Properties[\"userPrincipalName\"].Add(\"john.smith@domain.local\"); newUser.Properties[\"samAccountName\"].Add(\"jsmith\"); newUser.Properties[\"password\"].Value = \"password123\"; newUser.Properties[\"userAccountControl\"].Value = 512; // 启用账户 // 将新账户保存到AD中 newUser.CommitChanges(); ```

2.创建和管理组

您可以使用DirectoryEntry来创建和管理AD中的组。例如，以下代码片段创建一个新的组： ```csharp // 创建一个新的DirectoryEntry对象来表示新组的属性 DirectoryEntry newGroup = new DirectoryEntry(\"LDAP://CN=My Group,OU=Groups,DC=domain,DC=local\"); // 设置新组的属性 newGroup.Properties[\"displayName\"].Add(\"My Group\"); newGroup.Properties[\"groupType\"].Value = 2; // 安全组 newGroup.Properties[\"sAMAccountName\"].Add(\"mygroup\"); // 将新组保存到AD中 newGroup.CommitChanges(); ```

3.搜索AD对象

您可以使用DirectoryEntry来搜索AD中的对象。例如，以下代码片段搜索所有OU并输出其名称： ```csharp // 创建一个表示AD根目录项的DirectoryEntry对象 DirectoryEntry rootEntry = new DirectoryEntry(\"LDAP://rootDSE\"); // 获取默认的命名上下文 string defaultNamingContext = rootEntry.Properties[\"defaultNamingContext\"][0].ToString(); // 创建一个新的DirectoryEntry对象来表示整个AD DirectoryEntry adEntry = new DirectoryEntry(\"LDAP://\" + defaultNamingContext); // 设置搜索属性和搜索条件 DirectorySearcher searcher = new DirectorySearcher(adEntry); searcher.Filter = \"(objectClass=organizationalUnit)\"; // 执行搜索并输出结果 SearchResultCollection results = searcher.FindAll(); foreach (SearchResult result in results) { Console.WriteLine(result.Properties[\"name\"][0].ToString()); } ```

DirectoryEntry的特性

DirectoryEntry具有以下特性：

1.可用于访问多种AD目录服务

使用DirectoryEntry，您可以访问各种AD目录服务，例如Active Directory域服务（ADDS）和Active Directory Lightweight Directory Services（AD LDS）。这使得DirectoryEntry成为操作AD的通用类。

2.可通过LDAP路径直接访问对象

您可以使用LDAP路径直接访问AD中的对象。这使得DirectoryEntry具有速度和效率的优势。例如，您可以使用以下代码访问某个组的属性： ```csharp // 创建一个新的DirectoryEntry对象来表示组 DirectoryEntry groupEntry = new DirectoryEntry(\"LDAP://CN=My Group,OU=Groups,DC=domain,DC=local\"); // 输出组名称 Console.WriteLine(\"Name: \" + groupEntry.Properties[\"name\"][0].ToString()); // 输出组成员 foreach (object member in groupEntry.Properties[\"member\"]) { // 创建一个新的DirectoryEntry对象来表示组成员 DirectoryEntry memberEntry = new DirectoryEntry(\"LDAP://\" + member); // 输出成员名称 Console.WriteLine(\"Member: \" + memberEntry.Properties[\"name\"][0].ToString()); } ```

3.支持属性缓存

DirectoryEntry支持属性缓存，可显著提高AD访问速度。默认情况下，DirectoryEntry在每次访问属性时都会向AD发出请求以获得属性值，这可能导致性能下降。但是，您可以通过启用属性缓存来避免这种情况。例如，以下代码片段启用了属性缓存： ```csharp // 创建一个表示AD根目录项的DirectoryEntry对象 DirectoryEntry rootEntry = new DirectoryEntry(\"LDAP://rootDSE\"); // 获取默认的命名上下文 string defaultNamingContext = rootEntry.Properties[\"defaultNamingContext\"][0].ToString(); // 创建一个新的DirectoryEntry对象来表示整个AD DirectoryEntry adEntry = new DirectoryEntry(\"LDAP://\" + defaultNamingContext); // 启用属性缓存 adEntry.UsePropertyCache = true; // 读取用户的displayName属性（属性将被缓存） Console.WriteLine(adEntry.Properties[\"CN=John Smith,OU=Users,DC=domain,DC=local\"][\"displayName\"].Value.ToString()); // 再次读取用户的displayName属性（属性将从缓存中读取） Console.WriteLine(adEntry.Properties[\"CN=John Smith,OU=Users,DC=domain,DC=local\"][\"displayName\"].Value.ToString()); ```

DirectoryEntry的使用方法

使用DirectoryEntry，您可以执行各种AD操作。以下是使用DirectoryEntry的基本步骤：

1.创建DirectoryEntry对象

要使用DirectoryEntry，您需要创建一个表示AD对象的DirectoryEntry对象。以下代码创建一个表示某个组的DirectoryEntry对象： ```csharp DirectoryEntry groupEntry = new DirectoryEntry(\"LDAP://CN=My Group,OU=Groups,DC=domain,DC=local\"); ```

您可以向DirectoryEntry构造函数中提供LDAP路径、LDAP分级名称（DN）或GUID以创建对象。

2.设置属性

要设置属性，您需要访问属性集合并使用其中的方法来设置值。以下代码设置某个组的displayName属性： ```csharp DirectoryEntry groupEntry = new DirectoryEntry(\"LDAP://CN=My Group,OU=Groups,DC=domain,DC=local\"); groupEntry.Properties[\"displayName\"].Value = \"My Group\"; ```

3.执行操作

要执行操作，您需要调用DirectoryEntry的方法。以下代码将新组保存到AD中： ```csharp DirectoryEntry newGroup = new DirectoryEntry(\"LDAP://CN=My Group,OU=Groups,DC=domain,DC=local\"); newGroup.Properties[\"displayName\"].Add(\"My Group\"); newGroup.Properties[\"groupType\"].Value = 2; // 安全组 newGroup.Properties[\"sAMAccountName\"].Add(\"mygroup\"); newGroup.CommitChanges(); ```

总结

DirectoryEntry是.NET Framework中的一个强大的类，可用于访问和操作Active Directory中的对象。它可用于创建、修改和删除AD中的对象，例如用户、组、计算机等。使用DirectoryEntry，您可以访问各种AD目录服务，例如ADDS和AD LDS，以及通过LDAP路径直接访问对象。DirectoryEntry还支持属性缓存，可提高AD访问速度。总的来说，DirectoryEntry是操作AD的不可或缺的工具。