Ações de Active Directory

As ações do Active Directory requerem uma ligação a um servidor Active Directory. Estabeleça a ligação utilizando a ação Ligar ao servidor do Exchange 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 trabalha com grupos, objetos ou utilizadores, tem de especificar também a localização deles. O campo Localização especifica o recipiente e o controlador de domínio, e deve ter o seguinte formato:

CN=Users,DC=contoso,DC=demo

Depois de obter todos os nomes distintos utilizando o comando dsquery user, introduza o nome distinto no seguinte formato. Para este exemplo, o nome de utilizador é nvarga.

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

Se o nome do recipiente contiver uma vírgula, deve colocar 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 computadores está a operar com direitos elevados quando executa um fluxo que contém a ação Criar um grupo

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Group name	Não	Valor de texto		O nome do grupo recém-criado
Location	Sim	Valor de texto		A localização em que o grupo será criado
Descrição	Sim	Valor de texto		A descrição do grupo
Group scope	N/D	Local, Global, Universal	Global	O âmbito do grupo no Active Directory
Group type	N/D	Segurança, Distribuição	Segurança	O tipo do grupo

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto já existe	Indica que já existe um objeto com o nome especificado no Active Directory
Erro do Active Directory	Erro geral do Active Directory

Obter informações do grupo

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

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory

Variáveis produzidas

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

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory	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 Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory

Variáveis produzidas

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

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory	Erro geral do Active Directory

Modificar grupo

Modifica um grupo no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory
Operation	N/D	Renomear grupo, Eliminar grupo, Adicionar utilizador, Remover utilizador	Mudar nome do grupo	Selecione a operação a efetuar
New name	Não	Valor de texto		O novo nome do grupo
User distinguished name	Não	Valor de texto		Especifique o nome único do utilizador

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
O objeto já existe	Indica que já existe um objeto com o nome especificado no Active Directory
Erro do Active Directory	Erro geral do Active Directory

Exemplo

O exemplo seguinte utiliza a ação Modificar grupo para adicionar o utilizador nvarga ao grupo RPATest do Active Directory.

Criar objeto

Cria um objeto no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Location	Sim	Valor de texto		A localização em que o grupo será criado
Object type	N/D	Computador, unidade Organizacional	Computador	O tipo do objeto
Object name	Não	Valor de texto		O nome do objeto recém-criado

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto já existe	Indica que já existe um objeto com o nome especificado no Active Directory
Sintaxe de atributo inválida	Indica que um determinado atributo é inválido
Erro do Active Directory	Erro geral do Active Directory

Eliminar o objeto

Elimina um objeto no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory	Erro geral do Active Directory

Mover objeto

Move um objeto no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory
Move to location	Não	Valor de texto		A localização para a qual o objeto deve ser movido

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory	Erro geral do Active Directory
A localização não pode estar vazia	Indica que uma localização de objetos do Active Directory está vazia

Mudar nome de objeto

Muda o nome de um objeto no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory
Novo nome	Não	Valor de texto		Introduza o novo nome do grupo

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
O objeto já existe	Indica que já existe um objeto com o nome especificado no Active Directory
Erro do Active Directory	Erro geral do Active Directory

Criar utilizador

Cria um utilizador no Active Directory.

Importante

Certifique-se de que o Power Automate para computadores está a operar com direitos elevados quando executa um fluxo que contém a ação Criar utilizador

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Location	Sim	Valor de texto		A localização em que o grupo será criado
First name	Não	Valor de texto		O nome próprio do utilizador
Initials	Sim	Valor de texto		As iniciais do utilizador
Last name	Sim	Valor de texto		O apelido do utilizador
Nome de utilizador	Não	Valor de texto		O nome de utilizador do utilizador
Palavra-passe	Não	Entrada direta encriptada ou Valor de texto		A palavra-passe do utilizador
Palavra-passe nunca expira	N/D	Valor booleano	Falso	Especifique se a palavra-passe do utilizador irá expirar
Disabled account	N/D	Valor booleano	Falso	Especifique se a conta será desativada

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto já existe	Indica que já existe um objeto com o nome especificado no Active Directory
Não foi possível definir ou atualizar a palavra-passe	Indica um problema ao definir ou atualizar a palavra-passe do utilizador
Erro do Active Directory	Erro geral do Active Directory

