Фильтры получателей в командах консоли управления ExchangeRecipient filters in Exchange Management Shell commands

Для фильтрации набора получателей можно использовать несколько команд командной консоли Exchange.You can use several Exchange Management Shell commands to filter a set of recipients. В команде Exchange можно создавать фильтры следующих типов:You can create the following types of filters in an Exchange command:

  • Предустановленные фильтрыPrecanned filters

  • Настраиваемые фильтры, использующие параметр RecipientFilterCustom filters using the RecipientFilter parameter

  • Настраиваемые фильтры, использующие параметр FilterCustom filters using the Filter parameter

  • настраиваемые фильтры, использующие параметр ContentFilter.Custom filters using the ContentFilter parameter

В более поздних версиях Exchange использовался синтаксис фильтрации LDAP для создания настраиваемых списков адресов, глобальных списков адресов, групп рассылки и политик электронных адресов.Older versions of Exchange used LDAP filtering syntax to create custom address lists, global address lists (GALs), email address policies, and distribution groups. В Exchange Server 2007 и более поздних версиях синтаксис фильтрации OPATH заменен синтаксисом фильтрации LDAP.In Exchange Server 2007 and later versions, OPATH filtering syntax replaced LDAP filtering syntax.

Предустановленные фильтрыPrecanned filters

Предустановленный фильтр — это часто используемый фильтр Exchange, который можно использовать для удовлетворения различных критериев фильтрации получателей для создания динамических групп рассылки, политик адресов электронной почты, списков адресов или глобальных списков адресов.A precanned filter is a commonly used Exchange filter that you can use to meet a variety of recipient-filtering criteria for creating dynamic distribution groups, email address policies, address lists, or GALs. С предУстановленными фильтрами можно использовать командную консоль Exchange или центр администрирования Exchange.With precanned filters, you can use either the Exchange Management Shell or the Exchange admin center (EAC). Предустановленные фильтры позволяют выполнить следующие операции.Using precanned filters, you can do the following:

  • Определение области получателей.Determine the scope of recipients.

  • Добавление условной фильтрации на основе таких свойств, как компания, отдел и область или регион.Add conditional filtering based on properties such as company, department, and state or region.

  • Добавление настраиваемых атрибутов для получателей.Add custom attributes for recipients. Дополнительные сведения см. в статье Custom Attributes.For more information, see Custom Attributes.

Следующие параметры считаются предустановленными фильтрами.The following parameters are considered precanned filters:

  • IncludedRecipientsIncludedRecipients

  • ConditionalCompanyConditionalCompany

  • ConditionalDepartmentConditionalDepartment

  • ConditionalStateOrProvinceConditionalStateOrProvince

  • ConditionalCustomAttribute1 в ConditionalCustomAttribute15.ConditionalCustomAttribute1 to ConditionalCustomAttribute15.

Предустановленные фильтры доступны для следующих командлетов:Precanned filters are available for the following cmdlets:

ПримерExample

В этом примере описывается использование предустановленных фильтров в командной консоли Exchange для создания динамической группы рассылки.This example describes using precanned filters in the Exchange Management Shell to create a dynamic distribution group. Синтаксис задействованных в примере команд подобен синтаксису, который используется для создания политики электронных адресов и обычного или глобального списка адресов, но не идентичен ему.The syntax in this example is similar but not identical to the syntax you would use to create an email address policy, address list, or GAL. При создании заранее подготовленного фильтра необходимо ответить на указанные ниже вопросы.When creating a precanned filter, you should ask the following questions:

  • Получателей из какого подразделения требуется включить в список?From which organizational unit (OU) do you want to include recipients? (Этот вопрос относится к параметру RecipientContainer).(This question corresponds to the RecipientContainer parameter.)

Note

Выбор подразделения для этих целей применимо только при создании динамических групп рассылки, а не для политик адресов электронной почты, обычных и глобальных списков адресов.Selecting the OU for this purpose applies only when creating dynamic distribution groups, and not when creating email address policies, address lists, or GALs.

  • Какой тип получателей требуется включить?What type of recipients do you want to include? (Этот вопрос относится к параметру IncludedRecipients).(This question corresponds to the IncludedRecipients parameter.)

  • Какие дополнительные условия требуется включить в фильтр?What additional conditions do you want to include in the filter? (Этот вопрос относится к параметрам ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince и ConditionalCustomAttribute).(This question corresponds to the ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince, and ConditionalCustomAttribute parameters.)

