Set-ContentFilterConfig

Artigo
09/30/2014

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