Gerenciar opções de registro de agente

  • Artigo

Essa seção descreve as opções de registro que você pode definir para controlar o comportamento de processamento em runtime do Agente de Provisionamento do Microsoft Entra.

Configurar o tempo de conexão LDAP

Ao executar operações LDAP nos controladores de domínio do Active Directory configurados, por padrão, o agente de provisionamento usa o valor de tempo limite de conexão padrão de 30 segundos. Se o controlador de domínio levar mais tempo para responder, você poderá ver a seguinte mensagem de erro no arquivo de log do agente:

System.DirectoryServices.Protocols.LdapException: The operation was aborted because the client side timeout limit was exceeded.

As operações de pesquisa LDAP podem levar mais tempo se o atributo de pesquisa não estiver indexado. Como primeira etapa, se você receber o erro acima, primeiro verifique se o atributo de pesquisa/busca está indexado. Se os atributos de pesquisa forem indexados e o erro persistir, você poderá aumentar o tempo limite de conexão LDAP usando as seguintes etapas:

  1. Faça logon como administrador no Windows Server que executa o Agente de Provisionamento do Microsoft Entra.
  2. Use o item de menu Executar para abrir o editor do registro (regedit.exe)
  3. Localize a pasta HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure AD Connect Agents\Azure AD Connect Provisioning Agent
  4. Clique com o botão direito do mouse e selecione "Novo ─> Valor da cadeia de caracteres"
  5. Informe o nome: LdapConnectionTimeoutInMilliseconds
  6. Clique duas vezes no Nome do valor e insira os dados do valor como 60000 milissegundos.

    LDAP Connection Timeout

  7. Reinicie o serviço de provisionamento do Microsoft Entra Connect do console de Serviços.
  8. Se você tiver implantado vários agentes de provisionamento, aplique essa alteração de registro a todos os agentes para fins de consistência.

Configurar a busca de indicação

Por padrão, o Agente de Provisionamento do Microsoft Entra não busca indicações. Talvez você queira habilitar a busca de referência para dar suporte a determinados cenários de provisionamento de entrada de RH, como:

  • Verificando a exclusividade do UPN em vários domínios
  • Resolvendo referências do gerenciador de domínio cruzado

Use as etapas a seguir para ativar a busca de referência:

  1. Faça logon como administrador no Windows Server que executa o Agente de Provisionamento do Microsoft Entra.
  2. Use o item de menu Executar para abrir o editor do registro (regedit.exe)
  3. Localize a pasta HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure AD Connect Agents\Azure AD Connect Provisioning Agent
  4. Clique com o botão direito do mouse e selecione "Novo ─> Valor da cadeia de caracteres"
  5. Informe o nome: ReferralChasingOptions
  6. Clique duas vezes no Nome do valor e insira os dados do valor como 96. Esse valor corresponde ao valor constante para ReferralChasingOptions.All e especifica que a subárvore e as referências de nível base serão seguidas pelo agente.

    Referral Chasing

  7. Reinicie o serviço de provisionamento do Microsoft Entra Connect do console de Serviços.
  8. Se você tiver implantado vários agentes de provisionamento, aplique essa alteração de registro a todos os agentes para fins de consistência.

Observação

Você pode confirmar se as opções do registro foram definidas habilitando o log detalhado. Os logs emitidos durante a inicialização do agente exibirão os valores de configuração escolhidos no registro.

Próximas etapas