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:

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*'"