Predicados da regra de transporte

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Tópico modificado em: 2007-04-09

Este tópico descreve os predicados, as propriedades dos predicados e os valores que estão disponíveis para um computador em que a função de servidor Transporte de Hub ou de Transporte de Borda do Microsoft Exchange Server 2007 esteja instalada. A propriedade do predicado Addresses também é descrita em detalhes por causa de sua complexidade.

No Exchange 2007, os agentes de Regras de Transporte usam predicados para preencher as condições e exceções usadas com uma regra de transporte. As funções de servidor Transporte de Hub e Transporte de Borda podem aplicar regras de transporte a mensagens de email que passam pelas regras do servidor. No entanto, os predicados disponíveis para cada função de servidor são diferentes.

Predicados e propriedades dos predicados

Os predicados instruem uma condição ou exceção para examinar uma parte específica de uma mensagem de email e determinar se a regra de transporte deve ser aplicada a essa mensagem. Alguns predicados examinam os campos Para ou De de uma mensagem, enquanto outros examinam o assunto, o corpo ou o tamanho do anexo. Para que seja possível determinar se uma regra de transporte deve ser aplicada a uma mensagem, a maioria dos predicados requer que você especifique um valor usado pelos predicados para testar a mensagem. Esses valores são atribuídos a uma ou mais propriedades dos predicados. Alguns predicados não requerem propriedades de predicado.

Para atribuir um valor a um predicado, você deve determinar a propriedade do predicado. Por exemplo, você deve usar a propriedade do predicado Words juntamente com a condição SubjectContains. Consulte a tabela 2 das propriedades de predicado que devem ser usadas para servidores de Transporte de Hub. Consulte a tabela 3 das propriedades de predicado que devem ser usadas para servidores de Transporte de Borda.

Alguns predicados exigem que você defina duas propriedades de predicado, pois alguns deles examinam campos específicos nas seções de uma mensagem de email, como os campos de cabeçalho das mensagens. Quando você especifica um predicado para examinar um cabeçalho da mensagem, uma propriedade do predicado determina o campo de cabeçalho específico a ser examinado, enquanto a segunda propriedade determina o valor do cabeçalho da mensagem a ser testado. Nesses casos, também é necessário especificar um valor para a segunda propriedade do predicado na coluna Segunda Propriedade do Predicado das tabelas 2 e 3, dependendo da função de servidor. Por exemplo, você pode configurar um predicado para examinar o campo de cabeçalho Message-ID para uma cadeia de caracteres específica, como contoso.com.

A tabela 1 lista as propriedades do predicado que você pode usar com regras de transporte configuradas em uma servidor de Transporte de Hub ou de Transporte de Borda.

Tabela 1 Propriedades de predicado para regras de transporte em um servidor de Transporte de Hub ou de Transporte de Borda

