Escenarios de System.DirectoryServices.ActiveDirectory

El espacio de nombres System.DirectoryServices.ActiveDirectory está diseñado para simplificar el desarrollo de aplicaciones y utilidades que realizan tareas comunes relacionadas con Servicios de dominio de Active Directory. Este espacio de nombres es una API de alto nivel que encapsula una importante cantidad de conocimientos acerca de la estructura de Servicios de dominio de Active Directory, de las redes basadas en Servicios de dominio de Active Directory y de las operaciones comunes de Servicios de dominio de Active Directory, como la replicación y la administración de la confianza. System.DirectoryServices.ActiveDirectory incluye objetos que representan elementos comunes de Servicios de dominio de Active Directory como bosques, controladores de dominio, clases de esquemas, propiedades de esquemas y programas de replicación.

En muchos casos, las tareas se pueden realizar sin acceso adicional a Servicios de dominio de Active Directory más allá de los que proporciona el espacio de nombres System.DirectoryServices.ActiveDirectory. Sin embargo, para algunas tareas avanzadas, es posible que sea necesario obtener acceso a los atributos de los objetos que no se implementen en el espacio de nombres System.DirectoryServices.ActiveDirectory. Para ello, las aplicaciones pueden utilizar el método GetDirectoryEntry que implementan muchos objetos System.DirectoryServices.ActiveDirectory. Con ese método, las aplicaciones pueden recuperar el DirectoryEntry del objeto. A continuación, la aplicación puede inspeccionar o actualizar el DirectoryEntry mediante los métodos que proporciona dicha clase y otras clases relacionadas de System.DirectoryServices. De esta forma, hasta las aplicaciones que necesitan capacidades de Servicios de dominio de Active Directory avanzadas pueden aprovechar muchos de los métodos específicos de objeto de System.DirectoryServices.ActiveDirectory que se pueden utilizar para localizar un objeto concreto del directorio o enumerar una serie de objetos del directorio de un tipo concreto con conocimientos mínimos de la información interna de los esquemas de Servicios de dominio de Active Directory y menos líneas de código. Entre las clases System.DirectoryServices.ActiveDirectory que implementan el método GetDirectoryEntry se incluyen:

• ActiveDirectoryInterSiteTransport
• ActiveDirectoryPartition
• ActiveDirectorySchema
• ActiveDirectorySchemaClass
• ActiveDirectorySchemaProperty
• ActiveDirectorySite
• ActiveDirectorySiteLink
• ActiveDirectorySiteLinkBridge
• ActiveDirectorySubnet
• ADAMInstance
• ApplicationPartition
• ConfigurationSet
• DirectoryServer
• Domain
• DomainController
• GlobalCatalog
• ReplicationConnection

System.DirectoryServices.DirectorySearcher es otro objeto System.DirectoryServices que puede resultar muy útil, ya que realiza búsquedas de un subárbol de Servicios de dominio de Active Directory. Una vez que la aplicación haya obtenido un objeto DirectoryEntry, puede crear un objeto DirectorySearcher que busque el subárbol de Servicios de dominio de Active Directory que tenga el DirectoryEntry raíz. Las aplicaciones también pueden obtener los objetos System.DirectoryServices.DirectorySearcher directamente de un DomainController o de un objeto GlobalCatalog a través del método GetDirectorySearcher de cualquiera de los dos objetos.

Escenario de administración de esquemas

Las aplicaciones pueden utilizar las clases del espacio de nombres System.DirectoryServices.ActiveDirectorypara realizar consultas y actualizar el esquema sin que sea necesario conocer a fondo la estructura del mismo.

La clase ActiveDirectorySchema incluye métodos que enumeran clases como FindAllClasses y FindAllDefunctClasses. Las aplicaciones pueden identificar las clases de esquemas de interés mediante la inspección de las propiedades de cada objeto ActiveDirectorySchemaClass localizado por el método de enumeración. En este punto, la aplicación puede crear un informe acerca de la clase o actualizar una o varias propiedades del objeto ActiveDirectorySchemaClass seleccionado. La aplicación también puede utilizar la colección MandatoryProperties o OptionalProperties de dicho objeto para obtener acceso al conjunto de objetos ActiveDirectorySchemaProperty que contiene información detallada acerca de las propiedades del esquema de dicha clase, como si está presente o inactivo en el catálogo global.

