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 |
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: |
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