Compartilhar via

Ações do Active Directory

  • Artigo

As ações do Active Directory requerem uma conexão com um servidor do Active Directory. Estabeleça a conexão usando a ação Conectar ao servidor e um caminho LDAP. O caminho LDAP especifica os controladores de domínio e deve ter o seguinte formato:

LDAP://DC=contoso,DC=demo

Se você trabalha com grupos, objetos ou usuários, precisa especificar também sua localização. O campo Localização especifica o contêiner, bem como o controlador de domínio, e deve ter o seguinte formato:

CN=Users,DC=contoso,DC=demo

Depois de obter todos os nomes distintos usando o comando dsquery user, insira o nome distinto no seguinte formato. Para este exemplo, o nome de usuário é nvarga.

CN=nvarga,CN=Users,DC=contoso,DC=demo

Se o nome do contêiner contiver uma vírgula, coloque o nome entre aspas duplas. Por exemplo CN=Varga, Norbert deve ser:

CN="Varga, Norbert",DC=contoso,DC=com

Criar grupo

Cria um grupo no Active Directory.

Importante

Certifique-se de que o Power Automate para desktop esteja operando com direitos elevados ao executar um fluxo contendo a ação Criar um grupo

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Group name Não Valor do texto O nome do grupo recém-criado
Location Sim Valor do texto O local no qual o grupo será criado
Descrição Sim Valor do texto A descrição do grupo
Group scope N/D Local, Global, Universal Global O escopo do grupo no Active Directory
Group type N/D Segurança, Distribution Segurança O tipo do grupo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object already exists Indica que um objeto com o nome especificado já existe no Active Directory
Active Directory error Erro geral do Active Directory

Obter informações do grupo

Obtém informações sobre um grupo do servidor do Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory

Variáveis produzidas

Argumento Type Descrição
GroupInfo Informações do grupo As informações do grupo

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Active Directory error Erro geral do Active Directory

Obter membros do grupo

Obtém os membros de um grupo no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory

Variáveis produzidas

Argumento Type Descrição
GroupMembers Lista de Membros do grupo A variável que contém os membros do grupo

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Active Directory error Erro geral do Active Directory

Modificar grupo

Modifica um grupo no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory
Operation N/D Renomear grupo, Excluir grupo, Adicionar usuário, Remover usuário Renomear grupo Selecionar a operação a ser executada
New name Não Valor do texto O novo nome do grupo
User distinguished name Não Valor do texto Especificar o nome diferenciado do usuário

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Object already exists Indica que um objeto com o nome especificado já existe no Active Directory
Active Directory error Erro geral do Active Directory

Exemplo

O exemplo a seguir usa a ação Modificar grupo para adicionar o usuário nvarga ao grupo RPATest do Active Directory.

Captura de tela da ação Agrupar.

Criar objeto

Cria um objeto no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Location Sim Valor do texto O local no qual o grupo será criado
Object type N/D Computador, Unidade organizacional Computador O tipo do objeto
Object name Não Valor do texto O nome do objeto recém-criado

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object already exists Indica que um objeto com o nome especificado já existe no Active Directory
Invalid attribute syntax Indica que um determinado atributo é inválido
Active Directory error Erro geral do Active Directory

Excluir objeto

Exclui um objeto no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Active Directory error Erro geral do Active Directory

Mover objeto

Move um objeto no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory
Move to location Não Valor do texto O local para o qual mover o objeto

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory Erro geral do Active Directory
Location can't be empty Indica que o local de um objeto do Active Directory está vazio

Renomear objeto

Renomeia um objeto no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory
New name Não Valor do texto Digite o novo nome do grupo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Object already exists Indica que um objeto com o nome especificado já existe no Active Directory
Active Directory error Erro geral do Active Directory

Criar usuário

Cria um usuário no Active Directory.

Importante

Certifique-se de que o Power Automate para desktop esteja operando com direitos elevados ao executar um fluxo contendo a ação Criar usuário

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Location Sim Valor do texto O local no qual o grupo será criado
First name Não Valor do texto O nome do usuário
Initials Sim Valor do texto As iniciais do usuário
Last name Sim Valor do texto O sobrenome do usuário
Nome de usuário Não Valor do texto O nome de usuário do usuário
Senha Não Entrada direta criptografada ou Valor do texto A senha do usuário
Senha nunca expira N/D Valor booliano False Especificar se a senha do usuário expirará
Disabled account N/D Valor booliano False Especificar se a conta será desabilitada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object already exists Indica que um objeto com o nome especificado já existe no Active Directory
Couldn't set or update password Indica um problema na definição ou na atualização da senha do usuário
Active Directory error Erro geral do Active Directory

