Фильтры в модуле PowerShell Exchange Online

Модуль PowerShell Exchange Online содержит девять эксклюзивных командлетов Get-EXO*, оптимизированных для высокоскоростных операций с большим объемом данных и (после подключения к организации) предоставляющих доступ к сотням существующих командлетов в службе. Дополнительные сведения см. в разделе Командлеты в модуле Exchange Online PowerShell.

Чтобы максимально эффективно использовать фильтры в девяти эксклюзивных командлетах Get-EXO* в модуле, необходимо следовать указаниям, приведенным в этой статье.

Совет

Версия 3.0.0 и более поздние версии (2022) называется модулем Exchange Online PowerShell версии 3 (сокращенно — модуль EXO V3). Версия 2.0.5 и более ранние версии (2021) была известна как модуль Exchange Online PowerShell версии 2 (сокращенно — модуль EXO V2).

Используйте фильтрацию на стороне клиента для повышения производительности

При фильтрации на стороне сервера в командлете используются доступные параметры Filter или RecipientFilter.

Фильтрация на стороне клиента использует командлет Where-Object (который также известен как where или ?).

Как правило, лучшая производительность в командлетах Exchange PowerShell достигается при фильтрации на стороне сервера. Однако в модуле PowerShell Exchange Online вы фактически получаете более высокую производительность при использовании фильтрации на стороне клиента. Мы работаем над улучшением производительности серверной фильтрации в модуле.

Неподдерживаемые фильтруемые свойства

Командлеты Get-EXO* в модуле поддерживают большинство фильтруемых свойств , доступных в более старых эквивалентных командлетах. Но в настоящее время существуют некоторые свойства, которые не работают с фильтрацией в командлетах Get-EXO* . Эти свойства описываются в приведенной ниже таблице.

Командлет	Неподдерживаемое фильтруемое свойство	Выводимое имя LDAP
Get-EXOCASMailbox	MemberOfGroup ExternalDirectoryObjectId	memberOf msExchExternalDirectoryObjectId
Get-EXOMailbox	DeletedItemFlags LanguagesRaw MasterAccountSid MemberOfGroup RequireAllSendersAreAuthenticated SCLDeleteThresholdInt SCLJunkThresholdInt SCLQuarantineThresholdInt SCLRejectThresholdInt	deletedItemFlags msExchUserCulture msExchMasterAccountSid memberOf msExchRequireAuthToSendTo msExchMessageHygieneSCLDeleteThreshold msExchMessageHygieneSCLJunkThreshold msExchMessageHygieneSCLQuarantineThreshold msExchMessageHygieneSCLRejectThreshold
Get-EXORecipient	CountryCode ExternalDirectoryObjectId MasterAccountSid MemberOfGroup Members	countryCode msExchExternalDirectoryObjectId msExchMasterAccountSid memberOf участники

Поддерживаемые операторы

Следующие операторы полностью поддерживаются для всех форматов строк в командлетах Get-EXO* в модуле Exchange Online PowerShell:

• Логические операторы:

  • -and
  • -not
  • -or

• Операторы сравнения

  • -eq
  • -ne
  • -lt
  • -gt
  • -like
  • -notlike

Операторы -like и -notlike ограничены в использовании подстановочных знаков (*). В частности, можно использовать подстановочные знаки только в начале строкового значения, в конце строкового значения или в обоих случаях.

Например, следующий поиск текста не поддерживается:

"UPN -like 'A*B*C'

Однако же, поддерживаются следующие поиски:

"UPN -like 'A*' -and UPN -like '*C' -and UPN like '*B*'"