Exemplo

O seguinte exemplo cria um novo utilizador. O nome real do utilizador é Norbert Varga e o nome de utilizador é nvarga. As configurações apresentadas criam o utilizador no contentor Utilizadores e especificam os controladores adicionais contoso e demonstração.

Obter informações do utilizador

Obtém as informações de um utilizador no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory

Variáveis produzidas

Argumento	Tipo	Descrição
UserInfo	Informações do utilizador	As informações do utilizador

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory	Erro geral do Active Directory

Modificar utilizador

Modificar um utilizador no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory
Operation	N/D	Ativar/desativar o utilizador, Renomear o utilizador, Eliminar o utilizador, Redefinir a palavra-passe	Ativar/desativar utilizador	Selecione a operação a efetuar
Enable user	N/D	Valor booleano	Falso	Ativar ou desativar o utilizador
Novo nome	Não	Valor de texto		Introduza o novo nome do grupo
Nova palavra-passe	Não	Entrada direta encriptada ou Valor de texto		Introduza a nova palavra-passe do grupo

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
O objeto já existe	Indica que já existe um objeto com o nome especificado no Active Directory
Sintaxe de atributo inválida	Indica que um determinado atributo é inválido
Erro do Active Directory	Erro geral do Active Directory
Não foi possível definir ou atualizar a palavra-passe	Indica um problema ao definir ou atualizar a palavra-passe do utilizador

Desbloquear o utilizador

Desbloqueia um utilizador do Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Erro do Active Directory	Erro geral do Active Directory

Atualizar informações do utilizador

