Crear filtros en los comandos de destinatario

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Última modificación del tema: 2007-11-15

Hay diversos comandos del Shell de administración de Exchange que permiten filtrar un conjunto de destinatarios. Hay dos tipos de filtrado con comandos de Exchange: filtrado de resultados y filtrado de atributos dentro de un comando.

Para filtrar resultados debe usar un filtro personalizado. Para filtrar atributos dentro de un comando, puede usar un filtro prefabricado o uno personalizado.

Los filtros prefabricados son filtros de Exchange 2007 de uso común que puede usar para satisfacer diversos criterios de filtrado de destinatarios. Puede usar los filtros prefabricados por ejemplo para:

  • Determinar el ámbito de los destinatarios.

  • Agregar filtrado condicional basado en propiedades como la empresa, el departamento y el estado o la región.

  • Agregar atributos personalizados a los destinatarios.

Cuando sus necesidades de filtrado superan estos parámetros, puede definir un filtro personalizado mediante la sintaxis de filtro OPATH para hacer referencia al conjunto completo de propiedades en el Shell de administración de Exchange.

Filtrado de resultados

El primer tipo de filtrado permite filtrar los resultados de un comando. Por ejemplo, los cmdlets Get-User, Get-Recipient, Get-Mailbox, Get-MailUser, Get-Contact, Get-MailContact, Get-Group, Get-DistributionGroup y Get-DynamicDistributionGroup tienen un parámetro Filter con el que puede especificar qué usuarios o grupos recuperar con el comando. En lugar de recuperar todos los usuarios o grupos, puede especificar un conjunto de usuarios o grupos que recuperar mediante una cadena de filtro. Este tipo de filtro no modifica ninguna configuración ni atributos de objetos. Sólo modifica el conjunto de objetos que devuelve el comando.

Para más información sobre las propiedades a las que se puede aplicar un filtro que pueden usar con el parámetro -Filter, consulte los siguientes temas:

Nota

Usar el parámetro Filtro para modificar los resultados de los comandos es realizar un filtrado en el lado del servidor. El filtrado en el lado del servidor envía el comando y el filtro al servidor para su procesamiento. El Shell de administración de Exchange también admite el filtrado en el lado del cliente, en el que el comando recupera todos los objetos del servidor y, a continuación, aplica el filtro en la ventana de la consola local. Para realizar un filtrado en el lado del cliente, use el cmdlet Where-Object. Si desea más información acerca del filtrado en el lado del cliente y en el lado del servidor, consulte "Cómo filtrar datos" en Trabajo con salidas de comandos.

Filtrado de atributos dentro de un comando

El segundo tipo de filtrado permite especificar qué atributos debería usar el comando. Puede usar un filtro prefabricado o crear su propio filtro personalizado. Por ejemplo, los cmdlets New-DynamicDistributionGroup, Set-DynamicDistributionGroup, New-EmailAddressPolicy, Set-EmailAddressPolicy, New-AddressList, Set-AddressList, New-GlobalAddressList y Set-GlobalAddressList tienen los parámetrosIncludedRecipients, ConditionalCompany, ConditionalDepartment y ConditionalStateOrProvince, que permiten usar filtros prefabricados para determinar el conjunto de usuarios a los que se aplica el comando. Estos cmdlets también tienen el parámetro RecipientFilter, que permite crear su propio filtro personalizado. Tanto con un filtro prefabricado como con uno personalizado, puede especificar los destinatarios que incluir en un grupo de distribución dinámico, una directiva de direcciones de correo electrónico, una lista de direcciones o una lista global de direcciones (LGD).

Para más información sobre las propiedades a las que se puede aplicar un filtro que pueden usar con el parámetro -RecipientFilter, consulte los siguientes temas:

Creación de filtros personalizados

Para crear un filtro personalizado para los resultados de un comando con el parámetro Filter, o para crear un filtro personalizado para los atributos dentro de un comando con el parámetro RecipientFilter, debe especificar una cadena para el filtro. El Shell de administración de Exchange usa la sintaxis de filtrado OPath. OPath es un lenguaje de consultas diseñado para consultar orígenes de datos de objetos. Con el Shell de administración de Exchange ya no necesita usar la sintaxis del Protocolo ligero de acceso a directorios (LDAP) tan complicada que empleaba en Microsoft Exchange Server 2003 para crear filtros. En su lugar, puede crear filtros con la sintaxis OPath más sencilla.

Nota

Para crear un grupo de distribución dinámico, una directiva de direcciones de correo electrónico, una lista de direcciones o una LGD con filtros prefabricados, puede usar un asistente en Consola de administración deExchange o usar el Shell de administración de Exchange. Para crear un grupo de distribución dinámico, una directiva de direcciones de correo electrónico, una lista de direcciones o una LGD con un iltro personalizado, debe usar el cmdlet correspondiente en el Shell de administración de Exchange con el parámetro RecipientFilter.

Ejemplo de filtro predefinido

Este ejemplo describe el uso de filtros prefabricados para crear un grupo de distribución dinámico. La sintaxis de los comandos de ejemplo es similar, pero no idéntica, a la sintaxis que usaría para crear una directiva de direcciones de correo electrónico, una lista de direcciones o una LGD nuevas.