В этом примере создается динамическая группа распределения Contoso Finance для почтовых ящиков пользователей подразделения Contoso.com/Users, а также указывается условие для включения только пользователей, атрибут Department которых равен Finance, а атрибут Company равен Contoso.This example creates the dynamic distribution group Contoso Finance for user mailboxes in the OU Contoso.com/Users and specifies the condition to include only recipients who have the Department attribute defined as Finance and the Company attribute defined as Contoso.

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

В этом примере отображаются свойства новой динамической группы рассылки.This example displays the properties of this new dynamic distribution group.

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

Настраиваемые фильтры, использующие параметр RecipientFilterCustom filters using the RecipientFilter parameter

Если предустановленные фильтры не соответствуют требованиям к созданию или изменению динамических групп рассылки, политик адресов электронной почты и списков адресов, можно создать настраиваемый фильтр с помощью параметра RecipientFilter.If precanned filters don't meet your needs for creating or modifying dynamic distribution groups, email address policies, and address lists, you can create a custom filter by using the RecipientFilter parameter.

Параметр фильтра получателей доступен для следующих командлетов:The recipient filter parameter is available for the following cmdlets:

Дополнительные сведения о фильтруемых свойствах, которые можно использовать с параметром RecipientFilter , приведены в разделе фильтруемые свойства для параметра RecipientFilter.For more information about the filterable properties you can use with the RecipientFilter parameter, see Filterable properties for the RecipientFilter parameter.

ПримерExample

Для создания динамической группы рассылки в следующем примере используется параметр RecipientFilter.The following example uses the RecipientFilter parameter to create a dynamic distribution group. Синтаксис этого примера подобен, но не идентичен синтаксису, используемому для создания политики адресов электронной почты и обычного или глобального списка адресов.The syntax in this example is similar but not identical to the syntax you use to create an email address policy, address list, or GAL.

В этом примере настраиваемые фильтры используются для создания динамической группы рассылки пользовательских почтовых ящиков со значением атрибута Company, равным Contoso, и значением атрибута Office, равным North Building.This example uses custom filters to create a dynamic distribution group for user mailboxes that have the Company attribute defined as Contoso and the Office attribute defined as North Building.

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

Настраиваемые фильтры, использующие параметр FilterCustom filters using the Filter parameter

Параметр Filter используется для фильтрации результатов команды и указания получаемых объектов.You can use the Filter parameter to filter the results of a command to specify which objects to retrieve. Например, вместо извлечения информации обо всех пользователях или группах с помощью строки фильтра можно выделить сведения о некотором наборе пользователей или групп.For example, instead of retrieving all users or groups, you can specify a set of users or groups by using a filter string. Этот тип фильтра не изменяет конфигурацию или атрибуты объектов.This type of filter doesn't modify any configuration or attributes of objects. Он только изменяет набор объектов, данные о которых возвращает команда.It only modifies the set of objects that the command returns.

Использование параметра Filter для изменения результатов команды называется фильтрацией на стороне сервера.Using the Filter parameter to modify command results is known as server-side filtering. В случае фильтрации на стороне сервера команда или фильтр обрабатываются на сервере.Server-side filtering submits the command and the filter to the server for processing. Командная консоль Exchange также поддерживает фильтрацию на стороне клиента, в которой команда получает все объекты с сервера, а затем применяет фильтр в окне локальной консоли.The Exchange Management Shell also supports client-side filtering, in which the command retrieves all objects from the server and then applies the filter in the local console window. Для выполнения фильтрации на стороне клиента используйте командлет Where-Object.To perform client-side filtering, use the Where-Object cmdlet. Дополнительные сведения о фильтрации на стороне сервера и клиента см. раздел "Фильтрация данных" статьи Working with Command Output.For more information about server-side and client-side filtering, see "How to Filter Data" in Working with Command Output.

Чтобы найти фильтруемые свойства для командлетов с параметром Filter, можно запустить команду Get для объекта и отформатировать вывод путем передачи по конвейеру параметра Format-List.To find the filterable properties for cmdlets that have the Filter parameter, you can run the Get command against an object and format the output by pipelining the Format-List parameter. Большинство возвращенных значений будут доступны для использования в параметре Filter.Most of the returned values will be available for use in the Filter parameter. Следующий пример возвращает подробный список почтового ящика пользователя Ayla.The following example returns a detailed list for the mailbox Ayla.

