Criando filtros em comandos do destinatário

 

Aplica-se a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Tópico modificado em: 2010-07-28

É possível usar diversos comandos do Shell de Gerenciamento do Exchange para filtrar um conjunto de destinatários. Os seguintes tipos de filtros podem ser criados em um comando Exchange:

• Filtros predefinidos

• Filtros personalizados usando o parâmetro RecipientFilter

• Filtros personalizados usando o parâmetro Filter

• Filtros personalizados usando o parâmetro ContentFilter

No Microsoft Exchange Server 2003 e em versões anteriores, a sintaxe de filtragem LDAP é usada para criar listas de endereço personalizadas, listas de endereço globais (GALs), diretivas de endereços de email e grupos de distribuição. No Exchange Server 2007 e no Exchange Server 2010, a sintaxe de filtragem OPATH substitui a sintaxe de filtragem LDAP. O Exchange oferece suporte a filtros LDAP existentes, mas não permite editá-los. Para poder alterar um filtro LDAP, é necessário atualizá-lo para um filtro OPATH. Para obter mais informações, consulte Atualizar os filtros LDAP personalizados para filtros OPATH.

Sumário

Filtros Predefinidos

Filtros personalizados usando o parâmetro RecipientFilter

Filtros personalizados usando o parâmetro Filter

Filtros personalizados usando o parâmetro ContentFilter

Informações adicionais sobre a sintaxe OPATH

Filtros Predefinidos

Um filtro predefinido é um filtro do Exchange geralmente usado para atender a diversos critérios de filtragem de destinatários ao criar grupos dinâmicos de distribuição, diretivas de endereço de e-mail, listas de endereços ou GALs. Com filtros predefinidos, é possível usar tanto o Shell de Gerenciamento do Exchange quanto um assistente no Console de Gerenciamento do Exchange (EMC). Usando filtros predefinidos, você pode fazer o seguinte:

• Determinar o escopo de destinatários.

• Adicionar filtragem condicional baseada em propriedades, como empresa, departamento e estado ou região.

• Adicionar atributos personalizados a destinatários. Para obter mais informações, consulte Noções básicas sobre os atributos personalizados.

Os seguintes parâmetros são considerados filtros predefinidos:

• IncludedRecipients

• ConditionalCompany

• ConditionalDepartment

• ConditionalStateOrProvince

• ConditionalCustomAttribute1–15.

Há filtros predefinidos disponíveis para os seguintes cmdlets:

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

Exemplo

Este exemplo descreve o uso de filtros predefinidos no Shell para criar um grupo dinâmico de distribuição. A sintaxe neste exemplo é semelhante, mas não idêntica, à usada para criar uma diretiva de endereço de e-mail, lista de endereços ou GAL. Ao criar um filtro predefinido, você deve fazer as seguintes perguntas:

• Você deseja incluir destinatários de qual unidade organizacional (UO)? (Essa pergunta corresponde ao parâmetro RecipientContainer.)

  Dica

  A seleção da UO para essa finalidade só se aplica à criação de grupos dinâmicos de distribuição, não à criação de diretivas de endereços de e-mail, listas de endereços ou GALs.

• Que tipo de destinatários deseja incluir? (Essa pergunta corresponde ao parâmetro IncludedRecipients.)

• Que outras condições deseja incluir no filtro? (Essa pergunta corresponde aos parâmetros ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince e ConditionalCustomAttribute.)

Este exemplo cria o grupo dinâmico de distribuição Contoso Finance para caixas de correio de usuário na UO Contoso.com/Users e especifica uma condição para inclusão apenas de recipientes que tenham o atributo Department definido como Finance e o atributo Company definido como Contoso.

New-DynamicDistributionGroup -Name "Contoso Finance" -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"

Este exemplo exibe as propriedades desse novo grupo dinâmico de distribuição.

Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List *Recipient*,Included*

Voltar ao início

Filtros personalizados usando o parâmetro RecipientFilter

Se os filtros predefinidos não atenderem às suas necessidades de criação ou modificação de grupos dinâmicos de distribuição, diretivas de endereço de e-mail e listas de endereços, você pode criar um filtro personalizado usando o parâmetro RecipientFilter.

O parâmetro de filtragem de destinatário está disponível para os seguintes cmdlets:

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

Para obter mais informações sobre as propriedades filtráveis que podem ser usadas com o parâmetro RecipientFilter, consulte Propriedades filtráveis para o parâmetro de filtro de destinatário.

Exemplo

Este exemplo usa o parâmetro RecipientFilter para criar um grupo dinâmico de distribuição. A sintaxe no exemplo é semelhante, mas não idêntica, à usada para criar uma diretiva de endereço de e-mail, lista de endereços ou GAL.

Este exemplo usa filtros personalizados para criar um grupo dinâmico de distribuição para caixas de correio de usuário que tenham o atributo Company definido como Contoso e o atributo Office definido como North Building.

New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }

Voltar ao início