Exemplo

O exemplo a seguir cria um novo usuário. O nome de usuário real é Norbert Varga e o nome de usuário é nvarga. As configurações apresentadas criam o usuário no contêiner Usuários e especifica os controladores extra contoso e demonstração.

Captura de tela da ação Criar Usuário.

Obter informações do usuário

Obtém as informações de um usuário no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory

Variáveis produzidas

Argumento Type Descrição
UserInfo Informações do usuário As informações do usuário

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Active Directory error Erro geral do Active Directory

Modificar usuário

Modifique um usuário no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory
Operation N/D Habilitar/desabilitar usuário, Renomear usuário, Excluir usuário, Redefinir senha Habilitar/desabilitar usuário Selecionar a operação a ser executada
Enable user N/D Valor booliano False Habilitar ou desabilitar o usuário
Novo nome Não Valor do texto Digite o novo nome do grupo
Nova senha Não Entrada direta criptografada ou Valor do texto Digite a nova senha do grupo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Object already exists Indica que um objeto com o nome especificado já existe no Active Directory
Invalid attribute syntax Indica que um determinado atributo é inválido
Active Directory error Erro geral do Active Directory
Couldn't set or update password Indica um problema na definição ou na atualização da senha do usuário

Desbloquear usuário

Desbloqueia um usuário do Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Active Directory error Erro geral do Active Directory

Atualizar informações do usuário