Get-Mailbox -Identity Ayla | Format-List

Параметр Filter доступен для следующих командлетов получателей:The Filter parameter is available for the following recipient cmdlets:

Дополнительные сведения о фильтруемых свойствах, которые можно использовать с параметром Filter , представлены в разделе Фильтруемые свойства для параметра Filter.For more information about the filterable properties you can use with the Filter parameter, see Filterable properties for the Filter parameter.

ПримерExample

В этом примере параметр Filter используется для возврата сведения о пользователях, должность которых содержит слово manager.This example uses the Filter parameter to return information about users whose title contains the word "manager".

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

Настраиваемые фильтры, использующие параметр ContentFilterCustom filters using the ContentFilter parameter

Параметр ContentFilter позволяет выбрать определенное содержимое сообщения для экспорта при использовании командлета New-MailboxExportRequest.You can use the ContentFilter parameter to select specific message content to export when using the New-MailboxExportRequest cmdlet. При обнаружении сообщения, соответствующего фильтру содержимого, оно экспортируется в PST-файл.If the command finds a message that contains the match to the content filter, it exports the message to a .pst file.

ПримерExample

В этом примере создается запрос на экспорт, который выполняет в почтовом ящике пользователя Ayla поиск сообщений, тело которых содержит фразу company prospectus. Если фраза найдена, то команда экспортирует все файлы с этой фразой в PST-файл.This example creates an export request that searches Ayla's mailbox for messages where the body contains the phrase "company prospectus". If that phrase is found, the command exports all messages with that phrase to a .pst file.

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

Дополнительные сведения о фильтруемых свойствах, которые можно использовать с параметром ContentFilter , приведены в разделе фильтруемые свойства для параметра ContentFilter.For more information about the filterable properties you can use with the ContentFilter parameter, see Filterable Properties for the ContentFilter Parameter.

Дополнительные сведения о синтаксисе OPATHAdditional OPATH syntax information

При создании настраиваемых фильтров следует обращать внимание на следующие аспекты.When creating your own custom filters, be aware of the following:

  • Используйте скобки {} вокруг всей строки фильтра OPATH с помощью параметров Filter и RecipientFilter .Use braces { } around the entire OPATH filter string with the Filter or RecipientFilter parameters.

  • Перед всеми операторами необходимо ставить дефис.Include the hyphen before all operators. Наиболее распространенные операторы:The most common operators include:

    • — и-and

    • — или-or

    • — не-not

    • – EQ достигает-eq (equals)

    • -ne (не равно)-ne (not equal)

    • -lt (меньше)-lt (less than)

    • -gt (больше)-gt (greater than)

    • -like (сравнение строк)-like (string comparison)

    • -notlike (сравнение строк)-notlike (string comparison)

  • Многие свойства для параметров RecipientFilter и Filter принимают подстановочные знаки.Many of the properties for the RecipientFilter and Filter parameters accept wildcard characters. Если используется подстановочный знак, используйте оператор Like вместо оператора EQ .If you use a wildcard character, use the like operator instead of the eq operator. Оператор Like используется для поиска совпадений с шаблонами в расширенных типах, таких как строки, в то время как оператор EQ используется для поиска точного соответствия.The like operator is used to find pattern matches in rich types, such as strings, whereas the eq operator is used to find an exact match.

  • Дополнительные сведения об операторах, которые можно использовать, приведены в следующих статьях:For more information about operators you can use, see:

Документация фильтра получателейRecipient filter documentation

В следующей таблице приведены ссылки на разделы, которые помогут узнать больше о фильтруемых свойствах, которые можно использовать в командах получателей Exchange.The following table contains links to topics that will help you learn more about the filterable properties that you can use with Exchange recipient commands.

СтатьяTopic ОписаниеDescription
Фильтруемые свойства для параметра RecipientFilterFilterable properties for the RecipientFilter parameter Дополнительные сведения о фильтруемых свойствах для параметра RecipientFilter.Learn more about the filterable properties for the RecipientFilter parameter.
Фильтруемые свойства для параметра FilterFilterable properties for the Filter parameter Дополнительные сведения о фильтруемых свойствах для параметра Filter.Learn more about the filterable properties for the Filter parameter.