Esta documentación está archivada y no tiene mantenimiento.

System.DirectoryServices.AccountManagement (Espacio de nombres)

Actualización: noviembre 2007

El espacio de nombres System.DirectoryServices.AccountManagement proporciona acceso y manipulación sin problemas de entidades de seguridad de usuario, equipo y grupo en varios almacenes de entidades de seguridad: servicios de directorios de Active Directory (AD DS), servicios de directorio ligero de Active Directory (AD LDS) y SAM (administrador de cuentas de seguridad) de equipo (MSAM). System.DirectoryServices.AccountManagement administra los objetos de directorio independientes del espacio de nombres System.DirectoryServices.

Las aplicaciones de servicios de directorio administradas pueden aprovechar de la API de AccountManagement para simplificar la administración de entidades de seguridad de usuario, equipo y grupo. Se implementan soluciones que anteriormente requerían vastos conocimientos del almacén o código largo, como buscar todos los grupos a los que pertenece un usuario, en unas pocas líneas de código con la API de AccountManagement.

Las características siguientes están disponibles en la API de AccountManagement:

  • Se simplifican las operaciones del directorio básicas como crear y actualizar entidades de seguridad. La aplicación requiere menos conocimientos de los almacenes subyacentes para realizar estas operaciones.

  • Las aplicaciones pueden extender el modelo de objetos para incluir nuevos tipos de objetos de directorio.

  • Se simplifican las tareas de administración de cuentas, como habilitar y deshabilitar una cuenta de usuario.

  • La compatibilidad entre las bases de datos de los almacenes permite que objetos de grupo de los servicios de dominio de Active Directory (AD DS), servicios de directorio Ligeros de Active Directory (DC LDS) y SAM de equipo (MSAM) contengan miembros de tipos diferentes de almacenes.

  • La búsqueda de consulta por ejemplo, disponible en la clase PrincipalaSearcher, permite que las aplicaciones establezcan las propiedades de un objeto de entidad de seguridad y busquen otros objetos que contengan valores de propiedad coincidente en el almacén seleccionado.

  • La mejora de los objetos de entidad de seguridad de equipo, usuario y grupo permite que las aplicaciones busquen los objetos de entidad de seguridad coincidentes en el almacén seleccionado.

  • La búsqueda recursiva, disponible en el objeto de entidad de seguridad de grupo, permite que las aplicaciones busquen en un grupo de forma recursiva y devuelvan sólo los objetos de entidades de seguridad que sean nodos hoja.

  • Se simplifica la validación de credenciales en los almacenes SAM de equipo, AD DS y AD LS.

  • Las velocidades de conexión se incrementan mediante la característica Enlace simultáneo rápido (FSB) cuando esté disponible. La memoria caché de conexión reduce el número de puertos utilizados.

  ClaseDescripción
