Crear filtros en los comandos de destinatario

Se aplica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Última modificación del tema: 2010-07-28

Puede usar varios comandos del Shell de administración de Exchange para filtrar un conjunto de destinatarios. Puede crear los siguientes tipos de filtros en un comando de Exchange:

• Filtros prefabricados

• Filtros personalizados mediante el parámetro RecipientFilter

• Filtros personalizados mediante el parámetro Filter

• Filtros personalizados mediante el parámetro ContentFilter

En Microsoft Exchange Server 2003 y versiones anteriores, la sintaxis de filtrado de LDAP se usa para crear listas de direcciones personalizadas, listas globales de direcciones (GAL), directivas de correo electrónico y grupos de distribución. En Exchange Server 2007 y Exchange Server 2010, la sintaxis de filtrado OPATH sustituye a la sintaxis LDAP. Exchange admite los filtros LDAP existentes pero no permite editarlos. Para poder cambiar un filtro LDAP, debe actualizarlo a filtro OPATH. Para obtener más información, consulte Actualizar filtros LDAP personalizados a filtros OPATH.

Contenido

Filtros prefabricados

Filtros personalizados mediante el parámetro RecipientFilter

Filtros personalizados mediante el parámetro Filter

Filtros personalizados mediante el parámetro ContentFilter

Información adicional acerca de la sintaxis OPATH

Filtros prefabricados

Los filtros prefabricados son filtros de Exchange de uso común que puede utilizar para satisfacer diversos criterios de filtrado de destinatarios para crear grupos de distribución dinámicos, directivas de direcciones de correo electrónico o GAL. Con los filtros prefabricados puede usar el Shell de administración de Exchange o un asistente en la Consola de administración de Exchange (EMC). Con los filtros prefabricados se puede hacer lo siguiente:

• 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. Para obtener más información, consulte Descripción de los atributos personalizados.

Los siguientes parámetros se consideran filtros prefabricados:

• IncludedRecipients

• ConditionalCompany

• ConditionalDepartment

• ConditionalStateOrProvince

• ConditionalCustomAttribute1–15.

Los filtros prefabricados están disponibles para los siguientes cmdlets:

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

Ejemplo

En este ejemplo se describe el uso de filtros prefabricados en el Shell para crear un grupo de distribución dinámico. La sintaxis de este 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 GAL. Al crear un filtro prefabricado, debe realizar las siguientes preguntas:

• ¿De qué unidad organizativa se van a incluir destinatarios? (Esta pregunta se corresponde con el parámetro RecipientContainer).

  Nota

  La elección de la unidad organizativa para este fin solo 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 GAL.

• ¿Qué tipo de destinatarios desea incluir? (Esta pregunta se corresponde con el parámetro IncludedRecipients).

• ¿Qué condiciones adicionales desea incluir en el filtro? (Esta pregunta se corresponde con los parámetros ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince y ConditionalCustomAttribute).

En este ejemplo se crea el grupo de distribución dinámico Contoso Finance para buzones de correo de la OU Contoso.com/Users y se especifica la condición de incluir solo destinatarios con el atributo Department definido como Finanzas y el atributo Company definido como Contoso.

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

En este ejemplo se muestran las propiedades de este nuevo grupo de distribución dinámica.

Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List *Recipient*,Included*

Volver al principio

Filtros personalizados mediante el parámetro RecipientFilter

Si los filtros prefabricados no cubren sus necesidades de creación o modificación de grupos de distribución dinámicos, directivas de direcciones de correo electrónico o listas de direcciones, puede crear un filtro personalizado usando el parámetro RecipientFilter.

El parámetro de filtro de destinatarios está disponible para los cmdlets siguientes:

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

Para obtener más información sobre las propiedades de filtrado que puede usar con el parámetro RecipientFilter, consulte Propiedades a las que se puede aplicar un filtro para el parámetro -RecipientFilter.

Ejemplo

En el siguiente ejemplo se usa el parámetro RecipientFilter para crear un grupo de distribución dinámico. La sintaxis del 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 GAL.

