Filtros no módulo Exchange Online PowerShell

O módulo Exchange Online PowerShell contém nove cmdlets get-EXO* exclusivos otimizados para operações de alta velocidade e alto volume e (depois de se conectar à sua organização) fornece acesso às centenas de cmdlets existentes no serviço. Para obter mais informações, confira Cmdlets no módulo Exchange Online PowerShell.

Para aproveitar ao máximo os filtros nos nove cmdlets exclusivos Get-EXO* no módulo, você precisa seguir as diretrizes neste artigo.

Dica

A versão 3.0.0 e posterior (2022) é conhecida como o módulo Exchange Online PowerShell V3 (abreviado como o módulo EXO V3). A versão 2.0.5 e anterior (2021) era conhecida como o módulo Exchange Online PowerShell V2 (abreviado como o módulo EXO V2).

Usar a filtragem por cliente para obter o melhor desempenho

A filtragem per servidor usa os parâmetros de Filtro ou Filtro de Destinatáriodisponíveis no cmdlet.

Filtragem por cliente usa Where-Objectcmdlet (também conhecido como onde ou ?).

Geralmente, você obtém um desempenho muito melhor nos cmdlets do Exchange PowerShell com filtragem do lado do servidor. No entanto, para o módulo Exchange Online PowerShell, você realmente obtém um melhor desempenho ao usar a filtragem do lado do cliente. Estamos trabalhando para melhorar o desempenho da filtragem do lado do servidor no módulo.

Propriedades filtráveis sem suporte

Os cmdlets Get-EXO* no módulo dão suporte à maioria das propriedades filtradas que estão disponíveis em seus cmdlets mais antigos e equivalentes. No momento, há algumas propriedades que não funcionam com filtragem nos cmdlets Get-EXO* . Essas propriedades estão descritas na tabela a seguir:

Cmdlet	Propriedade filtrável sem suporte	Nome de exibição 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 Membros	countryCode msExchExternalDirectoryObjectId msExchMasterAccountSid memberOf Membro

Operadores com suporte

Os seguintes operadores têm suporte total para todos os formatos de cadeia de caracteres nos cmdlets Get-EXO* no módulo Exchange Online PowerShell:

• Operadores lógicos:

  • -and
  • -not
  • -or

• Operadores de comparação

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

Os operadores -like e -notlike estão limitados no uso de caracteres curinga (*). Especificamente, só é possível usar curingas no início de um valor de cadeia de caracteres, no final de um valor de cadeia de caracteres ou em ambos.

Por exemplo, não há suporte para a pesquisa de texto a seguir:

"UPN -like 'A*B*C'

Há suporte para os seguintes clientes de pesquisa:

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