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: