JAK: Dodawanie u�ytkownika do systemu lokalnego za pomoc� us�ug katalogowych i programu Visual C# .NET

Numer ID artyku�u: 306273 - Zobacz jakich produkt�w dotycz� zawarte w tym artykule porady.

Ten artyku� zosta� opublikowany wcze�niej pod numerem PL306273

Streszczenie

W tym artykule opisano, jak u�y� obszaru nazw DirectoryServices w celu dodania u�ytkownika do systemu lokalnego i do grupy.

Wymagania

System Microsoft Windows XP, Windows 2000 lub Windows NT 4.0
Program Visual C# .NET

Tworzenie przyk�adu

Otw�rz program Microsoft Visual Studio .NET i utw�rz nowy projekt aplikacji konsoli j�zyka Visual C#.
W oknie Solution Explorer kliknij prawym przyciskiem myszy folder References, a nast�pnie kliknij polecenie Add Reference.
Dodaj odwo�anie do zespo�u (assembly) System.DirectoryServices.dll.

Zast�p kod w pliku Class1.cs nast�puj�cym kodem:

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("U�ytkownikTestowy1", "user");
	 NewUser.Invoke("SetPassword", new object[] {"#12345Abc"});
	 NewUser.Invoke("Put", new object[] {"Description", "U�ytkownik testowy z .NET"});
	 NewUser.CommitChanges();
	 DirectoryEntry grp;

	 grp = AD.Children.Find("Go�cie", "group");
	 if (grp != null) {grp.Invoke("Add", new object[] {NewUser.Path.ToString()});}
	 Console.WriteLine("Utworzenie konta powiod�o si�");
	 Console.ReadLine();
	}
    catch (Exception ex)
	{
	 Console.WriteLine(ex.Message);
	 Console.ReadLine();

	}
    }
}

Skompiluj i uruchom projekt.
Wykonaj nast�puj�ce kroki na komputerze z systemem Windows 2000, aby sprawdzi�, czy konto zosta�o utworzone i dodane do grupy Go�cie:
1. Kliknij przycisk Start, wska� polecenie Programy, wska� polecenie Narz�dzia administracyjne, a nast�pnie kliknij polecenie Zarz�dzanie komputerem.
2. Rozwi� w�ze� U�ytkownicy i grupy lokalne. Nowe konto powinno pojawia� si� w folderze U�ytkownicy oraz w grupie Go�cie.
Wykonaj nast�puj�ce kroki na komputerze z systemem Windows XP, aby sprawdzi�, czy konto zosta�o utworzone i dodane do grupy Go�cie:
1. W menu Start kliknij polecenie Panel sterowania.
2. Kliknij dwukrotnie ikon� Konta u�ytkownik�w. Nowe konto u�ytkownika powinno pojawia� si� w oknie dialogowym Konta u�ytkownik�w.
Po zako�czeniu testowania usu� nowo utworzone konto z systemu.

Obja�nienie kodu

Utworzenie nowej pozycji katalogu

Przy tworzeniu nowej pozycji katalogu w tym przyk�adzie zak�ada si�, �e na komputerze jest uruchomiony system Microsoft Windows NT, Windows 2000 lub Windows XP. Zauwa�, �e ci�g, kt�ry jest przekazywany do konstruktora DirectoryEntry, zaczyna si� od �WinNT://�. Us�ugi katalogowe mo�esz r�wnie� uruchomi� w systemach operacyjnych innych firm.

DirectoryEntry AD = new DirectoryEntry("WinNT://" + SystemInformation.ComputerName + ",computer");

Dodanie pozycji katalogu do drzewa katalog�w

Nast�puj�cy kod dodaje pozycj� DirectoryEntry typu user z warto�ci� U�ytkownikTestowy1 do drzewa us�ugi Active Directory.

DirectoryEntry NewUser = AD.Children.Add("U�ytkownikTestowy1", "user");

Ustawienie has�a i opisu dla nowego konta u�ytkownika

Nast�puj�cy kod wywo�uje metod� Invoke w celu wywo�ania metod SetPassword i Put obiektu DirectoryEntry. Powoduje to przypisanie has�a i opisu do konta u�ytkownika. Ten kod wywo�uje r�wnie� metod� CommitChanges w celu zapisania zmian.

NewUser.Invoke("SetPassword", new object[] {"#12345Abc"});
NewUser.Invoke("Put", new object[] {"Description", "U�ytkownik testowy z .NET"});
NewUser.CommitChanges();

Dodanie konta do grupy

Pierwszym krokiem wykonywanym w celu dodania konta do grupy jest zdefiniowanie zmiennej typu DirectoryEntry. Nast�pnie zostaje wywo�ana metoda Find elementu Children klasy ActiveDirectory w celu wype�nienia tej zmiennej. W tym wypadku celem wyszukiwania jest grupa Go�cie. Ten kod testuje warto�� zwr�con� przez metod� Find w celu sprawdzenia, czy grupa zosta�a znaleziona. Je�li grupa zosta�a znaleziona, nowe konto u�ytkownika zostaje dodane do tej grupy.

DirectoryEntry grp;
grp = AD.Children.Find("Go�cie", "group");
if (grp != null) {grp.Invoke("Add", new object[] {NewUser.Path.ToString()});}

Rozwi�zywanie problem�w

Kod opisany w tym artykule nie dzia�a, je�li spr�bujesz uruchomi� go bez wystarczaj�cych uprawnie� do tworzenia konta u�ytkownika. Aby mo�na by�o pomy�lnie wykona� ten kod, aktualnie zalogowany u�ytkownik musi by� cz�onkiem grupy Administratorzy lub mie� okre�lone uprawnienia, kt�re pozwalaj� na tworzenie kont u�ytkownik�w.