System.DirectoryServices (Espacio de nombres)
TOC
Collapse the table of content
Expand the table of content

System.DirectoryServices (Espacio de nombres)

Actualización: noviembre 2007

El espacio de nombres System.DirectoryServices proporciona acceso fácil a los servicios de dominio de Active Directory desde el código administrado. El espacio de nombres contiene dos clases de componentes, DirectoryEntry y DirectorySearcher, que utilizan la tecnología de interfaces de servicios de Active Directory (Active Directory Services Interfaces, ADSI). ADSI es el conjunto de interfaces que proporciona Microsoft, que constituyen una herramienta flexible para trabajar con distintos proveedores de redes. ADSI ofrece al administrador la posibilidad de localizar y administrar los recursos de una red con relativa facilidad, con independencia del tamaño de la red.

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:

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.

  ClaseDescripción
9t2667d1.pubclass(es-es,VS.90).gifActiveDirectoryAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifActiveDirectoryAuditRuleActiveDirectoryAuditRule 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.
9t2667d1.pubclass(es-es,VS.90).gifActiveDirectorySecurityUtiliza 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.
9t2667d1.pubclass(es-es,VS.90).gifCreateChildAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifDeleteChildAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifDeleteTreeAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryEntriesContiene una colección de objetos DirectoryEntry.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryEntryLa clase DirectoryEntry encapsula un nodo u objeto en la jerarquía de servicios de dominio de Active Directory.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryEntryConfigurationLa 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.
9t2667d1.pubclass(es-es,VS.90).gifDirectorySearcherRealiza consultas en los servicios de dominio de Active Directory.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryServicesCOMException Contiene información de error extendida sobre un error producido al llamar al método Invoke.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryServicesPermissionLa clase DirectoryServicesPermission permite controlar los permisos de seguridad de acceso a código de System.DirectoryServices.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryServicesPermissionAttributePermite comprobaciones declarativas de permiso de System.DirectoryServices.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryServicesPermissionEntryLa clase DirectoryServicesPermissionEntry define la unidad más pequeña de un permiso de seguridad de acceso a código establecido para System.DirectoryServices.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryServicesPermissionEntryCollectionContiene una colección con establecimiento inflexible de tipos de objetos DirectoryServicesPermissionEntry.
9t2667d1.pubclass(es-es,VS.90).gifDirectorySynchronization Especifica cómo sincronizar un directorio en un dominio.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryVirtualListViewLa 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.
9t2667d1.pubclass(es-es,VS.90).gifDirectoryVirtualListViewContextEspecifica cómo construir la respuesta de la vista de lista virtual de directorios.
9t2667d1.pubclass(es-es,VS.90).gifDSDescriptionAttributeAdmite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.
9t2667d1.pubclass(es-es,VS.90).gifExtendedRightAccessRuleRepresenta 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.
9t2667d1.pubclass(es-es,VS.90).gifListChildrenAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifPropertyAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifPropertyCollection La clase PropertyCollection contiene las propiedades de un objeto DirectoryEntry.
9t2667d1.pubclass(es-es,VS.90).gifPropertySetAccessRuleLa 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.
9t2667d1.pubclass(es-es,VS.90).gifPropertyValueCollectionContiene los valores de una propiedad de DirectoryEntry.
9t2667d1.pubclass(es-es,VS.90).gifResultPropertyCollectionContiene las propiedades de una instancia de SearchResult.
9t2667d1.pubclass(es-es,VS.90).gifResultPropertyValueCollectionContiene los valores de una propiedad de SearchResult.
9t2667d1.pubclass(es-es,VS.90).gifSchemaNameCollection Contiene una lista de los nombres de esquema que la propiedad SchemaFilter de un objeto DirectoryEntries puede utilizar.
9t2667d1.pubclass(es-es,VS.90).gifSearchResultLa 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.
9t2667d1.pubclass(es-es,VS.90).gifSearchResultCollectionLa clase SearchResultCollection contiene las instancias de SearchResult que la jerarquía de Active Directory ha devuelto durante una consulta DirectorySearcher.
9t2667d1.pubclass(es-es,VS.90).gifSortOptionEspecifica la forma de ordenar los resultados de una búsqueda.

  EnumeraciónDescripción
9t2667d1.pubenumeration(es-es,VS.90).gifActiveDirectoryRightsLa enumeración ActiveDirectoryRights especifica los derechos de acceso que se asignan a un objeto de servicios de dominio de Active Directory.
9t2667d1.pubenumeration(es-es,VS.90).gifActiveDirectorySecurityInheritanceLa enumeración ActiveDirectorySecurityInheritance especifica si se aplica información ACE, y cómo se aplica, a un objeto y a sus descendientes.
9t2667d1.pubenumeration(es-es,VS.90).gifAuthenticationTypesLa 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.
9t2667d1.pubenumeration(es-es,VS.90).gifDereferenceAliasLa enumeración DereferenceAlias especifica cómo se resuelven los alias. Esta enumeración proporciona valores para la propiedad DirectorySearcher.DerefAlias.
9t2667d1.pubenumeration(es-es,VS.90).gifDirectoryServicesPermissionAccessLa 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.
9t2667d1.pubenumeration(es-es,VS.90).gifDirectorySynchronizationOptionsContiene indicadores que determinan cómo se sincronizarán los directorios de un dominio. Estas opciones se pueden establecer para la propiedad DirectorySynchronization.Option.
9t2667d1.pubenumeration(es-es,VS.90).gifExtendedDNLa enumeración ExtendedDN especifica el formato en que se devolverá el nombre distintivo extendido. Esta enumeración se utiliza con la propiedad DirectorySearcher.ExtendedDN.
9t2667d1.pubenumeration(es-es,VS.90).gifPasswordEncodingMethodEspecifica 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.
9t2667d1.pubenumeration(es-es,VS.90).gifPropertyAccessLa 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.
9t2667d1.pubenumeration(es-es,VS.90).gifReferralChasingOptionLa enumeración ReferralChasingOption especifica si se realiza y la forma en que se realiza el seguimiento de referencias.
9t2667d1.pubenumeration(es-es,VS.90).gifSearchScopeEspecifica los posibles ámbitos para una búsqueda en directorios realizada mediante el objeto DirectorySearcher.
9t2667d1.pubenumeration(es-es,VS.90).gifSecurityMasksEspecifica 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.
9t2667d1.pubenumeration(es-es,VS.90).gifSortDirectionLa enumeración SortDirection especifica la forma de ordenar los resultados de una consulta de servicios de dominio de Active Directory.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft