HOW TO: 使用目录服务和 Visual C# .NET 向本地系统添加用户

本文的发布号曾为 CHS306273
有关本文的 Microsoft Visual Basic .NET 版本,请参见 306271

本任务的内容

概要
本文介绍如何使用 DirectoryServices 命名空间将用户添加到本地系统和组。

返回页首

要求

  • Microsoft Windows XP、Windows 2000 或 Windows NT 4.0
  • Visual C# .NET
返回页首

创建示例

  1. 打开 Microsoft Visual Studio .NET,然后新建一个 Visual C# Console 应用程序项目。
  2. 在“解决方案资源管理器”中,右键单击引用,然后单击添加引用
  3. 添加一个对 System.DirectoryServices.dll 程序集的引用。
  4. 将 Class1.cs 中的代码替换为下面的代码:
    using System;using System.DirectoryServices;class Class1{static void Main(string[] args)    {try        {	 DirectoryEntry AD = new DirectoryEntry("WinNT://" + 	                     Environment.MachineName + ",computer");	 DirectoryEntry NewUser = AD.Children.Add("TestUser1", "user");	 NewUser.Invoke("SetPassword", new object[] {"#12345Abc"});	 NewUser.Invoke("Put", new object[] {"Description", "Test User from .NET"});	 NewUser.CommitChanges();	 DirectoryEntry grp;	 grp = AD.Children.Find("Guests", "group");	 if (grp != null) {grp.Invoke("Add", new object[] {NewUser.Path.ToString()});}	 Console.WriteLine("Account Created Successfully");	 Console.ReadLine();	}    catch (Exception ex)	{	 Console.WriteLine(ex.Message);	 Console.ReadLine();	}    }}
  5. 编译并运行该项目。
  6. 在基于 Windows 2000 的计算机上按以下步骤操作,验证帐户已创建并已添加到 Guest 组中:

    1. 开始菜单,指向程序,再指向管理工具,然后单击计算机管理
    2. 单击本地用户和组节点将其展开。 新帐户将显示在用户节点下面,同时会显示在 Guest 组的节点下面。
    在基于 Windows XP 的计算机上按以下步骤操作,以验证帐户已创建并已添加到 Guest 组中:
    1. 开始菜单,单击控制面板
    2. 双击用户帐户。 新用户帐户将显示在用户帐户对话框中。
  7. 重要的是,测试完后要从系统中删除新创建的用户帐户。
返回页首

代码说明

创建新目录项

创建本示例中的目录项时,假定系统正在运行 Microsoft Windows NT、Windows 2000 或 Windows XP。 注意,向 DirectoryEntry 构造函数传递以“WinNT://”开头的字符串。 您还可以在其他第三方操作系统上运行“目录服务”。
DirectoryEntry AD = new DirectoryEntry("WinNT://" + SystemInformation.ComputerName + ",computer");

向目录树添加目录项

以下代码在 Active Directory 树中添加了一个 user 类型的、值为 TestUser1DirectoryEntry
DirectoryEntry NewUser = AD.Children.Add("TestUser1", "user");

设置新用户帐户的密码和说明

以下代码调用 Invoke 方法来调用 DirectoryEntry 对象的 SetPasswordPut 方法。 这将为用户帐户设置密码并分配说明。 此代码还调用 CommitChanges 方法保存这些更改。
NewUser.Invoke("SetPassword", new object[] {"#12345Abc"});NewUser.Invoke("Put", new object[] {"Description", "Test User from .NET"});NewUser.CommitChanges();

将帐户添加到组

将帐户添加到组的第一步是定义 DirectoryEntry 类型的变量。 然后调用 ActiveDirectoryChildren 成员的 Find 方法来填充变量。 在这种情况下,Guest 组是搜索目标。 此代码测试 Find 方法返回的值以确定是否已找到该组。 如果找到该组,新用户帐户便会添加到组中。
DirectoryEntry grp;grp = AD.Children.Find("Guests", "group");if (grp != null) {grp.Invoke("Add", new object[] {NewUser.Path.ToString()});}
返回页首

疑难解答

若尝试运行本文中的代码时没有足够的权限来创建用户帐户,则这些代码会失败。 若要使这些代码成功完成,当前登录的用户必须是 Administrators 组的成员或者拥有创建用户帐户的特定权限。

返回页首
属性

文章 ID:306273 - 上次审阅时间:02/24/2002 21:42:00 - 修订版本: 1.0

Microsoft Visual C# .NET 2002 标准版

  • kbhowto kbhowtomaster KB306273
反馈