Фильтры получателей для списков адресов в Exchange Online PowerShell

  • Статья

Фильтры получателей идентифицируют получателей, включенных в списки адресов и общедоступные лицензии. Существует два основных варианта фильтров получателей: заранее подготовленные и пользовательские. В основном это те же параметры фильтрации получателей, которые используются динамическими группами рассылки и политиками адресов электронной почты.

  • Заранее подготовленные фильтры получателей

    • Использует обязательный параметр IncludedRecipient со значением AllRecipientsили одним или несколькими из следующих значений: MailboxUsers, MailContacts, MailGroups, MailUsersили Resources. Вы можете указать несколько значений, разделив их запятыми.

    • Можно также использовать любой из необязательных параметров условного фильтра: ConditionalCompany, ConditionalCustomAttribute[1to15], ConditionalDepartment и ConditionalStateOrProvince.

    Вы указываете несколько значений для условного параметра с помощью синтаксиса "<Value1>","<Value2>".... При указании нескольких значений для одного свойства неявно используется оператор or. Пример: "Отдел равно Продажи или Маркетинг или Финансы".

  • Настраиваемые фильтры получателей. Использует обязательный параметр RecipientFilter с фильтром OPATH.

    • Основной синтаксис фильтра OPATH — ."<Property1> -<Operator> '<Value1>' <Property2> -<Operator> '<Value2>'..."

    • Для всего фильтра OPATH требуются двойные кавычки " " . Хотя фильтр является строкой (не системным блоком), можно также использовать фигурные скобки { }, но только в том случае, если фильтр не содержит переменные, требующие расширения.

    • Дефисы (-) требуются перед всеми операторами. Вот некоторые из наиболее часто используемых операторов:

    • and, orи not.

    • eq и ne (равно и не равно; без учета регистра).

    • lt и gt (меньше и больше).

    • like и notlike (строка содержит и не содержит; требуется по крайней мере один подстановочный знак в строке. Например, "Department -like 'Sales*'".

    • Используйте круглые скобки для группировки <Property> -<Operator> '<Value>' операторов в сложных фильтрах. Например, "(Department -like 'Sales*' -or Department -like 'Marketing*') -and (Company -eq 'Contoso' -or Company -eq 'Fabrikam')". Exchange сохраняет фильтр в свойстве RecipientFilter, заключая каждый оператор в круглые скобки, но их необязательно вводить в таком формате.

    • Дополнительные сведения см. в разделе Дополнительные сведения о синтаксисе OPATH.

Дополнительные сведения о списках адресов см. в разделе Списки адресов в Exchange Online.

Процедуры списка адресов, использующие фильтры получателей, см. в статье Процедуры списка адресов в Exchange Online.