Atualiza as informações de um usuário no Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory
Distinguished name Não Valor do texto O nome diferenciado da entrada do Active Directory
Display name Sim Valor do texto O nome de exibição do usuário
First name Sim Valor do texto O nome do usuário
Initials Sim Valor do texto As iniciais do usuário
Last name Sim Valor do texto O sobrenome do usuário
Title Sim Valor do texto O cargo do usuário
The email of the user Sim Valor do texto O email do usuário
The company of the user Sim Valor do texto A empresa do usuário
Telephone number Sim Valor do texto O número de telefone do usuário
Extension Sim Valor do texto A extensão do usuário
City Sim Valor do texto A cidade do usuário
Postal code Sim Valor do texto O código postal do usuário
State Sim Valor do texto O estado do usuário
Country N/D Afeganistão, Ilhas Åland, Albânia, Argélia, Samoa Americana, Andorra, Angola, Anguilla, Antártida, Antígua e Barbuda, Argentina, Armênia, Aruba, Austrália, Áustria, Azerbaijão, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Bélgica, Belize, Benin, Bermudas, Butão, Estado da Bolívia Plurinacional, Bonaire, Bósnia e Herzegovina, Botswana, Ilha Bouvet, Brasil, Território Britânico do Oceano Índico, Brunei Darussalam, Bulgária, Burkina Faso, Burundi, Cabo Verde, Camboja, Camarões, Canadá, Ilhas Cayman, República Centro-Africana, Chade, Chile, China, Ilha Christmas, Ilhas Cocos (Keeling), Colômbia, Comores, Congo, República Democrática do Congo, Ilhas Cook, Costa Rica, Côte d'Ivoire, Croácia, Cuba, Curaçao, Chipre, República Tcheca, Dinamarca, Djibouti, Dominica, República Dominicana, Equador, Egito, El Salvador, Guiné Equatorial, Eritreia, Estônia, Etiópia, Ilhas Falkland, Ilhas Faroé, Fiji, Finlândia, França, Guiana Francesa, Polinésia Francesa, Territórios Franceses do Sul, Gabão, Gâmbia, Geórgia, Alemanha, Gana, Gibraltar, Grécia, Groenlândia, Granada, Guadalupe, Guam, Guatemala, Guernsey, Guiné, Guiné-Bissau, Guiana, Haiti, Ilha Heard e Ilhas McDonald, Santa Sé, Honduras, Região Administrativa Especial de Hong Kong, Hungria, Islândia, Índia, Indonésia, República Islâmica do Irã, Iraque, Irlanda, Ilha de Man, Israel, Itália, Jamaica, Japão, Jersey, Jordânia, Cazaquistão, Quênia, Kiribati, República Democrática Popular da Coreia, República da Coreia, Kuwait, Quirguistão, República Democrática Popular do Laos, Letônia, Líbano, Lesoto, Libéria, Líbia, Liechtenstein, Lituânia, Luxemburgo, Região Administrativa Especial de Macau, Macedônia do Norte, Madagascar, Malaui, Malásia, Maldivas, Mali, Malta, Ilhas Marshall, Martinica, Mauritânia, Maurício, Mayotte, México, Micronésia, Moldávia, Mônaco, Mongólia, Montenegro, Montserrat, Marrocos, Moçambique, Mianmar, Namíbia, Nauru, Nepal, Países Baixos (Holanda), Nova Caledônia, Nova Zelândia, Nicarágua, Níger, Nigéria, Niue, Ilha Norfolk, Ilhas Marianas do Norte, Noruega, Omã, Paquistão, Palau, Estado da Palestina, Panamá, Papua Nova Guiné, Paraguai, Peru, Filipinas, Pitcairn, Polônia, Portugal, Porto Rico, Qatar, Reunião, Romênia, Rússia, Ruanda, São Bartolomeu, Santa Helena, Ascensão e Tristão da Cunha, São Cristóvão e Nevis, Santa Lúcia, São Martinho (parte francesa ), São Pedro e Miquelão, São Vicente e Granadinas, Samoa, São Marino, São Tomé e Príncipe, Arábia Saudita, Senegal, Sérvia, Seychelles, Serra Leoa, Cingapura, Sint Maarten (parte holandesa), Eslováquia, Eslovênia, Ilhas Salomão, Somália, África do Sul, Geórgia do Sul e Ilhas Sandwich do Sul, Sudão do Sul, Espanha, Sri Lanka, Sudão, Suriname, Svalbard e Jan Mayen, Suazilândia, Suécia, Suíça, República Árabe Síria, Taiwan, Tajiquistão, Tanzânia, Tailândia, Timor -Leste, Togo, Tokelau, Tonga, Trinidad e Tobago, Tunísia, Turquia, Turcomenistão, Ilhas Turks e Caicos, Tuvalu, Uganda, Ucrânia, Emirados Árabes Unidos, Reino Unido da Grã-Bretanha e Irlanda do Norte, Estados Unidos da América, Ilhas Menores Distantes dos Estados Unidos, Uruguai, Uzbequistão, Vanuatu, República Bolivariana da Venezuela, Vietnã, Ilhas Virgens Britânicas, Ilhas Virgens Americanas, Wallis e Futuna, Iêmen, Zâmbia, Zimbábue, Nenhum Nenhum(a) O país/região do usuário como um código de duas letras (ISO 3166-1 alpha-2)

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Invalid operation Indica um erro de operação inválida
The server isn't operational Indica que o servidor do Active Directory não está operacional
Unauthorized access Indica que ocorreu um erro de autorização
Active Directory entry not found Indica que a entrada do Active Directory fornecida não foi encontrada no servidor do Active Directory
Object doesn't exist on server Indica que o objeto não existe no servidor do Active Directory
Couldn't set or update password Indica um problema na definição ou na atualização da senha do usuário
Active Directory error Erro geral do Active Directory

Conectar ao servidor

Conecta-se a um servidor do Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
LDAP path Não Valor do texto O caminho de LDAP do servidor do Active Directory
Use authentication N/D Valor booliano False Especifique se a autenticação é necessária para conectar-se ao servidor
Nome de usuário Não Valor do texto O nome de usuário do usuário
Senha Não Entrada direta criptografada ou Valor do texto A senha do usuário
Tipo de autenticação N/D Nenhum, Seguro, Criptografia, Secure Sockets Layer, Servidor somente leitura, Anônimo, Associação rápida, Assinatura, Selagem, Delegação, Associação do servidor Seguro Especificar o tipo de autenticação a ser usado

Variáveis produzidas

Argumento Type Descrição
ParentDirectoryEntry Entrada do Active Directory O pai da entrada do Active Directory a ser usada com ações posteriores do Active Directory

Exceções

Exceção Descrição
Authentication error Indica um erro com a autenticação do usuário
Unauthorized access Indica que ocorreu um erro de autorização
The server isn't operational Indica que o servidor do Active Directory não está operacional
Invalid operation Indica um erro de operação inválida
Active Directory error Erro geral do Active Directory

Encerrar conexão

Encerra a conexão com o servidor do Active Directory.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Descrição
Parent directory entry Não Entrada do Active Directory A entrada pai do servidor do Active Directory

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.