Crear un filtro de consulta

  • Artículo

Un filtro de consulta indica a Servicios de dominio de Active Directory buscar datos en una sintaxis de consulta LDAP. Todas las tecnologías de acceso a datos especificadas enumeradas en el tema Elegir la tecnología de búsqueda admiten la sintaxis de consulta LDAP.

La sintaxis de la consulta LDAP es la siguiente:

<expression><expression>...

Un filtro puede contener una o varias expresiones. Una expresión tiene el siguiente formato:

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

donde "<logicaloperator>" es uno de los siguientes.

Operator Descripción
"|"
 OR lógico
"&"
 AND lógico
"!"
 NOT lógico

y "<comparison>" son los siguientes:

(<attribute><operator><value>)

donde "<attribute>" es el lDAPDisplayName del atributo que se va a evaluar, "<value>" es el valor con el que se va a comparar y "<operator>" es uno de los siguientes operadores de comparación.

Operator Descripción
"="
 Equals
"~="
 Aproximadamente igual a
"<="
 Menor o igual que
">="
 Mayor o igual que

Además, dependiendo de la sintaxis del atributo, el "<valor>" puede contener el símbolo comodín ("*"). Un "<valor>" que contiene solo un carácter comodín comprobará la existencia de cualquier valor en "<attribute>". Si no se establece ningún valor para "<attribute>", se producirá un error en la prueba.

Si alguno de los siguientes caracteres especiales debe aparecer en el filtro de consulta como literales, debe reemplazarse por la secuencia de escape enumerada.

Carácter ASCII Sustituto de secuencia de escape
*
 "\2a"
(
 "\28"
)
 "\29"
\
 "\5c"
NUL
 "\00"

Además, los datos binarios arbitrarios se pueden representar mediante la sintaxis de secuencia de escape mediante la codificación de cada byte de datos binarios con la barra diagonal inversa seguida de dos dígitos hexadecimales. Por ejemplo, el valor de cuatro bytes 0x00000004 se codifica como "\00\00\00\04" en una cadena de filtro.

Ejemplos

La siguiente cadena de consulta buscará todos los objetos de tipo "equipo".

(objectCategory=computer)

La siguiente cadena de consulta buscará todos los objetos de tipo "computer" con un nombre que comience por "desktop".

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

La siguiente cadena de consulta buscará todos los objetos de tipo "equipo" con un nombre que comience por "escritorio" o un nombre que comience por "notebook".

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

La siguiente cadena de consulta buscará todos los objetos de tipo "usuario" que tengan un número de teléfono particular.

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

Para obtener más información sobre las cadenas de filtro de consulta y los ejemplos de uso, consulte: