---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Atividade Consulta do AD

# Atividade Consulta do AD {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A atividade Consulta do AD recupera entradas do Windows Active Directory com base em um filtro de pesquisa LDAP e armazena os resultados como uma cadeia de caracteres JSON que pode ser usada no databus.
Para acessar esta atividade no Editor de fluxo de trabalho, selecione Personalizado e navegue até Atividades PersonalizadasActive Directory.  
Nota:  
Esta atividade substitui uma atividade do AD com o mesmo nome disponível em versões anteriores à Genebra. Se você tiver um fluxo de trabalho que usa essa atividade descontinuada, o seu fluxo de trabalho vai continuar funcionando normalmente após atualizar para a versão Istambul e vai continuar salvando resultados de consulta no bloco de anotações. No entanto, todos os novos fluxos de trabalho devem usar a versão personalizada desta atividade. Esta atividade foi criada com o [Criação de uma atividade PowerShell](https://servicenow-prod.fluidtopics.net/Ar2KgjX9yZB1xQDKNXQuVw#t_CreateAPowershellActivity "Crie uma atividade PowerShell personalizada para retornar dados a um fluxo de trabalho a partir de um host usando o Microsoft PowerShell."), que armazena variáveis de entrada e saída no [databus](https://servicenow-prod.fluidtopics.net/aZwlQOJxnftSzCkxgZ_1eQ#t_ReuseDataInTheActivityDesigner "A guia Dados no Editor de fluxo de trabalho lista todas as atividades personalizadas usadas no fluxo de trabalho atual que produzem dados e exibe esses dados para reutilização em outras atividades personalizadas.") em vez de no bloco de anotações.

## Variáveis de entrada

{#r_QueryAD__table_qjs_44h_dp__entry__2}

| Variável | Descrição |
|-|-|
| DomainController | Endereço IP da máquina controladora de domínio. |
| Propriedades | Uma lista separada por vírgulas de propriedades do Active Directory a serem retornadas. Por exemplo, givenName,SN,title. Se o campo estiver em branco, todas as propriedades serão retornadas. |
| SearchFilter | Uma cadeia de caracteres de filtro LDAP que define os parâmetros de pesquisa. Use qualquer critério de filtragem LDAP válido. Por exemplo, para encontrar contas de usuário correspondentes ao registro de entrada ServiceNow, use: (samaccountname=${workflow.inputs.u_user.user_name}) |
[Tabela 1. Variáveis de entrada do AD de Consulta]

{#r_QueryAD__table_qjs_44h_dp}

## Variáveis de saída

{#r_QueryAD__table_o54_yc1_ts__entry__2}

| Variável | Descrição |
|-|-|
| resultado | Êxito ou falha. |
| errorMessage | O executionResult.errorMessages do [Origens de análise do designer de atividades](https://servicenow-prod.fluidtopics.net/OHRZm7~d7NBO7ww7dBD0DQ#r_ActivityDesignerParsingSources "Esta tabela lista as origens de análise disponíveis com cada modelo de execução."). |
| saída | O resultado da consulta. |
[Tabela 2. Variáveis de saída do AD de Consulta]

{#r_QueryAD__table_o54_yc1_ts}

## Condições

{#r_QueryAD__table_r4q_cd1_ts__entry__2}

| Condição | Descrição |
|-|-|
| Êxito | A consulta foi concluída conforme o esperado. |
| Falha | Ocorreu um erro ao processar a consulta. Detalhes adicionais podem estar disponíveis no log do fluxo de trabalho. |
[Tabela 3. Condições do AD de Consulta]

{#r_QueryAD__table_r4q_cd1_ts}