Filtros personalizados usando o parâmetro Filter

O parâmetro Filter pode ser usado para filtrar os resultados de um comando especificando quais objetos devem ser recuperados. Por exemplo, em vez de recuperar todos os usuários ou grupos, você pode especificar um conjunto de usuários ou grupos usando uma cadeia de caracteres de filtragem. Esse tipo de filtro não modifica nenhuma configuração ou quaisquer atributos de objetos. Ele modifica apenas o conjunto de objetos retornado pelo comando.

O uso do parâmetro Filter para modificar resultados de comandos é conhecido como filtragem de servidor. A filtragem de servidor envia o comando e o filtro para processamento no servidor. O Shell também oferece suporte à filtragem de cliente, na qual o comando recupera todos os objetos do servidor e aplica o filtro na janela do console local. Para fazer a filtragem de cliente, use o cmdlet Where-Object. Para obter mais informações sobre a filtragem de servidor e cliente, consulte "Como filtrar dados" em Trabalhando com Saída do Comando.

Para localizar as propriedades filtráveis de cmdlets que têm o parâmetro Filter, você pode executar o comando Get contra um objeto e formatar a saída por meio de tubulação do parâmetro Format-List. A maioria dos valores retornados estará disponível para utilização no parâmetro Filter. O exemplo a seguir retorna uma lista detalhada para a caixa de correio Ayla.

Get-Mailbox -Identity Ayla | Format-List

O parâmetro Filter está disponível para os seguintes cmdlets:

• Get-ActiveSyncDevice

• Get-ActiveSyncDeviceClass

• Get-CASMailbox

• Get-Contact

• Get-DistributionGroup

• Get-DynamicDistributionGroup

• Get-Group

• Get-Mailbox

• Get-MailContact

• get-MailPublicFolder

• Get-MailUser

• Get-Message

• Get-Queue

• Get-Recipient

• get-RemoteMailbox

• Get-RoleGroup

• Get-SecurityPrincipal

• Get-StoreUsageStatistics

• Get-ThrottlingPolicyAssociation

• Get-UMMailbox

• Get-User

• Remove-Message

• Resume-Message

• Resume-Queue

• Retry-Queue

• Suspend-Message

• Suspend-Queue

Para obter mais informações sobre as propriedades filtráveis que podem ser usadas com o parâmetro Filter, consulte Propriedades filtráveis para o parâmetro de filtro.

Exemplo

Este exemplo usa o parâmetro Filter para retornar informações sobre usuários cujo título contém a palavra "manager".

Get-User -Filter {Title -like '*Manager*'}

Voltar ao início

Filtros personalizados usando o parâmetro ContentFilter

O parâmetro ContentFilter pode ser usado para selecionar o conteúdo específico da mensagem a ser exportado quando o cmdlet New-MailboxExportRequest é usado. Se o comando encontrar uma mensagem que contenha uma correspondência com o filtro de conteúdo, ele a exportará para um arquivo .pst.

Exemplo

Este exemplo cria uma solicitação de exportação que pesquisa a caixa de correio Ayla em busca de mensagens cujo corpo contenha o termo "company prospectus". Se esse termo for encontrado, o comando exportará todas as mensagens que o contenham para um arquivo .pst.

New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "*company prospectus*"}

Para obter mais informações sobre as propriedades filtráveis que podem ser usadas com o parâmetro ContentFilter, consulte Propriedades Filtráveis para o Parâmetro -ContentFilter.

Voltar ao início

Informações adicionais sobre a sintaxe OPATH

Ao criar seus próprios filtros personalizados, lembre-se do seguinte:

• Use chaves { } delimitando toda a cadeia de caracteres da sintaxe OPATH com o parâmetro Filter ou RecipientFilter.

• Inclua o hífen antes de todos os operadores. Os operadores mais comuns incluem:

  • -and

  • -or

  • -not

  • -eq (iguais).

  • -ne (não igual)

  • -lt (menor que)

  • -gt (maior que)

  • -like (comparação de cadeia de caracteres)

  • -notlike (comparação de cadeia de caracteres)

• Muitas das propriedades dos parâmetros RecipientFilter e Filter aceitam caracteres curinga. Se você usar um caractere curinga, utilize o operador like em vez do operador eq. O operador like é usado para localizar correspondências de padrão de tipos avançados, como uma cadeia de caracteres, enquanto o operador eq é usado para localizar uma correspondência exata.

• Execute os comandos a seguir para obter informações sobre os operadores que você pode usar:

  • Help about_logical_operator

  • Help about_comparison_operator

• Você também usar a maioria das propriedades de tipos de destinatários, para criar cadeias de caracteres de filtragem. Para obter informações sobre as propriedades filtráveis que podem ser usadas com um cmdlet específico, consulte os tópicos de referência do cmdlet em Usando o PowerShell com o Exchange 2010 (Shell de Gerenciamento do Exchange).

Voltar ao início

 © 2010 Microsoft Corporation. Todos os direitos reservados.