Criando filtros em comandos do destinatário
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Tópico modificado em: 2007-11-15
Vários comandos do Shell de Gerenciamento do Exchange permitem filtrar um conjunto de destinatários. Há dois tipos de filtragem com comandos do Exchange: filtrar resultados e filtrar atributos dentro de um comando.
Para filtrar resultados, use um filtro personalizado. Para filtrar atributos em um comando, você pode usar um filtro predefinido ou um filtro personalizado.
Um filtro predefinido é um filtro do Exchange 2007 usado normalmente para atender a diversos critérios de filtragem de destinatários. Por exemplo, é possível usar os filtros predefinidos para:
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.
Quando seus requisitos de filtragem excederem esses parâmetros, você pode definir um filtro personalizado por meio da sintaxe de filtragem OPATH, para fazer referência a um conjunto completo de propriedades no Shell de Gerenciamento do Exchange.
Filtrando resultados
O primeiro tipo de filtragem permite filtrar os resultados de um comando. Por exemplo, os cmdlets Get-User, Get-Recipient, Get-Mailbox, Get-MailUser, Get-Contact, Get-MailContact, Get-Group, Get-DistributionGroup e Get-DynamicDistributionGroup têm um parâmetro Filter com o qual é possível especificar os usuários ou grupos a serem recuperados pelo comando. Em vez de recuperar todos os usuários ou grupos, você pode especificar um conjunto de usuários ou grupos a ser recuperado por meio de uma cadeia de caracteres de filtração. Esse tipo de filtro não modifica nenhuma configuração ou atributo de objetos. Ele modifica apenas o conjunto de objetos retornado pelo comando.
Para obter mais informações sobre as propriedades filtráveis que você pode usar com o parâmetro -Filter, consulte os tópicos a seguir:
Dica
Usar o parâmetro Filter para modificar os resultados de comandos é uma filtragem de servidor. A filtragem de servidor envia o comando e o filtro para processamento no servidor. O Shell de Gerenciamento do Exchange tem suporte também para a filtragem de cliente, por meio da 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.
Filtrando atributos em um comando
O segundo tipo de filtragem permite especificar os atributos que o comando deve usar. Você pode usar um filtro predefinido ou criar um filtro personalizado. Por exemplo, os cmdlets New-DynamicDistributionGroup, Set-DynamicDistributionGroup, New-EmailAddressPolicy, Set-EmailAddressPolicy, New-AddressList, Set-AddressList, New-GlobalAddressList e Set-GlobalAddressList têm os parâmetros IncludedRecipients, ConditionalCompany, ConditionalDepartment e ConditionalStateOrProvince, que permitem usar filtros predefinidos para determinar o conjunto de usuários ao qual o comando se aplica. Esses cmdlets também têm o parâmetro RecipientFilter que permite criar um filtro personalizado. Seja com um filtro predefinido ou personalizado, é possível especificar os destinatários a serem incluídos em um grupo dinâmico de distribuição, uma diretiva de endereço de email, uma lista de endereços ou uma GAL (lista de endereços global).
Para obter mais informações sobre as propriedades filtráveis que você pode usar com o parâmetro -RecipientFilter, consulte os tópicos a seguir:
Criando filtros personalizados
Para criar um filtro personalizado para os resultados de um comando, com o parâmetro Filter, ou criar um filtro personalizado para os atributos de um comando, com o parâmetro RecipientFilter, especifique uma cadeia de caracteres para o filtro. O Shell de Gerenciamento do Exchange usa o OPath para a sintaxe de filtragem. OPath é uma linguagem de consulta elaborada para consultar origens de dados de objetos. Com o Shell de Gerenciamento do Exchange, não é mais necessário usar a sintaxe complicada do LDAP (Lightweight Directory Access Protocol), usada no Microsoft Exchange Server 2003 para criar filtros. Em vez disso, você pode criar filtros com a sintaxe mais simples do OPath.
Dica
Para criar um grupo dinâmico de distribuição, uma diretiva de endereço de email, uma lista de endereços ou uma GAL com filtros predefinidos, você pode usar um assistente do Console de Gerenciamento do Exchange ou do Shell de Gerenciamento do Exchange. Para criar um grupo dinâmico de distribuição, uma diretiva de endereço de email, uma lista de endereços ou uma GAL com um filtro personalizado, use o cmdlet adequado do Shell de Gerenciamento do Exchange com o parâmetro RecipientFilter.
Exemplo de filtro predefinido
Este exemplo descreve o uso de filtros predefinidos para criar um grupo dinâmico de distribuição. A sintaxe nos exemplos de comandos é semelhante, mas não idêntica, à usada para criar uma nova diretiva de endereço de email, lista de endereços ou GAL.
Ao criar um grupo dinâmico de distribuição com o Assistente de Novo Grupo Dinâmico de Distribuição, selecione as seguintes informações de filtragem:
Você deseja incluir destinatários de qual unidade organizacional?
Dica
A escolha da unidade organizacional cujos destinatários serão incluídos só se aplica à criação de grupos dinâmicos de distribuição, não à criação de diretivas de endereços de email, listas de endereços ou GALs.
Que tipo de destinatários deseja incluir?
Que outras condições deseja incluir no filtro?
As figuras a seguir mostram as páginas do Assistente de Novo Grupo Dinâmico de Distribuição nas quais você escolherá as informações do filtro.
Figura 1 Página Configurações de Filtro do Assistente de Novo Grupo Dinâmico de Distribuição
.gif "Página Configurações de Filtro")
Figura 2 Para selecionar a unidade organizacional, clique em Procurar, na página Configurações de Filtro do Assistente de Novo Grupo Dinâmico de Distribuição
.gif "Página Selecionar Unidade Organizacional")
Figura 3 Página Condições do Assistente de Novo Grupo Dinâmico de Distribuição
.gif "Página Condições")
Cada uma dessas opções de filtragem corresponde a um dos parâmetros de filtro predefinido nos comandos New-DynamicDistributionGroup ou Set-DynamicDistributionGroup.
A primeira opção de filtragem da unidade organizacional corresponde ao parâmetro RecipientContainer no comando. A segunda opção de filtragem para o tipo de destinatários corresponde ao parâmetro IncludedRecipients. A terceira opção de filtragem para as condições adicionais corresponde aos parâmetros ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince e ConditionalCustomAttribute.
Dica
O parâmetro OrganizationalUnit especifica o local do novo grupo dinâmico de distribuição depois de criado. O parâmetro RecipientContainer é um parâmetro de filtro que especifica a unidade organizacional em que residirão os destinatários adicionados ao grupo dinâmico de distribuição.
Por exemplo, no assistente de Grupo Dinâmico de Distribuição, você poderia selecionar destinatários da unidade organizacional Contoso.com/Users, selecionar objetos do UserMailbox e escolher a condição para incluir somente os destinatários que possuem o Departamento definido como Financeiro e a Empresa definida como Contoso.
Para criar o mesmo grupo dinâmico de distribuição por meio do Shell de Gerenciamento do Exchange, execute o seguinte comando:
New-DynamicDistributionGroup -Name ContosoFinance -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"
Para exibir as propriedades desse novo grupo de distribuição, execute o seguinte comando:
Get-DynamicDistributionGroup -Identity ContosoFinance | format-list *Recipient*,Included*
A propriedade RecipientFilter exibe a sintaxe do filtro OPath usada para criar esse grupo. A propriedade RecipientFilterType é Predefinida, o que significa que a filtragem desse grupo foi criada com filtros predefinidos. LdapRecipientFilter é uma propriedade somente leitura que exibe o filtro LDAP usado em versões anteriores do Exchange para criar esse grupo.
Exemplo de filtro personalizado
Este exemplo descreve o uso de filtros personalizados para criar um grupo dinâmico de distribuição. A sintaxe nos exemplos de comandos é semelhante, mas não idêntica, à usada para criar uma nova diretiva de endereço de email, lista de endereços ou GAL.
Para criar um filtro personalizado para um grupo dinâmico de distribuição, use o parâmetro RecipientFilter com o cmdlet New-DynamicDistributionGroup ou Set-DynamicDistributionGroup.
Por exemplo, para criar um grupo dinâmico de distribuição de destinatários de caixa de correio cujo atributo Empresa esteja definido como Contoso, e cujo Escritório seja o Edifício Norte, use um filtro personalizado. Para criar esse grupo dinâmico de distribuição, execute o seguinte comando:
New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }
Dica
O parâmetro OrganizationalUnit especifica o local do novo grupo dinâmico de distribuição depois de criado.
Informações adicionais sobre a sintaxe do filtro OPath
Para criar seus próprios filtros personalizados, lembre-se do seguinte:
Use chaves { } ao redor da cadeia inteira de caracteres da sintaxe do OPath com o parâmetro Filter ou RecipientFilter.
Inclua o hífen antes de todos os operadores.
As operações mais comuns são as seguintes:
-and
-or
-not
-eq (igual a)
-ne (não é igual a)
-lt (menor que)
-gt (maior que)
-like (comparação de cadeias de caracteres)
-notlike (comparação de cadeias de caracteres)
Muitas das propriedades dos parâmetros -RecipientFilter e -Filter aceitam caracteres curinga. Se você usar um caractere curinga, utilize o operador Como (-like) em vez do operador É igual a (-eq). O operador Como (-like) é usado para localizar correspondências padrão de tipos avançados, como uma cadeia de caracteres, enquanto o operador É igual a (-eq) é usado para localizar uma correspondência exata.
Use os comandos a seguir para obter informações sobre os operadores que você pode usar:
Help about_logical_operatorHelp 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 propriedades filtráveis que você pode usar com um cmdlet específico, consulte os tópicos de referência do cmdlet em Shell de Gerenciamento do Exchange (SP1 e SP2).
Para obter mais informações
Para obter mais informações sobre a saída de pipeline no Shell de Gerenciamento do Exchange, consulte Pipelining.