Partilhar via


Criando um filtro de consulta

Um filtro de consulta instrui os Serviços de Domínio Active Directory a localizar dados em uma sintaxe de consulta LDAP. Todas as tecnologias de acesso a dados especificadas listadas no tópico Escolhendo a tecnologia de pesquisa oferecem suporte à sintaxe de consulta LDAP.

A sintaxe da consulta LDAP é a seguinte:

<expression><expression>...

Um filtro pode conter uma ou mais expressões. Uma expressão tem a seguinte forma:

(<logicaloperator><comparison><comparison...>)

onde "logicaloperator>"< é um dos seguintes.

Operador Descrição
"|"
Lógico OU
"&"
Lógico E
"!"
Lógico NÃO

e "comparação>"< é o seguinte:

(<attribute><operator><value>)

onde "attribute>" é o lDAPDisplayName do atributo a ser avaliado, "value>" é o valor a ser comparado e "operator>"<<< é um dos seguintes operadores de comparação.

Operador Descrição
"="
Igual a
"~="
Aproximadamente igual
"="<
Menor ou igual a
"=">
Maior ou igual a

Além disso, dependendo da sintaxe do atributo, o "valor>"< pode conter o símbolo curinga ("*"). Um "valor" que contém apenas um curinga verificará a existência de qualquer valor> em "<<atributo>". Se nenhum valor for definido para "<atributo>", o teste falhará.

Se qualquer um dos seguintes caracteres especiais deve aparecer no filtro de consulta como literais, eles devem ser substituídos pela sequência de escape listada.

Caractere ASCII Substituto da sequência de escape
*
"\2a"
(
"\28"
)
"\29"
\
"\5c"
NUL
"\00"

Além disso, dados binários arbitrários podem ser representados usando a sintaxe de sequência de escape codificando cada byte de dados binários com a barra invertida seguida por dois dígitos hexadecimais. Por exemplo, o valor de quatro bytes 0x00000004 é codificado como "\00\00\00\04" em uma cadeia de caracteres de filtro.

Exemplos

A sequência de caracteres de consulta a seguir procurará todos os objetos do tipo "computador".

(objectCategory=computer)

A sequência de caracteres de consulta a seguir procurará todos os objetos do tipo "computador" com um nome que começa com "desktop".

(&(objectCategory=computer)(name=desktop*))

A sequência de caracteres de consulta a seguir procurará todos os objetos do tipo "computador" com um nome que começa com "desktop" ou um nome que começa com "notebook".

(&(objectCategory=computer)(|(name=desktop*)(name=notebook*)))

A cadeia de caracteres de consulta a seguir procurará todos os objetos do tipo "usuário" que tenham um número de telefone residencial.

(&(objectCategory=user)(homePhone=*))

Para obter mais informações sobre cadeias de caracteres de filtro de consulta e exemplos de uso, consulte: