System.DirectoryServices (Espacio de nombres)

Actualización: noviembre 2007

Las clases de este espacio de nombres pueden utilizarse con cualquiera de los proveedores de servicios de dominio de Active Directory. Entre los proveedores actuales se encuentran: Internet Information Services (IIS), Protocolo ligero de acceso a directorios (LDAP), servicios de directorio NetWare de Novell (NDS) y WinNT.

ADSI es una interfaz de programación para los servicios de dominio de Microsoft Active Directory que permite a las aplicaciones interactuar con los diversos directorios en una red utilizando una sola interfaz. Mediante ADSI, pueden crearse aplicaciones que realicen tareas comunes, como copias de seguridad de bases de datos, acceso a impresoras y administración de cuentas de usuarios.

Antes de utilizar estas clases debe adquirir una serie de conocimientos generales de los servicios de dominio de Active Directory. Para obtener más información sobre los servicios de dominio de Active Directory, vea los temas Introduction to Active Directory Objects y Active Directory Technology Backgrounder, así como los siguientes temas en MSDN Library, en la dirección http://msdn2.microsoft.com/es-es/library:

• Using Active Directory Domain Services

• Active Directory Service Interfaces

• Lightweight Directory Access Protocol

• Implementing Active Directory Service Interfaces Providers

• Binding to an ADSI Object

• IADsOpenDSObject::OpenDSObject

Los servicios de dominio de Active Directory usan una estructura de árbol. Cada nodo del árbol contiene un conjunto de propiedades. Utilice este espacio de nombres para recorrer, buscar y modificar el árbol, y leer y escribir en las propiedades de un nodo.

La clase DirectoryEntry encapsula un nodo u objeto en la jerarquía de servicios de dominio de Active Directory. Utilice esta clase para enlazar objetos, leer propiedades y actualizar atributos. El objeto DirectoryEntry, junto con las clases auxiliares, proporciona compatibilidad con métodos de administración del ciclo de vida y métodos de navegación, entre los que se incluyen la creación, la eliminación, el cambio de nombre, el desplazamiento de un nodo secundario, y la enumeración de nodos secundarios.

Use la clase DirectorySearcher para realizar consultas en la jerarquía de los servicios de dominio de Active Directory. LDAP es el único proveedor de interfaces de servicios de Active Directory (Active Directory Service Interfaces, ADSI) del sistema compatible con la operación de búsqueda.

Una búsqueda en la jerarquía de los servicios de dominio de Active Directory mediante DirectorySearcher devuelve instancias de SearchResult, que están incluidas en una instancia de clase SearchResultCollection.

Clases

