System.DirectoryServices.AccountManagement Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Proporciona acesso e manipulação uniformes dos princípios de segurança de utilizadores, computadores e grupos nas múltiplas lojas principais: Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS) e Machine SAM (MSAM). System.DirectoryServices.AccountManagement gere objetos de diretório de forma independente do System.DirectoryServices namespace.
Classes
| Name | Description |
|---|---|
| AdvancedFilters |
Esta classe proporciona acesso escrita a certos atributos para que os utilizadores possam modificar propriedades de apenas leitura do objeto principal "dummy" que é passado a um PrincipalSearcher objeto ao usar o Query By Example. |
| AuthenticablePrincipal |
Encapsula os dados da conta e de contacto comuns aos principais responsáveis que podem ser autenticados. |
| ComputerPrincipal |
Encapsula os princípios que são contas informáticas. |
| DirectoryObjectClassAttribute |
Representa o objeto de esquema que é usado para criar um objeto deste tipo no diretório. Este atributo é necessário para extensões principais e só pode ser definido em classes. |
| DirectoryPropertyAttribute |
Contém os dados necessários pela loja para mapear uma propriedade principal para um atributo de diretório. Este atributo é necessário para extensões principais e só pode ser definido numa propriedade. Deve ser especificado em cada propriedade que represente um atributo de diretório na classe estendida. |
| DirectoryRdnPrefixAttribute |
O prefixo RDN usado para construir o RDN para o novo objeto que é inserido na loja. O prefixo RDN predefinido "CN" é usado pela API de Gestão de Contas se este atributo não estiver definido. Este atributo é opcional e só pode ser definido nas classes de extensão principal. |
| GroupPrincipal |
Encapsula contas de grupo. As contas de grupo podem ser coleções arbitrárias de objetos principais ou contas criadas para fins administrativos. |
| MultipleMatchesException |
Esta exceção é lançada por métodos que esperam corresponder a um único objeto principal quando há múltiplas correspondências na consulta de pesquisa. |
| NoMatchingPrincipalException |
Esta exceção é lançada quando nenhum objeto principal correspondente foi encontrado com os parâmetros especificados. |
| PasswordException |
Esta exceção é lançada quando uma palavra-passe não cumpre os requisitos de complexidade. |
| Principal |
Encapsula os dados e operações da conta comuns a todos os princípios de segurança. Esta é a classe base abstrata da qual todos os princípios de segurança são derivados. |
| PrincipalCollection |
Uma coleção mutável de objetos derivados da Principal classe. Esta classe foi concebida para ser usada em propriedades multivaloradas que contêm Principal objetos. Manipular o conteúdo desta coleção altera o conteúdo da propriedade de armazenamento correspondente, que se torna permanente quando Save() é chamada no objeto principal correspondente. |
| PrincipalContext |
Encapsula o servidor ou domínio contra o qual todas as operações são realizadas, o contentor utilizado como base dessas operações e as credenciais usadas para realizar as operações. |
| PrincipalException |
A classe base de exceções lançadas pelos System.DirectoryServices.AccountManagement objetos. |
| PrincipalExistsException |
Lançado por Add método quando se tenta inserir um principal que já existe na coleção, ou quando Save() se tenta salvar um novo principal que já existe na loja. |
| PrincipalOperationException |
É lançado quando o ADSI devolve um erro durante uma operação para atualizar a loja. |
| PrincipalSearcher |
Encapsula os métodos e padrões de pesquisa usados para executar uma consulta no armazenamento principal subjacente. |
| PrincipalSearchResult<T> |
Devolve uma coleção de Principal objetos que são devolvidos por uma pesquisa. |
| PrincipalServerDownException |
Esta exceção é lançada quando a API não consegue ligar-se ao servidor. |
| PrincipalValueCollection<T> |
Propriedades multivaloradas, como PermittedWorkstations, têm um valor do tipo PrincipalValueCollection<T>. Esta classe fornece métodos para enumerar e manipular esses valores. |
| UserPrincipal |
Encapsula princípios que são contas de utilizador. |
Enumerações
| Name | Description |
|---|---|
| ContextOptions |
Especifica as opções que são usadas para ligar ao servidor. A aplicação pode definir múltiplas opções que estão ligadas a uma operação OR bit a bit. |
| ContextType |
Especifica o tipo de loja a que o principal pertence. |
| GroupScope |
Especifica o âmbito do principal do grupo. |
| IdentityType |
Especifica o formato da identidade. |
| MatchType |
A MatchType enumeração especifica o tipo de comparação utilizada numa pesquisa. |
Observações
As aplicações de serviços de diretório geridos podem tirar partido da System.DirectoryServices.AccountManagement API para simplificar a gestão dos principais utilizadores, computadores e grupos. Soluções que anteriormente exigiam conhecimento detalhado da loja ou código extenso, como encontrar todos os grupos a que um utilizador pertence, são concretizadas em poucas linhas de código com a System.DirectoryServices.AccountManagement API.
As seguintes funcionalidades estão disponíveis na System.DirectoryServices.AccountManagement API:
Operações básicas de diretórios, como a criação e atualização de princípios de segurança, são simplificadas. A aplicação requer menos conhecimento dos armazenamentos subjacentes para realizar estas operações.
As aplicações podem estender o modelo de objetos para incluir novos tipos de objetos de diretório.
As tarefas de gestão de contas, como ativar e desativar uma conta de utilizador, são simplificadas.
O suporte cross-store permite que objetos de grupo nas bases de dados Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS) e Machine SAM (MSAM) contenham membros de diferentes tipos de armazenamentos.
A pesquisa de consulta por exemplo, disponível na PrincipalSearcher classe, permite às aplicações definir propriedades num objeto principal e procurar no armazenamento selecionado outros objetos que contenham valores de propriedade correspondentes.
A pesquisa melhorada em objetos principais de computador, utilizador e grupo permite às aplicações pesquisar na loja selecionada objetos principais correspondentes.
A pesquisa recursiva, disponível no objeto principal do grupo, permite que aplicações pesquisem recursivamente num grupo e devolvam apenas objetos principais que são nós folha.
A validação de credenciais contra as lojas Machine SAM, AD DS e AD LS é simplificada.
As velocidades de ligação são aumentadas através da funcionalidade Fast Concurrent Bind (FSB) quando disponível. A cache de ligação diminui o número de portas utilizadas.
