Compartilhar via


Add-ContentFilterPhrase

 

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

Tópico modificado em: 2007-06-22

Use o cmdlet Add-ContentFilterPhrase para definir palavras personalizadas para o agente do Filtro de Conteúdo. Uma palavra personalizada é uma palavra ou frase que o administrador define para o agente do Filtro de Conteúdo avaliar o conteúdo de um email e aplicar o processamento do filtro adequado.

Sintaxe

Add-ContentFilterPhrase -Phrase <String> -Influence <GoodWord | BadWord> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para personalizar como o agente do Filtro de Conteúdo atribui classificações de SCL (nível de confiança de spam) identificando as palavras ou as frases aprovadas e não aprovadas, primeiro defina as palavras personalizadas.

Uma propriedade necessária de uma palavra ou frase personalizada é o parâmetro Influence. Um destes dois valores é aplicado ao parâmetro Influence: GoodWord ou BadWord.

Uma mensagem que contém uma palavra ou frase personalizada que possui um valor de Influence GoodWord recebe automaticamente uma classificação de SCL 0 e, portanto, ignora o processamento depois do spam. Uma mensagem que contém uma palavra ou frase personalizada que possui um valor de Influence BadWord recebe automaticamente uma classificação de SCL 9 e, portanto, é tratada como spam, de acordo com as diretivas que você configurou em Microsoft Exchange Server 2007.

Você pode inserir palavras ou frases personalizadas em qualquer combinação de letras maiúsculas e minúsculas. No entanto, quando o agente do Filtro de Conteúdo avalia o conteúdo da mensagem, ele ignora se é maiúscula ou minúscula. É possível criar no máximo 800 palavras ou frases personalizadas.

Para obter mais informações sobre como modificar o agente do Filtro de Conteúdo, consulte Set-ContentFilterConfig.

Para executar o cmdlet Add-ContentFilterPhrase, você deve usar a conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para executar o cmdlet Add-ContentFilterPhrase em um computador com a função de servidor Transporte de Borda instalada, faça logon com uma conta que seja membro do grupo Administradores local nesse computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Influence

Necessário(s)

Microsoft.Exchange.Data.Directory.SystemConfiguration.Influence

Os valores válidos são GoodWord e BadWord.

Phrase

Necessário(s)

System.String

Quando você passar um argumento, deverá incluir o parâmetro Phrase entre aspas, se a frase contiver espaços, como mostra o exemplo: "This is a bad phrase". Frases personalizadas devem ter menos de 257 caracteres.

Confirm

Optional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda lê e grava apenas na instância local do ADAM.

WhatIf

Optional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

  

Exemplo

O exemplo de código a seguir mostra um comando Add-ContentFilterPhrase que define uma palavra personalizada que é a frase BadWord, This is a bad phrase.

Add-ContentFilterPhrase -Phrase:"This is a bad phrase" -Influence:BadWord