Cuando crea un grupo de distribución dinámico con el Asistente para nuevo grupo de distribución dinámico, debe elegir la siguiente información de filtrado:

  • ¿De qué unidad organizativa desea incluir los destinatarios?

    Nota

    La elección de la unidad organizativa desde la que desea incluir los destinatarios sólo se aplica a la creación de grupos de distribución dinámicos, no a la creación de directivas de direcciones de correo electrónico, listas de direcciones o LGD.

  • ¿Qué tipo de destinatarios desea incluir?

  • ¿Qué condiciones adicionales desea incluir en el filtro?

Las siguientes ilustraciones muestran las páginas del Asistente para nuevo grupo de distribución dinámico en las que elige la información del filtro.

Ilustración 1 Página Configuración del filtro del Asistente para nuevo grupo de distribución dinámico

Página Configuración del filtro

Ilustración 2 Para seleccionar la unidad organizativa, haga clic en Examinar en la página Configuración del filtro del Asistente para nuevo grupo de distribución dinámico

Página Seleccionar unidad organizativa

Ilustración 3 Página Condiciones del Asistente para nuevo grupo de distribución dinámico

Página Condiciones

Cada una de estas opciones de filtrado se corresponde con uno de los parámetros de filtro prefabricado de los comandos New-DynamicDistributionGroup o Set-DynamicDistributionGroup.

La primer opción de filtrado de la unidad organizativa se corresponde con el parámetro RecipientContainer del comando. La segunda opción de filtrado del tipo de destinatarios se corresponde con el parámetro IncludedRecipients. La tercera opción de filtrado de condiciones adicionales se corresponde con los parámetros ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince y ConditionalCustomAttribute.

Nota

El parámetro OrganizationalUnit especifica la ubicación del nuevo grupo de distribución dinámico tras haber sido creado. El parámetro RecipientContainer es un parámetro de filtro que especifica la unidad organizativa en la que residen los destinatarios que se agregarán al grupo de distribución dinámico.

Por ejemplo, en el Asistente para nuevo grupo de distribución dinámico podría seleccionar los destinatarios de la unidad organizativa Contoso.com/Usuarios, seleccionar los objetos UserMailbox y seleccionar la condición necesaria para incluir sólo los destinatarios que tengan el Departamento definido como Finanzas y la Empresa definida como Contoso.

Para crear el mismo grupo de distribución dinámico con el Shell de administración de Exchange, ejecute el siguiente comando:

New-DynamicDistributionGroup -Name ContosoFinance -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"

Para ver las propiedades de este nuevo grupo de distribución, ejecute el siguiente comando:

Get-DynamicDistributionGroup -Identity ContosoFinance | format-list *Recipient*,Included*

La propiedad RecipientFilter muestra la sintaxis OPath de filtro que se empleó para crear este grupo. La propiedad RecipientFilterType es prefabricada, lo que significa que el filtro para este grupo se creó con filtros prefabricados. La propiedad LdapRecipientFilter es una propiedad sólo de lectura que muestra el filtro de LDAP que hubiera usado en versiones anteriores de Exchange para crear este grupo.

Ejemplo de filtro personalizado

Este ejemplo describe cómo usar filtros personalizados para crear un grupo de distribución dinámico. La sintaxis de los comandos de ejemplo es similar, pero no idéntica, a la sintaxis que usaría para crear una directiva de direcciones de correo electrónico, una lista de direcciones o una LGD nuevas.

Para crear un filtro personalizado para un grupo de distribución dinámico debe usar el parámetro RecipientFilter con el cmdlet New-DynamicDistributionGroup o Set-DynamicDistributionGroup.

Por ejemplo, si desea crear un grupo de distribución dinámico de destinatarios de buzón cuyo atributo Empresa esté definido como Contoso y cuya Oficina sea Edificio Norte, debe usar un filtro personalizado. Para crear este grupo de distribución dinámico, ejecute el siguiente comando:

New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }

Nota

El parámetro OrganizationalUnit especifica la ubicación del nuevo grupo de distribución dinámico tras haber sido creado.

Información adicional acerca de la sintaxis OPath

Para crear sus propios filtros personalizados, tenga en cuenta lo siguiente:

  • Use la cadena completa de sintaxis OPath entre llaves { } con el parámetro Filter o RecipientFilter.

  • Incluya un guión antes de todos los operadores.

  • Las operaciones más comunes son:

    • -and (y)

    • -or (o)

    • -not (no)

    • -eq (igual a)

    • -ne (no igual a)

    • -lt (menor que)

    • -gt (mayor que)

    • -like (comparación de cadenas)

    • -notlike (comparación de cadenas)

  • Muchas de las propiedades de los parámetros -RecipientFilter y -Filter aceptan caracteres comodines. Al usar un carácter comodín, use el operador -like en lugar del operador -eq. El operador -like se usa para encontrar modelos que coincidan en tipos variados como, por ejemplo, cadenas, mientras que el operador -eq se usa para encontrar una coincidencia exacta.

  • Use los siguientes comandos para obtener información acerca de los operadores que puede emplear:

    • Help about_logical_operator

    • Help about_comparison_operator

  • Puede usar la mayoría de las propiedades de tipos de destinatarios para crear cadenas de filtros. Para obtener información acerca de las propiedades filtrables que puede usar en un cmdlet específico, consulte los temas de referencia de cmdlet en Shell de administración de Exchange (SP1 y SP2).

Para obtener más información

Para obtener más información acerca de la canalización del resultado en el comando de Shell de administración de Exchange, consulte Canalización.