Atualiza as informações de um utilizador no Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Parent directory entry	Não	Entrada do Active Directory		A entrada principal do servidor do Active Directory
Distinguished name	Não	Valor de texto		O nome único da entrada do Active Directory
Display name	Sim	Valor de texto		O nome a apresentar do utilizador
First name	Sim	Valor de texto		O nome próprio do utilizador
Initials	Sim	Valor de texto		As iniciais do utilizador
Last name	Sim	Valor de texto		O apelido do utilizador
Title	Sim	Valor de texto		O cargo do utilizador
The email of the user	Sim	Valor de texto		O e-mail do utilizador
The company of the user	Sim	Valor de texto		A empresa do utilizador
Telephone number	Sim	Valor de texto		O número de telefone do utilizador
Extension	Sim	Valor de texto		A extensão do utilizador
City	Sim	Valor de texto		A localidade do utilizador
Postal code	Sim	Valor de texto		O código postal do utilizador
Estado	Sim	Valor de texto		O distrito do utilizador
Country	N/D	Afeganistão, Ilhas Åland, Albânia, Argélia, Samoa Americana, Andorra, Angola, Anguilla, Antártica, Antígua e Barbuda, Argentina, Arménia, Aruba, Austrália, Áustria, Autoridade Palestiniana, Azerbaijão, Bahamas, Bahrein, Bangladesh, Barbados, Bielorrússia, Bélgica, Belize, Benim, Bermudas, Butão, Estado da Bolívia Plurinacional, Bonaire, Bósnia e Herzegovina, Botsuana, Ilha de Bouvet, Brasil, Território Britânico do Oceano Índico, Brunei Darussalam, Bulgária, Burkina Faso, Chade, Chile, China, Ilha de Natal, Ilhas Cocos (Keeling), Colômbia, Comores, Congo, República Democrática do Congo, Ilhas Cook, Costa Rica, Costa do Marfim, Croácia, Cuba, Curaçau, Chipre, República Checa, Dinamarca, Djibuti, Dominica, República Dominicana, Equador, Egito, El Salvador, Guiné Equatorial, Eritreia, Estónia, Etiópia, Ilhas Falkland (Malvinas), Ilhas Faroé, Fiji, Finlândia, França, Guiana Francesa, Polinésia Francesa, Gana, Gibraltar, Grécia, Gronelândia, Granada, Guadalupe, Guam, Guatemala, Guernsey, Guiné, Guiné-Bissau, Guiana, Haiti, Ilha Heard e Ilhas McDonald, Santa Sé, Honduras, Hungria, Islândia, Índia, Indonésia, República Islâmica do Irão, Iraque, Irlanda, Ilha de Man, Israel, Itália, Jamaica, Japão, Jersey, Jordânia, Cazaquistão, Quénia, Kiribati, República Democrática do Povo, Lesoto, Libéria, Líbia, Liechtenstein, Lituânia, Luxemburgo, Macedónia do Norte, Madagáscar, Malawi, Malásia, Maldivas, Mali, Malta, Ilhas Marshall, Martinica, Mauritânia, Maurícia, Mayotte, México, Micronésia, Moldávia, Mónaco, Mongólia, Montenegro, Montserrat, Marrocos, Moçambique, Myanmar, Namíbia, Nauru, Nepal, Nova Caledónia, Nova Zelândia, Nicarágua, Níger, Nigéria, Niue, Ilha Norfolk, Ilhas Marianas do Norte, Noruega, Omã, Paquistão, Palau, Panamá, Países Baixos, Polónia, Portugal, Porto Rico, Qatar, Região Administrativa Especial de Hong Kong, Região Administrativa Especial de Macau, Reunião, Roménia, Rússia, Ruanda, São Barthélemy, 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 Miquelon, São Vicente e Granadinas, Samoa, São Marino, São Tomé e Príncipe, Arábia Saudita, Senegal, Sérvia, Seychelles, Serra Leoa, Singapura, Sint Maarten (parte holandesa), Eslováquia, Eslovénia, Ilhas Salomão, 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, Turquemenistão, Turcas e Caicos, Tuvalu, Uganda, Ucrânia, Emirados Árabes Unidos, Reino Unido da Grã-Bretanha e Irlanda do Norte, Estados Unidos, República Bolivariana da Venezuela, Vietname, Ilhas Virgens (Britânicas), Ilhas Virgens (EUA), Wallis e Futuna, Iémen, Zâmbia, Zimbabué, Nenhuma	Nenhuma	O país/região do utilizador como um código de duas letras (ISO 3166-1 alpha-2)

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Operação inválida	Indica um erro de operação inválida
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Acesso não autorizado	Indica que ocorreu um erro de autorização
Entrada do Active Directory não encontrada	Indica que a entrada do Active Directory indicada não foi encontrada no servidor do Active Directory
O objeto não existe no servidor	Indica que o objeto não existe no servidor do Active Directory
Não foi possível definir ou atualizar a palavra-passe	Indica um problema ao definir ou atualizar a palavra-passe do utilizador
Erro do Active Directory	Erro geral do Active Directory

Ligar ao servidor

Estabelece ligação a um servidor do Active Directory.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
LDAP path	Não	Valor de texto		O caminho LDAP do servidor do Active Directory
Use authentication	N/D	Valor booleano	Falso	Especifique se é necessária autenticação para ligar ao servidor
Nome de utilizador	Não	Valor de texto		O nome de utilizador do utilizador
Palavra-passe	Não	Entrada direta encriptada ou Valor de texto		A palavra-passe do utilizador
Tipo de autenticação	N/D	Nenhuma, Seguro, Encriptação, Secure Sockets Layer, Servidor de apenas leitura, Anónimo, Vinculação rápida, Assinar, Selar, Delegação, Vinculação de servidor	Seguro	Especifique o tipo de autenticação a utilizar

Variáveis produzidas

Argumento	Tipo	Descrição
ParentDirectoryEntry	Entrada do Active Directory	O elemento principal da entrada do Active Directory para utilização com ações posteriores do Active Directory

Exceções

Exceção	Descrição
Erro de autenticação	Indica um erro na autenticação do utilizador
Acesso não autorizado	Indica que ocorreu um erro de autorização
O servidor não está operacional	Indica que o servidor do Active Directory não está operacional
Operação inválida	Indica um erro de operação inválida
Erro do Active Directory	Erro geral do Active Directory

Fechar ligação

Fecha a ligação com o servidor do Active Directory.

Parâmetros de entrada

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

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.