Propriedades filtráveis para o parâmetro RecipientFilter nos cmdlets do Exchange

Utilize o parâmetro RecipientFilter para criar filtros OPATH com base nas propriedades dos objetos do destinatário no Exchange Server 2016 ou posterior e Exchange Online. O parâmetro RecipientFilter está disponível nos seguintes cmdlets:

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

Propriedades de destinatário que podem ser filtradas

As propriedades do destinatário que foram confirmadas para funcionar com o parâmetro RecipientFilter em todos os cmdlets estão descritas na tabela seguinte.

Observações:

• A lista pode incluir:

  • Propriedades que são utilizadas apenas num tipo de ambiente: Microsoft 365, Exchange no local ou híbrido. A propriedade pode existir em objetos de destinatários em todos os ambientes, mas o valor é apenas significativo (um valor diferente de em branco ou None) num tipo de ambiente.
  • Propriedades que estão presentes, mas que correspondem a funcionalidades que já não são utilizadas no Exchange.

• Não pode utilizar propriedades de outras extensões de esquema do Active Directory com o parâmetro RecipientFilter .

• Nem todas as propriedades do destinatário têm uma propriedade do Active Directory correspondente. O valor do nome a apresentar LDAP na tabela é "n/a" para estas propriedades, o que indica que a propriedade é calculada (provavelmente pelo Exchange).

• Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo, $true, $falseou $null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis. Para obter mais informações, veja Informações adicionais sobre sintaxe OPATH.

• Normalmente, utiliza o nome do objeto para propriedades que requerem um valor de objeto válido (por exemplo, uma caixa de correio, um grupo de distribuição ou uma política de endereço de e-mail, mas a propriedade também pode aceitar o nome único (DN) do objeto ou o identificador exclusivo global (GUID). Para localizar o DN ou GUID do objeto, utilize o cmdlet Get- que corresponde ao tipo do objeto (por exemplo, Get-EmailAddressPolicy | Format-List Name,DistinguishedName,GUID).

• As propriedades da cadeia de texto que aceitam carateres universais requerem o -like operador (por exemplo, "Property -like 'abc*'"). No Exchange Online PowerShell, não pode utilizar o caráter universal como prefixo na maioria dos parâmetros (por exemplo, "Property -like '*abc'") não é permitido).

  Dica

  Mesmo que um prefixo de caráter universal funcione num parâmetro de filtro no Exchange Online PowerShell, não recomendamos que o utilize devido a problemas de baixo desempenho.

• A coluna Valor na tabela descreve os valores aceitáveis para o filtro, não necessariamente para a própria propriedade. Por exemplo, uma propriedade pode obviamente conter uma data ou valor numérico, mas quando utiliza essa propriedade num filtro, pode ser tratada como uma cadeia de texto (nenhum valor marcar e carateres universais são suportados).

• Para procurar valores de propriedade em branco ou não em branco, utilize o valor $null (por exemplo, 'Property -eq $null' ou 'Property -ne $null').

• Para considerações de filtragem para os nove cmdlets Exclusivos Get-EXO* no módulo Exchange Online PowerShell, veja Filtros no módulo Exchange Online PowerShell.

• No Exchange Online, não pode utilizar um caráter universal (*) como o primeiro caráter na cadeia de pesquisa.

Para obter mais informações

Exchange Server 2007 foi a primeira versão do Exchange que exigia filtros OPATH em vez de filtros LDAP. Para obter mais informações sobre como converter filtros LDAP em filtros OPATH, consulte o artigo Blogue do Microsoft Exchange Team, Precisa de ajuda para converter os filtros LDAP em OPATH?.