Пример

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

• Получателей из какого подразделения требуется включить в список? (Этот вопрос относится к параметру RecipientContainer).
  
  

  Примечание.
  Выбор подразделения для этих целей применимо только при создании динамических групп рассылки, а не для политик адресов электронной почты, обычных и глобальных списков адресов.

• Какой тип получателей требуется включить? (Этот вопрос относится к параметру IncludedRecipients).
  
  
• Какие дополнительные условия требуется включить в фильтр? (Этот вопрос относится к параметрам ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince и ConditionalCustomAttribute).
  
  

В этом примере создается динамическая группа распределения Contoso Finance для почтовых ящиков пользователей подразделения Contoso.com/Users, а также указывается условие для включения только пользователей, атрибут Department которых равен Finance, а атрибут Company равен Contoso.

	Скопировать код
New-DynamicDistributionGroup -Name "Contoso Finance" -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"

В этом примере отображаются свойства новой динамической группы рассылки.

	Скопировать код
Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List *Recipient*,Included*

В начало

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

Параметр фильтра получателей доступен для следующих командлетов:

• New-DynamicDistributionGroup
  
  
• Set-DynamicDistributionGroup
  
  
• New-EmailAddressPolicy
  
  
• Set-EmailAddressPolicy
  
  
• New-AddressList
  
  
• Set-AddressList
  
  
• New-GlobalAddressList
  
  
• Set-GlobalAddressList
  
  

Дополнительные сведения о фильтруемых свойствах, которые можно использовать с параметром RecipientFilter, приведены в разделе Фильтруемые свойства для параметра -RecipientFilter.

Пример

Для создания динамической группы рассылки в следующем примере используется параметр RecipientFilter. Синтаксис этого примера подобен, но не идентичен синтаксису, используемому для создания политики адресов электронной почты и обычного или глобального списка адресов.

В этом примере настраиваемые фильтры используются для создания динамической группы рассылки пользовательских почтовых ящиков со значением атрибута Company, равным Contoso, и значением атрибута Office, равным North Building.

	Скопировать код
New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }

В начало

Параметр Filter используется для фильтрации результатов команды и указания получаемых объектов. Например, вместо извлечения информации обо всех пользователях или группах с помощью строки фильтра можно выделить сведения о некотором наборе пользователей или групп. Этот тип фильтра не изменяет конфигурацию или атрибуты объектов. Он только изменяет набор объектов, данные о которых возвращает команда.

Использование параметра Filter для изменения результатов представляет собой фильтрацию на стороне сервера. В случае фильтрации на стороне сервера команда или фильтр обрабатываются на сервере. Командная строка также поддерживает фильтрацию на стороне клиента, при которой в результате выполнения команды с сервера извлекаются данные обо всех объектах, а затем применяется фильтр в окне локальной консоли. Для выполнения фильтрации на стороне клиента используется командлет Where-Object. Дополнительные сведения о фильтрации на стороне сервера и клиента см. подраздел «Фильтрация данных» раздела Работа с выходными данными команды.

Чтобы найти фильтруемые свойства для командлетов с параметром Filter, можно запустить команду Get для объекта и отформатировать вывод путем передачи по конвейеру параметра Format-List. Большинство возвращенных значений будут доступны для использования в параметре Filter. Следующий пример возвращает подробный список почтового ящика пользователя Ayla.

	Скопировать код
Get-Mailbox -Identity Ayla | Format-List

Параметр Filter доступен для следующих командлетов:

• 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
  
  

Дополнительные сведения о фильтруемых свойствах, которые можно использовать с параметром Filter, приведен в разделе Фильтруемые свойства для параметра -Filter.

Пример

В этом примере параметр Filter используется для возврата сведения о пользователях, должность которых содержит слово manager.

	Скопировать код
Get-User -Filter {Title -like '*Manager*'}

В начало

Параметр ContentFilter позволяет выбрать определенное содержимое сообщения для экспорта при использовании командлета New-MailboxExportRequest. При обнаружении сообщения, соответствующего фильтру содержимого, оно экспортируется в PST-файл.

Пример

В этом примере создается запрос на экспорт, который выполняет в почтовом ящике пользователя Ayla поиск сообщений, тело которых содержит фразу company prospectus. Если фраза найдена, то команда экспортирует все файлы с этой фразой в PST-файл.

	Скопировать код
New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "*company prospectus*"}

Дополнительные сведения о фильтруемых свойствах, которые можно использовать с параметром ContentFilter, приведен в разделе Фильтруемые свойства для параметра -ContentFilter.

В начало

При создании настраиваемых фильтров следует обращать внимание на следующие аспекты.

• Заключайте всю строку синтаксиса OPATH с параметрами Filter или RecipientFilter в фигурные скобки { }.
  
  
• Перед всеми операторами необходимо ставить дефис. Наиболее распространенные операторы:
  
  
  • -and
    
    
  • -or
    
    
  • -not
    
    
  • -eq (равно)
    
    
  • -ne (не равно)
    
    
  • -lt (меньше)
    
    
  • -gt (больше)
    
    
  • -like (сравнение строк)
    
    
  • -notlike (сравнение строк)
    
    
• Большинство свойств параметров RecipientFilter и Filter допускают ввод подстановочных знаков. При использовании подстановочного следует применять оператор like вместо оператора eq. Оператор like используется для поиска соответствия шаблону в сложных типах, например строках, а оператор eq используется для поиска точных совпадений.
  
  
• Чтобы получить дополнительные сведения об используемых операторах, используйте следующие команды:
  
  
  • Help about_logical_operator
    
    
  • Help about_comparison_operator
    
    
• Для создания строк фильтра можно использовать большинство свойств типов получателей. Дополнительные сведения о фильтруемых свойствах, которые можно использовать с определенным командлетом, см. в разделах справки для соответствующих командлетов Командная консоль Exchange.
  
  

В начало