Propriedade do predicado	Formato esperado	Descrição
`Addresses` e `Addresses2`	Matriz de objetos de grupo de distribuição, contato ou caixa de correio do Active Directory	`Addresses` e `Addresses2` aceitam um só objeto de grupo de distribuição, usuário habilitado para email, contato ou caixa de correio. Consulte "Atribuindo endereços a condições e exceções", posteriormente neste tópico, para obter uma descrição detalhada dessas propriedades de predicado.
`Classification`	Objeto de classificação de mensagem	`Classification` aceita um objeto de classificação da mensagem. Para especificar um objeto de classificação da mensagem, use o comando Get-MessageClassification. Por exemplo, use o seguinte comando para procurar a classificação da mensagem `ExCompanyInternal`: `$Condition.Classification = (Get-MessageClassification ExCompanyInternal).Identity`
`Importance`	Valor único de `High`, `Normal` ou `Bulk`	`Importance` aceita a prioridade de mensagem de uma mensagem de email. Coloque o valor entre aspas duplas.
`Patterns`	Matriz de expressões regulares	A propriedade do predicado `Patterns` aceita uma expressão regular que pode ser usada para fazer a correspondência de texto dinâmico em uma mensagem de email que segue um padrão identificável. Coloque a expressão entre aspas duplas.
`MessageHeader`	Cadeia de caracteres única	`MessageHeader` aceita uma cadeia de caracteres que pode ser usada para especificar um cabeçalho da mensagem de email a ser examinado. Essa propriedade de predicado é usada junto com as propriedades `Words` ou `Patterns`, que especificam o valor do campo de cabeçalho para fazer a correspondência. Coloque a cadeia de caracteres entre aspas duplas.
`SclValue`	Inteiro único	`SclValue` aceita um inteiro que pode ser usado para fazer a correspondência do SCL (nível de confiança de spam) configurado em uma mensagem de email. Coloque o inteiro entre aspas duplas.
`Scope`	Valor único de `InOrganization` ou `NotInOrganization`	`Scope` aceita um valor que é usado para determinar se a mensagem de email foi enviada de dentro ou de fora da organização do Exchange 2007. `Scope` determina também se a mensagem foi enviada para um destinatário que está dentro ou fora da organização. Coloque o valor entre aspas duplas. Um remetente ou destinatário será considerado de dentro da organização se qualquer uma das seguintes condições for verdadeira: O remetente ou destinatário é um usuário habilitado para email, um grupo de distribuição ou uma pasta pública que existe no Active Directory da organização. O domínio do remetente ou destinatário está na lista de domínios aceitos, mas não é um domínio `ExternalRelay`. Além disso, a mensagem deve ser enviada ou recebida usando uma conexão autenticada. Para determinar se os contatos habilitados para email são considerados de dentro ou de fora da organização, a parte de domínio do endereço do destinatário ou remetente é comparada com a lista de domínios aceitos, conforme descrição anterior nesta seção. Para obter mais informações sobre domínios aceitos, consulte Gerenciando domínios aceitos.
`Size`	Inteiro único com quantificador, como `KB` ou `MB`	`Size` aceita um inteiro que especifica o tamanho de um anexo de email. Quando você inserir um inteiro, qualifique o valor com uma das seguintes unidades: `B` (bytes) `KB` (quilobytes) `MB` (megabytes) `GB` (gigabytes) `TB` (terabytes) Inteiros não qualificados são tratados como bytes.
`Words`	Matriz de cadeias de caracteres	A propriedade do predicado `Words` aceita uma cadeia de caracteres que é colocada entre aspas duplas.

Predicados suportados em um servidor de Transporte de Hub

A tabela 2 lista os predicados que podem ser usados com regras de transporte configuradas em um servidor de Transporte de Hub.

Tabela 2 Predicados suportados para regras de transporte em um servidor de Transporte de Hub

