Compartilhar via


Filtros de destinatário para listas de endereços no PowerShell do Exchange Online

Os filtros de destinatário identificam os destinatários incluídos em listas de endereços e GALs. Há duas opções básicas: filtros de destinatário predefinidos e filtros de destinatário personalizados. Essas são basicamente as mesmas opções de filtragem de destinatário que são usadas por grupos de distribuição dinâmicos e políticas de endereço de email.

  • Filtros de destinatários predefinidos

    • Usa o parâmetro IncludedRecipient necessário com o AllRecipients valor ou um ou mais dos seguintes valores: MailboxUsers, MailContacts, MailGroups, MailUsersou Resources. Vários valores, separados por vírgulas, podem ser especificados.

    • Você também pode usar qualquer um dos parâmetros de filtro condicional opcionais: ConditionalCompany, ConditionalCustomAttribute[1to15], ConditionalDepartment e ConditionalStateOrProvince.

    Você especifica vários valores para um parâmetro condicional usando a sintaxe "<Value1>","<Value2>".... Vários valores da mesma propriedade implicam o operador ou . Por exemplo, "Departamento é igual a Vendas, Marketing ou Finanças".

  • Filtros de destinatário personalizados: usa o parâmetro RecipientFilter necessário com um filtro OPATH.

    • A sintaxe básica do filtro OPATH é "<Property1> -<Operator> '<Value1>' <Property2> -<Operator> '<Value2>'...".

    • Aspas " " duplas são necessárias em torno de todo o filtro OPATH. Embora o filtro seja uma cadeia de caracteres { }(não um bloco do sistema), você também pode usar chaves , mas somente se o filtro não contiver variáveis que exigem expansão.

    • Hifens (-) são necessários antes de todos os operadores. Aqui estão alguns dos operadores mais usados:

    • and, ore not.

    • eq e ne (é igual e não é igual; não é sensível a casos).

    • lt e gt (menor e maior que).

    • like e notlike (a cadeia de caracteres contém e não contém; requer pelo menos um curinga na cadeia de caracteres. Por exemplo, "Department -like 'Sales*'".

    • Use parênteses para agrupar <Property> -<Operator> '<Value>' instruções em filtros complexos. Por exemplo, "(Department -like 'Sales*' -or Department -like 'Marketing*') -and (Company -eq 'Contoso' -or Company -eq 'Fabrikam')". O Exchange armazena o filtro na propriedade RecipientFilter com cada instrução individual entre parênteses, mas você não precisa inseri-los dessa forma.

    • Para obter mais informações, consulte Informações adicionais de sintaxe OPATH.

Para obter mais informações sobre listas de endereços, consulte Listas de endereços no Exchange Online.

Para procedimentos de lista de endereços que usam filtros de destinatário, consulte Procedimentos de lista de endereços no Exchange Online.