Фильтруемые свойства для параметра RecipientFilter в командлетах Exchange

Параметр RecipientFilter используется для создания фильтров OPATH на основе свойств объектов recipient в Exchange Server 2016 или более поздней версии, а также Exchange Online. Параметр RecipientFilter доступен в следующих командлетах:

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

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

Примечания.

• Список может включать:

  • Свойства, используемые только в среде одного типа: Microsoft 365, локальной среде Exchange или гибридной среде. Свойство может существовать для объектов-получателей во всех средах, но значение имеет смысл только (значение, отличное от пустого или None) в среде одного типа.
  • Свойства, которые присутствуют, но соответствуют функциям, которые больше не используются в Exchange.

• Нельзя использовать свойства из других расширений схемы Active Directory с параметром RecipientFilter .

• Не для всех свойств получателей есть соответствующее свойство Active Directory. Отображаемое имя LDAP в таблице равно "n/a" для этих свойств, что указывает на то, что свойство вычисляется (вероятно, Exchange).

• Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. Дополнительные сведения см. в разделе Дополнительные сведения о синтаксисе OPATH.

• Как правило, для свойств, требующих действительного значения объекта (например, почтового ящика, группы рассылки или политики электронных адресов), используется имя объекта, но свойство также может принимать различающееся имя (DN) или глобальный уникальный идентификатор (GUID) объекта. Чтобы определить DN или GUID объекта, используйте командлет Get-, соответствующий типу объекта (например, Get-EmailAddressPolicy | Format-List Name,DistinguishedName,GUID).

• Для свойств текстовой строки, которые принимают подстановочные знаки -like , требуется оператор (например, "Property -like 'abc*'"). В Exchange Online PowerShell нельзя использовать подстановочный знак в качестве префикса в большинстве параметров (например, "Property -like '*abc'").

  Совет

  Даже если префикс с подстановочными знаками работает в параметре фильтра в Exchange Online PowerShell, мы не рекомендуем использовать его из-за проблем с низкой производительностью.

• В столбце "Значение" этой таблицы описываются допустимые значения для параметра filter, но не обязательно для самого свойства. Например, свойство может содержать дату или числовое значение, но при использовании этого свойства в фильтре оно может рассматриваться как текстовая строка (без проверки значения и с поддержкой подстановочных знаков).

• Чтобы найти пустые или непустые значения свойств, используйте значение $null (например, 'Property -eq $null' или 'Property -ne $null').

• Рекомендации по фильтрации для девяти эксклюзивных командлетов Get-EXO* в модуле Exchange Online PowerShell см. в разделе Фильтры в модуле Exchange Online PowerShell.

• В Exchange Online нельзя использовать подстановочный знак (*) в качестве первого символа в строке поиска.

Exchange Server 2007 году была первой версией Exchange, в которую вместо фильтров LDAP требовались фильтры OPATH. Дополнительные сведения о преобразовании фильтров LDAP в фильтры OPATH см. в статье Блога группы разработчиков Microsoft Exchange: Нужна помощь в преобразовании фильтров LDAP в OPATH?.