Predicado de regra aceito	Nome do predicado	Primeira propriedade de predicado	Segunda propriedade de predicado	Descrição
de pessoas	`From`	`Addresses`	Não se aplica	`From` faz a correspondência de caixas de correio, usuários habilitados para email ou contatos enviados em uma mensagem de email.
de um membro de lista de distribuição	`FromMemberOf`	`Addresses`	Não se aplica	`FromMemberOf` faz a correspondência dos remetentes de uma mensagem de email que sejam membros do grupo de distribuição especificado.
de usuários dentro ou fora da organização	`FromScope`	`Scope`	Não se aplica	`FromScope` faz a correspondência das mensagens de email enviadas do escopo especificado.
enviada a pessoas	`SentTo`	`Addresses`	Não se aplica	`SentTo` faz a correspondência das mensagens de email que contenham caixas de correio, usuários habilitados para email ou contatos que sejam os destinatários da mensagem. As caixas de correio, os usuários habilitados para email e os contatos especificados podem existir em qualquer local nos campos Para, Cc (cópia carbono) ou Cco (cópia oculta) da mensagem.
enviada a um membro da lista de distribuição	`SentToMemberOf`	`Addresses`	Não se aplica	`SentToMemberOf` faz a correspondência de mensagens de email que contenham destinatários que sejam membros do grupo de distribuição especificado. Os destinatários podem existir em qualquer lugar nos campos Para, Cc ou Cco da mensagem de email.
enviada a usuários dentro ou fora da organização	`SentToScope`	`Scope`	Não se aplica	`SentToScope` faz a correspondência das mensagens de email enviadas ao escopo especificado.
entre membros da lista de distribuição e a lista de distribuição	`BetweenMemberOf`	`Addresses`	`Addresses2`	`BetweenMemberOf` faz a correspondência de mensagens de email enviadas entre membros de dois grupos de distribuição.
quando qualquer um dos destinatários no campo Para é pessoas	`AnyOfToHeader`	`Addresses`	Não se aplica	`AnyOfToHeader` faz correspondência das mensagens de email enviadas a caixas de correio, usuários habilitados para email ou contatos que são listados no campo Para de uma mensagem de email.
quando qualquer um dos destinatários no campo Para é um membro da lista de distribuição	`AnyOfToHeaderMemberOf`	`Addresses`	Não se aplica	`AnyOfToHeaderMemberOf` faz correspondência das mensagens de email enviadas a destinatários listados no campo Para de uma mensagem de email e que sejam membros do grupo de distribuição especificado.
quando qualquer um dos destinatários no campo Cc é pessoas	`AnyOfCcHeader`	`Addresses`	Não se aplica	`AnyOfCcHeader` faz correspondência das mensagens de email enviadas a caixas de correio, usuários habilitados para email ou contatos que são listados no campo Cc de uma mensagem de email.
quando qualquer um dos destinatários no campo Cc é um membro da lista de distribuição	`AnyOfCcHeaderMemberOf`	`Addresses`	Não se aplica	`AnyOfCcHeaderMemberOf` faz correspondência das mensagens de email enviadas a destinatários listados no campo Cc de uma mensagem de email e que sejam membros do grupo de distribuição especificado.
quando qualquer um dos destinatários nos campos Para ou Cc é pessoas	`AnyOfToCcHeader`	`Addresses`	Não se aplica	`AnyOfToCcHeader` faz correspondência das mensagens de email enviadas a caixas de correio, usuários habilitados para email ou contatos que são listados nos campos Para ou Cc de uma mensagem de email.
quando qualquer um dos destinatários nos campos Para ou Cc é um membro da lista de distribuição	AnyOfToCcHeaderMemberOf	`Addresses`	Não se aplica	`AnyOfToCcHeaderMemberOf` corresponde às mensagens de email enviadas a destinatários listados nos campos Para ou Cc de uma mensagem de email e são membros do grupo de distribuição especificado.
quando o campo Assunto contém palavras específicas	`SubjectContains`	`Words`	Não se aplica	`SubjectContains` faz a correspondência de mensagens de email que contenham as palavras especificadas no campo de assunto da mensagem.
quando o campo Assunto ou o corpo da mensagem contém palavras específicas	`SubjectOrBodyContains`	`Words`	Não se aplica	`SubjectOrBodyContains` faz a correspondência de mensagens de email que contenham as palavras especificadas no campo de assunto ou corpo da mensagem.
quando o cabeçalho de uma mensagem contém palavras específicas	`HeaderContains`	`MessageHeader`	`Words`	`HeaderContains` faz a correspondência de mensagens de email em que o campo de cabeçalho de mensagem especificado contenha o valor especificado.
quando o endereço De contém palavras específicas	`FromAddressContains`	`Words`	Não se aplica	`FromAddressContains` faz a correspondência de mensagens de email que contenham as palavras especificadas no campo De da mensagem.
quando o campo Assunto contém padrões de texto	`SubjectMatches`	`Patterns`	Não se aplica	`SubjectMatches` faz a correspondência de mensagens de email em que os padrões de texto no campo Assunto da mensagem correspondam a uma expressão regular especificada.
quando o campo Assunto ou o corpo da mensagem contém padrões de texto	`SubjectOrBodyMatches`	`Patterns`	Não se aplica	`SubjectOrBodyMatches` faz a correspondência de mensagens de email em que os padrões de texto no campo Assunto ou no corpo da mensagem correspondam a uma expressão regular especificada.
quando o cabeçalho da mensagem contém padrões de texto	`HeaderMatches`	`MessageHeader`	`Patterns`	`HeaderMatches` faz a correspondência de mensagens de email em que o campo de cabeçalho de mensagem especificado contenha padrões de texto que correspondam a uma expressão regular especificada.
quando o endereço De contém padrões de texto	`FromAddressMatches`	`Patterns`	Não se aplica	`FromAddressMatches` faz a correspondência de mensagens de email que contenham padrões de texto no campo De da mensagem que correspondam a uma expressão regular especificada.
quando algum nome de arquivo de anexo contém padrões de texto	`AttachmentNameMatches`	`Patterns`	Não se aplica	`AttachmentNameMatches` faz a correspondência de mensagens de email que contenham padrões de texto nos nomes de arquivos anexos que correspondam a uma expressão regular especificada.
com uma classificação de SCL (nível de confiança de spam) maior ou igual ao limite	`SclOver`	`SclValue`	Não se aplica	`SclOver` faz correspondência das mensagens de email configuradas usando-se o SCL (nível de confiança de spam) especificado.
quando o tamanho de qualquer anexo é maior ou igual ao limite	`AttachmentSizeOver`	`Size`	Não se aplica	`AttachmentSizeOver` faz a correspondência de mensagens de email que contenham anexos maiores do que o valor especificado.
marcado com classificação	`HasClassification`	`Classification`	Não se aplica	`HasClassification` faz a correspondência das mensagens de email ordenadas com a classificação especificada.
marcado com importância	`WithImportance`	`Importance`	Não se aplica	`WithImportance` faz a correspondência das mensagens de email definidas para a importância especificada.