De igual forma, si una aplicación necesita identificar las propiedades del esquema con ciertas características, puede empezar por llamar al método FindAllProperties de la clase ActiveDirectorySchema para enumerar las propiedades. A continuación, puede inspeccionar las propiedades de cada objeto ActiveDirectorySchemaProperty que se devuelve y modificar o generar informes acerca de los detalles de dicho objeto, según sea necesario.

Escenario de la administración de topologías

Las aplicaciones pueden utilizar las clases del espacio de nombres System.DirectoryServices.ActiveDirectory para inspeccionar y modificar la topología de una instalación de Servicios de dominio de Active Directory.

Las aplicaciones pueden ver o actualizar la información de los objetos de Servicios de dominio de Active Directory como Forest, Domain, ActiveDirectorySite y ActiveDirectorySubnet. También pueden explorar las relaciones entre objetos de cualquiera de las dos formas siguientes:

• Mediante el uso de los métodos y las propiedades de dichos objetos que devuelven uno o varios objetos de un tipo diferente. Por ejemplo, para mostrar todos los dominios de todos los sitios, las aplicaciones pueden enumerarse sobre el ActiveDirectorySiteCollection. La aplicación puede recuperar la colección Domains de todos los ActiveDirectorySite del ActiveDirectorySiteCollection y, a continuación, generar una lista de informes para cada sitio, los nombres de todos los dominios que contiene.
• Acceso a otros objetos que representan relaciones entre los objetos de Servicios de dominio de Active Directory nombrados con anterioridad. Por ejemplo, la propiedad Sites del objeto ActiveDirectorySiteLink recupera una colección de todos los sitios que contienen dicho objeto ActiveDirectorySiteLink. De igual forma, la propiedad SiteLinks del objeto ActiveDirectorySiteLinkBridge vuelve a intentar una colección de todos los objetos de ActiveDirectorySiteLink asociados con dicha ActiveDirectorySiteLinkBridge.

Escenario de administración de la confianza de bosques o dominios

Cualquier aplicación puede tener acceso a una colección de todas las confianzas definidas para un objeto Domain o Forest. En cualquiera de los dos casos, la aplicación puede utilizar el método GetAllTrusts de cualquiera de los objetos para devolver un objeto TrustRelationshipInformationCollection. A continuación, puede recorrer dicha colección para mostrar o actualizar los objetos de TrustRelationshipInformation que contiene. El espacio de nombres System.DirectoryServices.ActiveDirectory también define objetos adicionales como TrustDirection y TrustType, que ofrecen valores enumerados que representan direcciones de confianza válidas y tipos de confianza, respectivamente.

Escenario de supervisión de réplicas

Otra aplicación común del espacio de nombres System.DirectoryServices.ActiveDirectory es supervisar la réplica de Servicios de dominio de Active Directory.

System.DirectoryServices.ActiveDirectory implementa varias clases que contienen el estado de la réplica, como: ReplicationConnection, ReplicationCursor, ReplicationFailure, ReplicationOperation y ReplicationOperationInformation.

Por ejemplo, para informar del estado de réplica de todas las particiones que están definidas en un controlador de dominio concreto, una aplicación podría examinar los objetos ReplicationCursor que están asociados con cada partición. La aplicación podría localizar el DomainController de interés mediante el método FindOne del objeto DomainController. A continuación, podría hacer referencia a la propiedad de la colección Partitions del DomainController y enumerar todas las particiones de dicho controlador de dominio. La aplicación puede obtener la colección de todos los objetos de ReplicationCursor de dicha partición mediante el uso del método GetReplicationCursors y enumerar dicha colección de objetos de ReplicationCursor, mostrando los valores de propiedades como SourceServer, SourceInvocationId y LastSuccessfulSyncTime.

Consulte también

Conceptos

Introducción al espacio de nombres System.DirectoryServices.ActiveDirectory
Arquitectura de System.DirectoryServices.ActiveDirectory

Send comments about this topic to Microsoft.

Copyright © 2008 Microsoft Corporation. Reservados todos los derechos.