---

	Clase	Descripción
	ActiveDirectoryAccessRule	La clase ActiveDirectoryAccessRule se utiliza para representar una entrada de control de acceso (ACE) en la lista de control de acceso discrecional (DACL) de un objeto de servicios de dominio de Active Directory.
	ActiveDirectoryAuditRule	ActiveDirectoryAuditRule se utiliza para establecer una entrada de control de acceso (ACE) en una lista de control de acceso al sistema (SACL). ActiveDirectoryAccessRule contiene el administrador de confianza, que se representa como un objeto IdentityReference. También contiene información sobre el tipo de control de acceso, la máscara de acceso y otras propiedades como los indicadores de herencia. Esta regla se establece en un objeto ActiveDirectorySecurity. Después de que ActiveDirectorySecurity se confirma en el almacén de directorios, modifica el objeto descriptor de seguridad de acuerdo con las reglas establecidas en ActiveDirectoryAuditRule.
	ActiveDirectorySecurity	Utiliza la capa de seguridad de objeto de la biblioteca de ACL administrada para ajustar la funcionalidad del control de acceso de los objetos de directorio.
	CreateChildAccessRule	La clase CreateChildAccessRule representa un tipo específico de regla de acceso que se utiliza para permitir o denegar a un objeto de servicios de dominio de Active Directory el derecho a crear objetos secundarios.
	DeleteChildAccessRule	La clase DeleteChildAccessRule representa un tipo específico de regla de acceso que se utiliza para permitir o denegar a un objeto de servicios de dominio de Active Directory el derecho a eliminar objetos secundarios.
	DeleteTreeAccessRule	La clase DeleteTreeAccessRule representa un tipo específico de regla de acceso que se utiliza para permitir o denegar a un objeto de servicios de dominio de Active Directory el derecho a eliminar todos los objetos secundarios, independientemente de los permisos que tengan los objetos secundarios.
	DirectoryEntries	Contiene una colección de objetos DirectoryEntry.
	DirectoryEntry	La clase DirectoryEntry encapsula un nodo u objeto en la jerarquía de servicios de dominio de Active Directory.
	DirectoryEntryConfiguration	La clase DirectoryEntryConfiguration proporciona una manera directa de especificar y obtener las opciones específicas del proveedor para manipular un objeto de directorio. Normalmente, las opciones se aplican para buscar operaciones del almacén de directorios subyacente. Las opciones compatibles son específicas del proveedor.
	DirectorySearcher	Realiza consultas en los servicios de dominio de Active Directory.
	DirectoryServicesCOMException	Contiene información de error extendida sobre un error producido al llamar al método Invoke.
	DirectoryServicesPermission	La clase DirectoryServicesPermission permite controlar los permisos de seguridad de acceso a código de System.DirectoryServices.
	DirectoryServicesPermissionAttribute	Permite comprobaciones declarativas de permiso de System.DirectoryServices.
	DirectoryServicesPermissionEntry	La clase DirectoryServicesPermissionEntry define la unidad más pequeña de un permiso de seguridad de acceso a código establecido para System.DirectoryServices.
	DirectoryServicesPermissionEntryCollection	Contiene una colección con establecimiento inflexible de tipos de objetos DirectoryServicesPermissionEntry.
	DirectorySynchronization	Especifica cómo sincronizar un directorio en un dominio.
	DirectoryVirtualListView	La clase DirectoryVirtualListView especifica cómo realizar una búsqueda de vista de lista virtual. Una búsqueda de vista de lista virtual permite a los usuarios ver los resultados de la búsqueda en vistas de lista virtual al estilo de la libreta de direcciones. Está diseñada específicamente para conjuntos de resultados muy grandes. Los datos de la búsqueda se recuperan en subconjuntos contiguos de una búsqueda en directorios ordenada.
	DirectoryVirtualListViewContext	Especifica cómo construir la respuesta de la vista de lista virtual de directorios.
	DSDescriptionAttribute	Admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.
	ExtendedRightAccessRule	Representa un tipo específico de regla de acceso que se utiliza para permitir o negar un derecho extendido a un objeto de Active Directory. Los derechos extendidos son operaciones especiales no incluidas en el conjunto estándar de derechos de acceso. Un ejemplo de derecho extendido es Send-As, que proporciona a un usuario el derecho de enviar correo electrónico para otro usuario. Para obtener una lista de los derechos extendidos posibles, vea el tema Extended Rights en MSDN Library, en la dirección http://msdn2.microsoft.com/es-es/library. Para obtener más información sobre los derechos extendidos, vea el del tema Control Access Rights, también en MSDN Library.
	ListChildrenAccessRule	La clase ListChildrenAccessRule representa un tipo específico de regla de acceso que se utiliza para permitir o denegar a un objeto de servicios de dominio de Active Directory el derecho a enumerar objetos secundarios.
	PropertyAccessRule	La clase PropertyAccessRule representa un tipo específico de regla de acceso que se utiliza para permitir o denegar el acceso a una propiedad de servicios de dominio de Active Directory.
	PropertyCollection	La clase PropertyCollection contiene las propiedades de un objeto DirectoryEntry.
	PropertySetAccessRule	La clase PropertySetAccessRule representa un tipo específico de regla de acceso que se utiliza para permitir o denegar el acceso a un conjunto de propiedades de servicios de dominio de Active Directory. Para obtener una lista de los conjuntos de propiedades que se definen para los servicios de dominio de Active Directory, vea el tema Property Sets en MSDN Library, en la dirección http://msdn2.microsoft.com/es-es/library.
	PropertyValueCollection	Contiene los valores de una propiedad de DirectoryEntry.
	ResultPropertyCollection	Contiene las propiedades de una instancia de SearchResult.
	ResultPropertyValueCollection	Contiene los valores de una propiedad de SearchResult.
	SchemaNameCollection	Contiene una lista de los nombres de esquema que la propiedad SchemaFilter de un objeto DirectoryEntries puede utilizar.
	SearchResult	La clase SearchResult encapsula un nodo en la jerarquía de servicios de dominio de Active Directory que se devuelve durante una búsqueda a través de DirectorySearcher.
	SearchResultCollection	La clase SearchResultCollection contiene las instancias de SearchResult que la jerarquía de Active Directory ha devuelto durante una consulta DirectorySearcher.
	SortOption	Especifica la forma de ordenar los resultados de una búsqueda.