Predicados suportados em um servidor de Transporte de Borda

A tabela 3 lista os predicados que podem ser usados com regras de transporte configuradas em um servidor de Transporte de Borda.

Tabela 3 Predicados aceitos para regras de transporte em um servidor de Transporte de Borda

Predicado de regra aceito	Nome do predicado	Primeira propriedade de predicado	Segunda propriedade de predicado	Descrição
quando o campo Assunto contém palavras específicas	`SubjectContains`	`Words`	Não se aplica	`SubjectContains` faz a correspondência de mensagens de email que contenham as palavras especificadas no campo Assunto da mensagem.
quando o campo Assunto ou o corpo da mensagem contém palavras específicas	`SubjectOrBodyContains`	`Words`	Não se aplica	`SubjectOrBodyContains` faz a correspondência de mensagens de email que contenham as palavras especificadas no campo Assunto ou no corpo da mensagem.
quando o cabeçalho de uma mensagem contém palavras específicas	`HeaderContains`	`MessageHeader`	`Words`	`HeaderContains` faz a correspondência de mensagens de email em que o campo de cabeçalho de mensagem especificado contenha o valor especificado.
quando o endereço De contém palavras específicas	`FromAddressContains`	`Words`	Não se aplica	`FromAddressContains` faz a correspondência de mensagens de email que contenham as palavras especificadas no campo De da mensagem.
quando qualquer endereço de destinatário contém palavras específicas	`AnyOfRecipientAddressContains`	`Words`	Não se aplica	`AnyOfRecipientAddressContains` faz a correspondência de mensagens de email que contenham as palavras especificadas nos campos Para, Cc (cópia carbono) ou Cco (cópia oculta) da mensagem.
quando o campo Assunto contém padrões de texto	`SubjectMatches`	`Patterns`	Não se aplica	`SubjectMatches` faz a correspondência de mensagens de email em que os padrões de texto no campo Assunto da mensagem correspondam a uma expressão regular especificada.
quando o campo Assunto ou o corpo da mensagem contém padrões de texto	`SubjectOrBodyMatches`	`Patterns`	Não se aplica	`SubjectOrBodyMatches` faz a correspondência de mensagens de email em que os padrões de texto no campo Assunto ou no corpo da mensagem correspondam a uma expressão regular especificada.
quando o cabeçalho da mensagem contém padrões de texto	`HeaderMatches`	`MessageHeader`	`Patterns`	`HeaderMatches` faz a correspondência de mensagens de email em que o campo de cabeçalho de mensagem especificado contenha padrões de texto que correspondam a uma expressão regular especificada.
quando o endereço De contém padrões de texto	`FromAddressMatches`	`Patterns`	Não se aplica	`FromAddressMatches` faz a correspondência de mensagens de email que contenham padrões de texto no campo De da mensagem que correspondam a uma expressão regular especificada.
quando há padrões de texto em qualquer endereço de destinatário	`AnyOfRecipientAddressMatches`	`Patterns`	Não se aplica	`AnyOfRecipientAddressMatches` faz a correspondência de mensagens de email em que os padrões de texto nos campos Para, Cc ou Cco da mensagem correspondam a uma expressão regular especificada.
com uma classificação de SCL (nível de confiança de spam) maior ou igual ao limite	`SclOver`	`SclValue`	Não se aplica	`SclOver` faz a correspondência das mensagens de email configuradas usando-se o SCL especificado.
quando o tamanho de qualquer anexo é maior ou igual ao limite	`AttachmentSizeOver`	`Size`	Não se aplica	`AttachmentSizeOver` faz a correspondência de mensagens de email que contenham anexos maiores do que o valor especificado.
de usuários dentro ou fora da organização	`FromScope`	`Scope`	Não se aplica	`FromScope` faz a correspondência das mensagens de email enviadas do escopo especificado.