En este ejemplo se usan filtros personalizados para crear un grupo de distribución dinámico para buzones de usuarios que tienen el atributo Company definido como Contoso y el atributo Office definido como Edificio norte.

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

Volver al principio

Filtros personalizados mediante el parámetro Filter

Puede usar el parámetro Filter para filtrar los resultados de un comando y especificar qué objetos recuperar. Por ejemplo, en lugar de recuperar todos los usuarios o grupos, puede especificar un conjunto de usuarios o grupos 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.

El uso del parámetro Filter para modificar los resultados de los comandos se llama 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 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 Trabajar con salidas de comandos.

Para encontrar las propiedades que se pueden filtrar para los cmdlets que tienen el parámetro Filter, puede ejecutar el comando Get en un objeto y dar formato al resultado con el parámetro Format-List. La mayor parte de los valores devueltos estarán disponibles para usarlos en el parámetro Filter. En el ejemplo siguiente se devuelve una lista detallada para el buzón Ayla.

Get-Mailbox -Identity Ayla | Format-List

El parámetro Filter está disponible para los cmdlets siguientes:

• Get-ActiveSyncDevice

• Get-ActiveSyncDeviceClass

• Get-CASMailbox

• Get-Contact

• Get-DistributionGroup

• Get-DynamicDistributionGroup

• Get-Group

• Get-Mailbox

• Get-MailContact

• get-MailPublicFolder

• Get-MailUser

• Get-Message

• Get-Queue

• Get-Recipient

• get-RemoteMailbox

• Get-RoleGroup

• Get-SecurityPrincipal

• Get-StoreUsageStatistics

• Get-ThrottlingPolicyAssociation

• Get-UMMailbox

• Get-User

• Remove-Message

• Resume-Message

• Resume-Queue

• Retry-Queue

• Suspend-Message

• Suspend-Queue

Para obtener más información sobre las propiedades de filtrado que puede usar con el parámetro Filter, consulte Propiedades a las que se puede aplicar un filtro para el parámetro de filtrado.

Ejemplo

En este ejemplo se usa el parámetro Filter para devolver información sobre los usuarios cuyo cargo contenga la palabra "manager".

Get-User -Filter {Title -like '*Manager*'}

Volver al principio

Filtros personalizados mediante el parámetro ContentFilter

Puede usar el parámetro ContentFilter para seleccionar el contenido específico de los mensajes que desea exportar al usar el cmdlet New-MailboxExportRequest. Si el comando encuentra un mensaje que contiene la coincidencia con el filtro de contenido, exporta dicho mensaje a un archivo .pst.

Ejemplo

En este ejemplo se crea una solicitud de exportación que busca en el buzón de Ayla mensajes cuyo cuerpo contenga la frase "company prospectus". Si se encuentra la cadena, el comando exporta todos los mensajes que la contengan a un archivo .pst.

New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "*company prospectus*"}

Para obtener más información sobre las propiedades de filtrado que puede usar con el parámetro ContentFilter, consulte Propiedades que se pueden filtrar para el parámetro -ContentFilter.

Volver al principio

Información adicional acerca de la sintaxis OPATH

Cuando cree filtros personalizados, tenga en cuenta lo siguiente:

• Utilice llaves {} alrededor de toda la cadena de sintaxis OPATH con los parámetros Filter o RecipientFilter.

• Incluya un guión antes de todos los operadores. Los operadores más comunes incluyen:

  • -and

  • -or

  • -not

  • -eq (es igual)

  • -ne (no es igual)

  • -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 comodín. Si usa un carácter comodín, use el operador like en lugar del operador eq. El operador like se usa para buscar coincidencias de patrones en tipos enriquecidos, como las cadenas, mientras que el operador eq se usa para buscar coincidencias exactas.

• 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 cmdlets en Usar PowerShell con Exchange 2010 (Shell de administración de Exchange).

Volver al principio

 © 2010 Microsoft Corporation. Reservados todos los derechos.