Enumeraciones

---

	Enumeración	Descripción
	ActiveDirectoryRights	La enumeración ActiveDirectoryRights especifica los derechos de acceso que se asignan a un objeto de servicios de dominio de Active Directory.
	ActiveDirectorySecurityInheritance	La enumeración ActiveDirectorySecurityInheritance especifica si se aplica información ACE, y cómo se aplica, a un objeto y a sus descendientes.
	AuthenticationTypes	La enumeración AuthenticationTypes especifica los tipos de autenticación utilizados en System.DirectoryServices. Esta enumeración tiene un atributo FlagsAttribute que permite una combinación bit a bit de sus valores miembro.
	DereferenceAlias	La enumeración DereferenceAlias especifica cómo se resuelven los alias. Esta enumeración proporciona valores para la propiedad DirectorySearcher.DerefAlias.
	DirectoryServicesPermissionAccess	La enumeración DirectoryServicesPermissionAccess define los niveles de acceso que utilizan las clases de permiso de System.DirectoryServices. Esta enumeración tiene un atributo FlagsAttribute que permite una combinación bit a bit de los valores de su miembro.
	DirectorySynchronizationOptions	Contiene indicadores que determinan cómo se sincronizarán los directorios de un dominio. Estas opciones se pueden establecer para la propiedad DirectorySynchronization.Option.
	ExtendedDN	La enumeración ExtendedDN especifica el formato en que se devolverá el nombre distintivo extendido. Esta enumeración se utiliza con la propiedad DirectorySearcher.ExtendedDN.
	PasswordEncodingMethod	Especifica si se utiliza el nivel de sockets seguro (SSL) cuando se establece o se cambia una contraseña. Esta enumeración se utiliza con la propiedad DirectoryEntryConfiguration.PasswordEncoding.
	PropertyAccess	La enumeración PropertyAccess se utiliza con las clases PropertyAccessRule y PropertySetAccessRule para indicar el tipo de acceso aplicable a una propiedad de Active Directory o a un conjunto de propiedades.
	ReferralChasingOption	La enumeración ReferralChasingOption especifica si se realiza y la forma en que se realiza el seguimiento de referencias.
	SearchScope	Especifica los posibles ámbitos para una búsqueda en directorios realizada mediante el objeto DirectorySearcher.
	SecurityMasks	Especifica las opciones disponibles para examinar la información de seguridad de un objeto de directorio. Esta enumeración se utiliza con las propiedades DirectorySearcher.SecurityMasks y DirectoryEntryConfiguration.SecurityMasks.
	SortDirection	La enumeración SortDirection especifica la forma de ordenar los resultados de una consulta de servicios de dominio de Active Directory.