Partilhar via


Criando um filtro de consulta

Um filtro de consulta instrui os Serviços de Domínio Ative 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 suportam a 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 "<operador lógico>" é um dos seguintes.

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

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

(<attribute><operator><value>)

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

Operador Descrição
"="
Igual
"~="
Aproximadamente igual
"<="
Inferior 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 tiver que aparecer no filtro de consulta como literais, eles deverão ser substituídos pela sequência de escape listada.

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

Além disso, dados binários arbitrários podem ser representados usando a sintaxe da sequência de escape, onde cada byte dos dados binários é codificado com uma barra invertida seguida de 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 seqüência de caracteres de consulta a seguir procurará todos os objetos do tipo "computador".

(objectCategory=computer)

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

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

A seqüê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 seqüência 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: