Scénarios System.DirectoryServices.ActiveDirectory

Article
09/12/2008

L'espace de noms System.DirectoryServices.ActiveDirectory est conçu pour simplifier le développement d'applications et d'utilitaires destinés à effectuer des tâches courantes relatives aux services de domaine Active Directory. Il constitue une API de haut niveau qui encapsule un nombre important de connaissances sur la structure des services de domaine Active Directory, des réseaux basés sur les services de domaine Active Directory et des opérations des services de domaine Active Directory communes, comme la réplication ou la gestion des approbations. System.DirectoryServices.ActiveDirectory comprend des objets représentant des éléments communs des services de domaine Active Directory, comme des forêts, des contrôleurs de domaine, des classes et des propriétés de schéma, ainsi que des programmes de réplication.

Les tâches peuvent souvent être effectuées sans nécessiter d'autre accès aux services de domaine Active Directory que celui fourni par l'espace de noms System.DirectoryServices.ActiveDirectory. Toutefois, pour certaines tâches avancées, il peut être nécessaire d'accéder à des attributs d'un objet non implémentés dans l'espace de noms System.DirectoryServices.ActiveDirectory. Pour ce faire, une application peut utiliser la méthode GetDirectoryEntry implémentée par de nombreux objets System.DirectoryServices.ActiveDirectory. Cette méthode permet à une application de récupérer DirectoryEntry pour l'objet. L'application peut ensuite inspecter ou mettre à jour DirectoryEntry à l'aide des méthodes fournies par cette classe et d'autres classes associées de System.DirectoryServices. De cette façon, même les applications qui ont besoin de fonctions avancées des services de domaine Active Directory peuvent tirer profit des nombreuses méthodes spécifiques des objets de System.DirectoryServices.ActiveDirectory qui peuvent être utilisées pour localiser un objet d'annuaire particulier, ou faire une énumération via une série d'objets d'annuaire d'un certain type avec une connaissance minimale du développement d'éléments internes de schéma des services de domaine Active Directory et moins de lignes de code. Voici les classes System.DirectoryServices.ActiveDirectory qui implémentent la méthode GetDirectoryEntry :

Un autre objet System.DirectoryServices pouvant s'avérer très utile est l'objet System.DirectoryServices.DirectorySearcher, qui permet d'effectuer des recherches dans une sous-arborescence des services de domaine Active Directory. Une fois que l'application a obtenu un objet DirectoryEntry, elle peut créer un objet DirectorySearcher qui effectue une recherche dans la sous-arborescence des services de domaine Active Directory dont la racine est DirectoryEntry. Une application peut également obtenir un objet System.DirectoryServices.DirectorySearcher directement depuis un objet DomainController ou GlobalCatalog à l'aide de la méthode GetDirectorySearcher de l'un ou l'autre des objets.

Scénario de gestion de schéma

Une application peut utiliser des classes dans l'espace de noms System.DirectoryServices.ActiveDirectory pour interroger et mettre à jour le schéma sans nécessiter une connaissance détaillée de la structure du schéma.

La classe ActiveDirectorySchema comprend des méthodes qui énumèrent des classes, comme par exemple FindAllClasses ou FindAllDefunctClasses. Une application peut identifier les classes de schéma qui l'intéressent en inspectant les propriétés de chaque objet ActiveDirectorySchemaClass localisé grâce à la méthode d'énumération. À ce stade, l'application peut produire un rapport sur la classe ou mettre à jour une ou plusieurs propriétés de l'objet ActiveDirectorySchemaClass. L'application peut également utiliser la collection MandatoryProperties ou OptionalProperties de l'objet pour accéder à l'ensemble d'objets ActiveDirectorySchemaProperty contenant des informations détaillées sur les propriétés du schéma relatives à cette classe, par exemple si elle est présente ou obsolète dans le catalogue global.

De même, si une application doit identifier les propriétés de schéma comportant certaines caractéristiques, elle peut commencer par appeler la méthode FindAllProperties de la classe ActiveDirectorySchema pour énumérer les propriétés. Elle peut ensuite inspecter les propriétés de chaque objet ActiveDirectorySchemaProperty qui est retourné, puis modifier ou signaler les détails de cet objet selon les besoins.

Scénario de gestion de topologie

Une application peut utiliser les classes de l'espace de noms System.DirectoryServices.ActiveDirectory pour inspecter et modifier la topologie d'une installation des services de domaine Active Directory.

Une application peut afficher ou mettre à jour les informations dans des objets de services de domaine Active Directory tels que Forest, Domain, ActiveDirectorySite etActiveDirectorySubnet. Elle peut également explorer les relations entre les objets de deux manières différentes :

En utilisant les méthodes et propriétés de ces objets qui retournent un ou plusieurs objets d'un type différent. Par exemple, pour établir la liste de tous les domaines de tous les sites, une application peut énumérer sur la ActiveDirectorySiteCollection. L'application peut récupérer la collection Domains pour chaque ActiveDirectorySite de la ActiveDirectorySiteCollection, puis produire pour chaque site la liste des noms de tous les domaines qu'elle contient.
En accédant à d'autres objets qui représentent les relations entre les objets de services de domaine Active Directory susmentionnés. Par exemple, la propriété Sites de l'objet ActiveDirectorySiteLink récupère une collection de tous les sites contenus dans cet objet ActiveDirectorySiteLink. De même, la propriété SiteLinks de l'objet ActiveDirectorySiteLinkBridge récupère une collection de tous les objets ActiveDirectorySiteLink associés à ce ActiveDirectorySiteLinkBridge.

Scénario de gestion d'approbations de domaine ou de forêt

Une application peut accéder à une collection de toutes les approbations définies pour un objet Domain ou Forest. Dans les deux cas, l'application peut utiliser la méthode GetAllTrusts de l'un ou l'autre objet pour retourner un objet TrustRelationshipInformationCollection. L'application peut ensuite parcourir cette collection pour afficher ou mettre à jour les objets TrustRelationshipInformation qu'elle contient. L'espace de noms System.DirectoryServices.ActiveDirectory définit également d'autres objets, tels que TrustDirection et TrustType, qui offrent des valeurs énumérées représentant respectivement des directions d'approbation et des types d'approbations valides.

Scénario de surveillance de réplication

Une autre application courante de l'espace de noms System.DirectoryServices.ActiveDirectory est la surveillance de la réplication des services de domaine Active Directory.

System.DirectoryServices.ActiveDirectory implémente un certain nombre de classes qui contiennent des informations d'état de la réplication, comme ReplicationConnection, ReplicationCursor, ReplicationFailure, ReplicationOperation etReplicationOperationInformation.

Par exemple, pour signaler un état de réplication pour toutes les partitions définies sur un contrôleur de domaine particulier, une application peut examiner les objets ReplicationCursor associés à chaque partition. L'application peut localiser l'objet DomainController qui l'intéresse à l'aide de la méthode FindOne de l'objet DomainController. Elle peut ensuite référencer la propriété de collection Partitions du DomainController et énumérer toutes les partitions de ce contrôleur de domaine. L'application peut obtenir la collection de tous les objets ReplicationCursor pour cette partition en utilisant la méthode GetReplicationCursors, puis énumérer cette collection d'objets ReplicationCursor en affichant les valeurs de certaines propriétés telles que SourceServer, SourceInvocationId et LastSuccessfulSyncTime.

Voir aussi

Concepts

Vue d'ensemble de l'espace de noms System.DirectoryServices.ActiveDirectory
Architecture System.DirectoryServices.ActiveDirectory

Send comments about this topic to Microsoft.

Partager via