Atribuindo endereços a condições e exceções

A propriedade do predicado Addresses requer que você transmita um objeto completo de grupo de distribuição, usuário habilitado para email, contato ou caixa de correio para a propriedade. Endereços de email SMTP não são valores válidos para essa propriedade. Os valores atribuídos à propriedade do predicado Addresses devem estar em uma matriz.

Para transmitir um objeto de grupo de distribuição, usuário habilitado para email, contato ou caixa de correio à propriedade do predicado Addresses, você deve chamar o comando adequado do Shell de Gerenciamento do Exchange de dentro da matriz e fornecer o comando com a identidade ou o nome do objeto. É necessário colocar o nome e a identidade do comando entre parênteses. Use a seguinte sintaxe de comando:

$Condition.Addresses = @((Get-Mailbox <Mailbox Name>), (Get-MailContact <Contact Name>), (Get-MailUser <Mail-Enabled User>), (Get-DistributionGroup <Distribution Group Name>))

Para atribuir valores à propriedade do predicado Addresses

Execute o seguinte comando para atribuir um único objeto de caixa de correio:
```
$Condition.Addresses = @((Get-Mailbox "Ted Bremer"))
```
Execute o seguinte comando para atribuir um único objeto de contato de correio:
```
$Condition.Addresses = @((Get-MailContact "Masato Kawai"))
```
Execute o seguinte comando para atribuir um único objeto de usuário habilitado para correio:
```
$Condition.Addresses = @((Get-MailUser "Pilar Ackerman"))
```
Execute o seguinte comando para um único objeto de grupo de distribuição:
```
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
```

Execute o seguinte comando para atribuir uma mistura de objetos de grupo de distribuição, usuário e caixa de correio:

$Condition.Addresses = @((Get-Mailbox "Ted Bremer"), (Get-Mailbox "Kim Akers"), (Get-MailContact "Pilar Ackerman"), (Get-MailContact "Adam Barr"), (Get-MailUser "Chris Meyer"), (Get-DistributionGroup "Marketing Group"), (Get-DistributionGroup "Research Group"))

Para obter mais informações

Para obter informações detalhadas sobre sintaxe e parâmetros de cada comando, consulte os seguintes tópicos:

Para obter mais informações sobre regras de transporte, consulte os tópicos a seguir:

Compartilhar via