COMMENT FAIRE : Ajouter un utilisateur au syst�me local � l'aide des services d'annuaire Directory Services et de Visual�C#�.NET

Num�ro d'article: 306273 - Voir les produits auxquels s'applique cet article

Ancien n� de publication de cet article�: F306273

R�sum�

Cet article explique comment utiliser l'espace de noms DirectoryServices pour ajouter un utilisateur au syst�me local et � un groupe.

Conditions requises

Microsoft Windows�XP, Windows�2000 ou Windows�NT�4.0
Visual�C#�.NET

Cr�ation de l'exemple

D�marrez Microsoft�Visual�Studio�.NET, puis cr�ez un projet d'application de console Visual�C#.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur R�f�rences, puis cliquez sur Ajouter une r�f�rence.
Ajoutez une r�f�rence � l'assembly System.DirectoryServices.dll.

Remplacez le code dans le fichier Class1.cs par celui-ci�:

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("Cr�ation du compte r�ussie");
	 Console.ReadLine();
	}
    catch (Exception ex)
	{
	 Console.WriteLine(ex.Message);
	 Console.ReadLine();

	}
    }
}

Compilez le projet et ex�cutez-le.
Dans Windows�2000, suivez la proc�dure ci-dessous pour v�rifier que le compte a �t� cr�� et ajout� au groupe Guest (Invit�)�:
1. Dans le menu D�marrer, pointez sur Programmes, puis sur Outils d'administration. Cliquez ensuite sur Gestion de l'ordinateur.
2. Cliquez sur le n?ud Utilisateurs et groupes locaux pour le d�velopper. Le nouveau compte devrait appara�tre sous le n?ud Utilisateurs, ainsi que sous le n?ud du groupe Guest.
Dans Windows�XP, suivez la proc�dure ci-dessous pour v�rifier que le compte a �t� cr�� et ajout� au groupe Guest�:
1. Dans le menu D�marrer, cliquez sur Panneau de configuration.
2. Double-cliquez sur Comptes d'utilisateurs. Le nouveau compte d'utilisateur devrait figurer dans la bo�te de dialogue Comptes d'utilisateurs.
Une fois les tests termin�s, n'oubliez pas de supprimer le compte d'utilisateur r�cemment cr��.

Explication du code

Cr�ation d'une nouvelle entr�e d'annuaire

Cet exemple suppose que vous cr�ez l'entr�e d'annuaire sur un poste Microsoft�Windows�NT, Windows�2000 ou Windows�XP. Notez que la cha�ne pass�e au constructeur DirectoryEntry commence par "WinNT://". Vous pouvez �galement ex�cuter les services d'annuaire sur des syst�mes d'exploitation tiers.

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

Ajout de l'entr�e d'annuaire � l'arborescence d'annuaire

Le code suivant ajoute un objet DirectoryEntry de type user de valeur TestUser1 � l'arborescence Active Directory.

DirectoryEntry NewUser = AD.Children.Add("TestUser1", "user");

D�finition du mot de passe et de la description pour le nouveau compte d'utilisateur

Le code suivant appelle la m�thode Invoke pour invoquer les m�thodes SetPassword et Put de l'objet DirectoryEntry. Cette op�ration permet de d�finir le mot de passe et d'attribuer une description au compte d'utilisateur. Ce code permet �galement d'appeler la m�thode CommitChanges pour enregistrer les modifications.

NewUser.Invoke("SetPassword", new object[] {"#12345Abc"});
NewUser.Invoke("Put", new object[] {"Description", "Test User from .NET"});
NewUser.CommitChanges();

Ajout du compte � un groupe

Pour ajouter le compte � un groupe, vous devez d�finir une variable du type DirectoryEntry. Il vous faut ensuite appeler la m�thode Find du membre Children de la classe ActiveDirectory pour remplir la variable. Dans ce cas, la recherche porte sur le groupe Guest. Ce code permet de tester la valeur renvoy�e par la m�thode Find pour d�terminer si le groupe a �t� trouv�. Si c'est le cas, le nouveau compte d'utilisateur s'ajoute au groupe.

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

D�pannage

Le code pr�sent� dans cet article ne fonctionne pas si vous tentez de l'ex�cuter sans poss�der les autorisations n�cessaires pour cr�er un compte d'utilisateur. Pour que son ex�cution se termine correctement, l'utilisateur actuellement connect� doit appartenir au groupe des administrateurs ou poss�der les permissions l'autorisant � cr�er des comptes d'utilisateurs.

Retour au d�but | Envoyer des commentaires

Propri�t�s

Num�ro d'article: 306273 - Derni�re mise � jour: lundi 13 octobre 2003 - Version: 1.0

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Microsoft Visual C# .NET 2002 Initiation

kbhowto kbhowtomaster KB306273

L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Retour au d�but | Envoyer des commentaires