Compartilhar via


Set-ContentFilterConfig

 

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

Tópico modificado em: 2009-05-18

Use o cmdlet Set-ContentFilterConfig para modificar a configuração do filtro de conteúdo em um computador em que a função de servidor Transporte de Borda ou Transporte de Hub esteja instalada.

Sintaxe

Set-ContentFilterConfig [-BypassedRecipients <MultiValuedProperty>] [-BypassedSenderDomains <MultiValuedProperty>] [-BypassedSenders <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <ContentFilterConfig>] [-InternalMailEnabled <$true | $false>] [-OutlookEmailPostmarkValidationEnabled <$true | $false>] [-QuarantineMailbox <Nullable>] [-RejectionResponse <AsciiString>] [-SCLDeleteEnabled <$true | $false>] [-SCLDeleteThreshold <Int32>] [-SCLQuarantineEnabled <$true | $false>] [-SCLQuarantineThreshold <Int32>] [-SCLRejectEnabled <$true | $false>] [-SCLRejectThreshold <Int32>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Este comando modifica a configuração do filtro de conteúdo.

Para executar o cmdlet Set-ContentFilterConfig, você deve usar uma 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 Set-ContentFilterConfig em um computador em que a função de servidor Transporte de Borda esteja 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

BypassedRecipients

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro usa os valores de endereço SMTP dos destinatários de sua organização. O agente do Filtro de Conteúdo não processa a filtragem de conteúdo de mensagens ligadas a endereços listados nesse parâmetro. Para inserir diversos endereços SMTP, separe-os por vírgula, como mostra o exemplo: recipient1@contoso.com, recipient2@contoso.com

Você pode inserir no máximo 800 destinatários.

BypassedSenderDomains

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro usa valores de nome de domínio de domínios de envio. O agente do Filtro de Conteúdo não processa a filtragem de conteúdo de mensagens recebidas de domínios listados nesse parâmetro. Para inserir diversos domínios, separe os endereços por vírgula, como mostra o exemplo: contoso.com, example.com. Um curinga (*) pode ser usado para especificar todos os subdomínios; por exemplo: *.contoso.com. Você pode inserir no máximo 800 domínios.

BypassedSenders

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro usa os valores de endereço SMTP dos remetentes. O agente do Filtro de Conteúdo não processa a filtragem de conteúdo de mensagens recebidas de endereços listados nesse parâmetro. Para inserir diversos endereços SMTP, separe-os por vírgula, como mostra o exemplo: sender1@contoso.com, sender2@example.com

Você pode inserir no máximo 800 endereços SMTP.

Confirm

Opcional

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 nome de domínio totalmente qualificado (FQDN) 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 em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava apenas para a instância ADAM local.

Enabled

Opcional

System.Boolean

A entrada válida para o parâmetro Enabled é $true ou $false. A configuração padrão é $true. Quando o parâmetro Enabled estiver definido como $true, o agente do Filtro de Conteúdo será habilitado no computador em que você estiver executando o comando Set-ContentFilterConfig.

ExternalMailEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro ExternalMailEnabled é $true ou $false. A configuração padrão é $true. Quando o parâmetro ExternalMailEnabled é definido como $true, todas as mensagens de conexões não autenticadas são passadas para o agente do Filtro de Conteúdo para serem processadas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentFilterConfig

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

InternalMailEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro InternalMailEnabled é $true ou $false. A configuração padrão é $false. Quando o parâmetro InternalMailEnabled é definido como $true, todas as mensagens de conexões autenticadas e de domínios autorizados em sua empresa passam pelo agente do Filtro de Conteúdo para serem processadas.

OutlookEmailPostmarkValidationEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro OutlookEmailPostmarkValidationEnabled é $true ou $false. Quando o parâmetro OutlookEmailPostmarkValidationEnabled é definido como $true, o agente do Filtro de Conteúdo envia um quebra-cabeça computacional ao sistema de email do remetente para ser processado. Os resultados da validação do quebra-cabeça são descontados no SCL (nível de confiança de spam) total. Esta funcionalidade é exposta ao usuário do Microsoft Outlook como uma validação Carimbo Postal do Office Outlook 2007. A configuração padrão é $false.

QuarantineMailbox

Opcional

System.Nullable

A entrada válida para o parâmetro QuarantineMailbox é um endereço SMTP. Uma caixa de correio de quarentena de spam é necessária quando você define o parâmetro SCLQuarantineEnabled como True. Todas as mensagens que excedem o valor definido no parâmetro SCLQuarantineThreshold são enviadas para o endereço SMTP definido nesse parâmetro.

RejectionResponse

Opcional

Microsoft.Exchange.Data.AsciiString

Esse parâmetro será necessário se você definir o parâmetro SCLRejectEnabled como True. O parâmetro RejectionResponse aceita uma cadeia de caracteres. Insira o corpo da mensagem que deseja entregar na notificação de falha na entrega a destinatários cujas mensagens correspondam ou excedam o valor SCLRejectThreshold. Não exceda 240 caracteres no argumento. Quando você passa um argumento, é necessário incluir o parâmetro RejectionResponse entre aspas duplas, se a frase contiver espaços, como mostra o exemplo: "Message rejected". A configuração padrão é Message rejected due to content restrictions.

SCLDeleteEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro SCLDeleteEnabled é $true ou $false. A configuração padrão é $false. Quando o parâmetro SCLDeleteEnabled é definido como $true, todas as mensagens que excedem o valor definido no parâmetro SCLDeleteThreshold são excluídas.

SCLDeleteThreshold

Opcional

System.Int32

Esse parâmetro aceita um valor inteiro entre 1 e 9. Esse valor representa a classificação SCL que uma determinada mensagem deve exceder para que o agente do Filtro de Conteúdo exclua a mensagem e não envie uma notificação de falha na entrega. Para habilitar essa funcionalidade, defina o parâmetro SCLDeleteEnabled como True. A configuração padrão é 9.

SCLQuarantineEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro SCLQuarantineEnabled é $true ou $false. A configuração padrão é $false. Quando o parâmetro SCLQuarantineEnabled está definido como $true, todas as mensagens que excedem o valor definido no parâmetro SCLQuarantineThreshold são enviadas à caixa de correio de quarentena de spam especificada no parâmetro QuarantineMailbox.

SCLQuarantineThreshold

Opcional

System.Int32

Esse parâmetro aceita um valor inteiro entre 1 e 9. Esse valor representa a classificação SCL que uma determinada mensagem deve exceder para que o agente do Filtro de Conteúdo coloque a mensagem em quarentena. Para habilitar a funcionalidade de quarentena, defina o parâmetro SCLQuarantineEnabled como True e forneça um endereço SMTP válido no parâmetro QuarantineMailbox. A configuração padrão é 9.

SCLRejectEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro SCLRejectEnabled é $true ou $false. A configuração padrão é $false. Quando o parâmetro SCLRejectEnabled é definido como $true, todas as mensagens que excedem o valor definido no parâmetro SCLRejectThreshold são rejeitadas e uma notificação de falha na entrega é enviada ao remetente.

SCLRejectThreshold

Opcional

System.Int32

Esse parâmetro aceita um valor inteiro entre 1 e 9. Esse valor representa a classificação SCL que uma determinada mensagem deve exceder para que o agente do Filtro de Conteúdo rejeite a mensagem e envie uma notificação de falha na entrega ao remetente. Para habilitar a funcionalidade de exclusão, defina o parâmetro SCLDeleteEnabled como True. Além disso, é possível revisar a mensagem padrão da notificação de falha na entrega editando o parâmetro RejectionResponse. A configuração padrão é 9.

WhatIf

Opcional

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á visualizar 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 primeiro exemplo de código mostra um comando Set-ContentFilterConfig com as seguintes modificações na configuração do Filtro de Conteúdo:

  • Ele habilita e configura as funcionalidades de limite da SCL que colocam em quarentena, rejeitam e excluem mensagens.

  • Ele torna spamQ@contoso.com a caixa de correio de quarentena de spam.

  • Ele define a ação do Filtro de Conteúdo que rejeita todas as mensagens que excedem o limite da SCL.

  • Ele define a resposta de rejeição.

  • Ele define dois usuários cujas mensagens não devem ser processadas pelo Filtro de Conteúdo.

O segundo exemplo de código mostra um comando Set-ContentFilterConfig que especifica um domínio de remetente chamado woodgrovebank.com, cujo e-mail de entrada irá ignorar a filtragem de conteúdo.

Set-ContentFilterConfig -SclQuarantineEnabled:$true -SclRejectEnabled:$true -SclDeleteEnabled:$true -SclQuarantineThreshold 5 -SclRejectThreshold 6 -SclDeleteThreshold 8  -QuarantineMailbox spamQ@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com 
Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com