Bb299745.pubclass(es-es,VS.90).gifAdvancedFilters Esta clase proporciona acceso de escritura a algunos atributos para que los usuarios puedan modificar propiedades de sólo lectura del objeto de la entidad de seguridad "dummy" que se pasa a un objeto PrincipalSearcher al utilizar Query by Example
Bb299745.pubclass(es-es,VS.90).gifAuthenticablePrincipalEncapsula la cuenta y se pone en contacto con los datos comunes a las entidades de seguridad que se pueden autenticar.
Bb299745.pubclass(es-es,VS.90).gifComputerPrincipalEncapsula entidades de seguridad que son cuentas de equipo.
Bb299745.pubclass(es-es,VS.90).gifDirectoryObjectClassAttributeRepresenta el objeto de esquema que se usa para crear un objeto de este tipo en el directorio. Este atributo se requiere para las extensiones de entidades de seguridad y sólo se puede establecer en clases.
Bb299745.pubclass(es-es,VS.90).gifDirectoryPropertyAttributeContiene los datos requeridos por el almacén para asignar una propiedad de entidad de seguridad a un atributo de directorio. Este atributo se requiere para las extensiones de entidades de seguridad y sólo se puede establecer en una propiedad. Se debe especificar en cada propiedad que represente un atributo de directorio de la clase extendida.
Bb299745.pubclass(es-es,VS.90).gifDirectoryRdnPrefixAttributePrefijo de RDN utilizado para construir el RDN del nuevo objeto que se inserta en el almacén. La API de administración de cuentas utiliza el prefijo de RDN predeterminado de "CN" si no se establece este atributo. Este atributo es opcional y sólo se puede establecer en clases de extensión de entidades de seguridad.
Bb299745.pubclass(es-es,VS.90).gifGroupPrincipalEncapsula las cuentas de grupo. Las cuentas de grupo pueden ser colecciones arbitrarias de objetos de entidades de seguridad o cuentas creadas con fines administrativos.
Bb299745.pubclass(es-es,VS.90).gifMultipleMatchesExceptionEsta excepción la producen los métodos que esperan la coincidencia con un objeto principal único cuando se producen varias coincidencias en la consulta de búsqueda.
Bb299745.pubclass(es-es,VS.90).gifNoMatchingPrincipalExceptionEsta excepción se produce cuando no se puede encontrar ningún objeto principal coincidente con los parámetros especificados.
Bb299745.pubclass(es-es,VS.90).gifPasswordExceptionEsta excepción se produce cuando una contraseña no cumple los requisitos de complejidad.
Bb299745.pubclass(es-es,VS.90).gifPrincipalEncapsula los datos de la cuenta y las operaciones comunes a todas las entidades de seguridad. Ésta es la clase base abstracta de la que se derivan todas las entidades de seguridad.
Bb299745.pubclass(es-es,VS.90).gifPrincipalCollection Colección mutable de objetos derivados de la clase Principal. Esta clase se ha diseñado para utilizarla con las propiedades multivalor que contienen entidades de seguridad. La manipulación del contenido de esta colección cambia el contenido de la correspondiente propiedad de almacén, que se vuelve permanente cuando se llama a Save en el correspondiente objeto de entidad de seguridad.
Bb299745.pubclass(es-es,VS.90).gifPrincipalContextEncapsula el servidor o dominio en el que se realizan todas las operaciones, el contenedor que se utiliza como la base de esas operaciones y las credenciales usadas para realizar las operaciones.
Bb299745.pubclass(es-es,VS.90).gifPrincipalExceptionClase base de excepciones producidas por objetos de System.DirectoryServices.AccountManagement.
Bb299745.pubclass(es-es,VS.90).gifPrincipalExistsExceptionProducida por Add cuando se intenta insertar una entidad de seguridad que ya existe en la colección, o por System.DirectoryServices.AccountManagement.Principal.Save cuando se intenta guardar una nueva entidad de seguridad que ya existe en el almacén.
Bb299745.pubclass(es-es,VS.90).gifPrincipalOperationException Se produce cuando ADSI devuelve un error durante una operación para actualizar el almacén.
Bb299745.pubclass(es-es,VS.90).gifPrincipalSearcherEncapsula los métodos y modelos de búsqueda utilizados para ejecutar una consulta en el almacén de entidades de seguridad subyacente.
Bb299745.pubclass(es-es,VS.90).gifPrincipalSearchResult<T> Devuelve una colección de los objetos Principal devueltos por una búsqueda.
Bb299745.pubclass(es-es,VS.90).gifPrincipalServerDownExceptionEsta excepción se produce cuando la API no puede conectarse al servidor.
Bb299745.pubclass(es-es,VS.90).gifPrincipalValueCollection<T>Las propiedades multivalor, como PermittedWorkstations, tienen un valor de tipo PrincipalValueCollection<T>. Esta clase proporciona los métodos para enumerar y manipular esos valores.
Bb299745.pubclass(es-es,VS.90).gifUserPrincipalEncapsula entidades de seguridad que son cuentas de usuario.

  EnumeraciónDescripción
Bb299745.pubenumeration(es-es,VS.90).gifContextOptionsEspecifica las opciones que se utilizan para el enlace con el servidor. La aplicación puede establecer varias opciones que se vinculan con una operación OR bit a bit.
Bb299745.pubenumeration(es-es,VS.90).gifContextTypeEspecifica el tipo de almacén al que pertenece la entidad de seguridad.
Bb299745.pubenumeration(es-es,VS.90).gifGroupScopeEspecifica el ámbito de la entidad de seguridad de grupo.
Bb299745.pubenumeration(es-es,VS.90).gifIdentityTypeEspecifica el formato de la identidad.
Bb299745.pubenumeration(es-es,VS.90).gifMatchTypeLa enumeración MatchType especifica el tipo de comparación utilizado en una búsqueda.
Mostrar: