Compartilhar via


Set-ContentFilterConfig

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-ContentFilterConfig para modificar a configuração do filtro de conteúdo em um servidor de caixa de correio ou em um servidor de Transporte de Borda.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-ContentFilterConfig
   [-BypassedRecipients <MultiValuedProperty>]
   [-BypassedSenderDomains <MultiValuedProperty>]
   [-BypassedSenders <MultiValuedProperty>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExternalMailEnabled <Boolean>]
   [-InternalMailEnabled <Boolean>]
   [-OutlookEmailPostmarkValidationEnabled <Boolean>]
   [-QuarantineMailbox <SmtpAddress>]
   [-RejectionResponse <AsciiString>]
   [-SCLDeleteEnabled <Boolean>]
   [-SCLDeleteThreshold <Int32>]
   [-SCLQuarantineEnabled <Boolean>]
   [-SCLQuarantineThreshold <Int32>]
   [-SCLRejectEnabled <Boolean>]
   [-SCLRejectThreshold <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com

Este exemplo especifica o domínio do remetente woodgrovebank.com como um domínio ignorado. As mensagens recebidas desse domínio ignoram o agente filtro de conteúdo.

Exemplo 2

Set-ContentFilterConfig -SCLQuarantineEnabled $true -SCLRejectEnabled $true -SCLDeleteEnabled $true -SCLQuarantineThreshold 5 -SCLRejectThreshold 6 -SCLDeleteThreshold 8 -QuarantineMailbox SpamQuarantineMailbox@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com

Este exemplo faz as seguintes modificações na configuração do agente do Filtro de Conteúdo:

Ele habilita e configura as funcionalidades de limite de SCL que colocam em quarentena, rejeitam e excluem mensagens para 5, 6 e 8, respectivamente.

Ele especifica como a caixa de SpamQuarantineMailbox@contoso.com correio de quarentena de spam.

Ele define dois usuários para os quais o Filtro de Conteúdo não processará mensagens.

Parâmetros

-BypassedRecipients

O parâmetro BypassedRecipients especifica os valores de endereço SMTP dos destinatários em sua organização. O agente filtro de conteúdo não processa nenhuma filtragem de conteúdo para mensagens associadas aos endereços listados neste parâmetro. Para inserir vários endereços SMTP, separe os endereços usando uma vírgula, por exemplo: recipient1@contoso.com,recipient2@contoso.com. O número máximo de destinatários que você pode inserir é 100.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassedSenderDomains

O parâmetro BypassedSenderDomains especifica valores de nome de domínio de envio de domínios. O agente filtro de conteúdo não processa nenhuma filtragem de conteúdo para mensagens recebidas dos domínios listados neste parâmetro. Para inserir vários domínios, separe os endereços usando uma vírgula, por exemplo: contoso.com, example.com. Um caractere curinga (*) pode ser usado para especificar todos os subdomínios, por exemplo: *.contoso.com. O número máximo de domínios que você pode inserir é 100.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassedSenders

O parâmetro BypassedSenders especifica os valores de endereço SMTP de remetentes. O agente filtro de conteúdo não processa nenhuma filtragem de conteúdo para mensagens recebidas dos endereços listados neste parâmetro. Para inserir vários endereços SMTP, separe os endereços usando uma vírgula, por exemplo: sender1@contoso.com, sender2@example.com. O número máximo de endereços SMTP que você pode inserir é 100.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

O parâmetro Habilitado habilita ou desabilita o agente filtro de conteúdo no computador no qual você está executando o comando. A entrada válida para o parâmetro Enabled é $true ou $false. A configuração padrão é $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalMailEnabled

O parâmetro ExternalMailEnabled especifica se todas as mensagens de conexões não autenticadas de fontes externas à sua organização do Exchange são passadas pelo agente filtro de conteúdo para processamento. 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 pelo agente filtro de conteúdo para processamento.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalMailEnabled

O parâmetro InternalMailEnabled especifica se todas as mensagens de conexões autenticadas e de domínios autoritários em sua empresa são passadas pelo agente filtro de conteúdo para processamento. 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 autoritativos em sua empresa são passadas pelo agente filtro de conteúdo para processamento.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-OutlookEmailPostmarkValidationEnabled

O parâmetro OutlookEmailPostmarkValidationEnabled especifica se o agente do Filtro de Conteúdo envia um quebra-cabeça computacional para o sistema do remetente para processamento. A entrada válida para o parâmetro OutlookEmailPostmarkValidationEnabled é $true ou $false. Quando o parâmetro OutlookEmailPostmarkValidationEnabled é definido como $true, o agente filtro de conteúdo envia um quebra-cabeça computacional para o sistema do remetente para processamento. Os resultados da validação do quebra-cabeça são fatorados no nível geral de confiança de spam (SCL). Essa funcionalidade é exposta ao usuário do Microsoft Outlook como validação de postmark de email do Outlook. A configuração padrão é $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-QuarantineMailbox

O parâmetro QuarantineMailbox especifica um endereço SMTP a ser usado como uma caixa de correio de quarentena de spam. Uma caixa de correio de quarentena de spam é necessária quando você define o parâmetro SCLQuarantineEnabled como $true. Todas as mensagens que atendem ou excedem o valor definido no parâmetro SCLQuarantineThreshold são enviadas para o endereço SMTP definido neste parâmetro.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RejectionResponse

O parâmetro RejectionResponse especifica o corpo da mensagem que você deseja entregar no NDR (relatório de não entrega) para remetentes cujas mensagens atendem ou excedem o valor SCLRejectThreshold. O parâmetro RejectionResponse será necessário se você definir o parâmetro SCLRejectEnabled como $true. O parâmetro RejectionResponse usa uma cadeia de caracteres. Não exceda 240 caracteres no argumento. Ao passar um argumento, você deve incluir o parâmetro RejectionResponse entre aspas (") se a frase contiver espaços, por exemplo: "Mensagem rejeitada". A configuração padrão é a mensagem rejeitada devido a restrições de conteúdo.

Type:AsciiString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLDeleteEnabled

O parâmetro SCLDeleteEnabled especifica se todas as mensagens que atendem ou excedem o valor definido no parâmetro SCLDeleteThreshold são excluídas. 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 atendem ou excedem o valor definido no parâmetro SCLDeleteThreshold são excluídas.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLDeleteThreshold

O parâmetro SCLDeleteThreshold especifica um valor inteiro de 1 a 9. Esse valor representa a classificação SCL que uma determinada mensagem deve atender ou exceder para que o agente do Filtro de Conteúdo exclua a mensagem e não envie uma NDR. Para habilitar essa funcionalidade, você deve definir o parâmetro SCLDeleteEnabled como $true. A configuração padrão é 9.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLQuarantineEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLQuarantineThreshold

O parâmetro SCLQuarantineThreshold especifica um valor inteiro de 1 a 9. Esse valor representa a classificação SCL que uma determinada mensagem deve atender ou exceder para que o agente do Filtro de Conteúdo coloque a mensagem em quarentena. Para habilitar a funcionalidade de quarentena, você deve definir o parâmetro SCLQuarantineEnabled como $true e fornecer um endereço SMTP válido no parâmetro QuarantineMailbox. A configuração padrão é 9.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLRejectEnabled

O parâmetro SCLRejectEnabled especifica se todas as mensagens que atendem ou excedem o valor definido no parâmetro SCLRejectThreshold são rejeitadas e uma NDR é enviada para o remetente. 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 atendem ou excedem o valor definido no parâmetro SCLRejectThreshold são rejeitadas e uma NDR é enviada para o remetente.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLRejectThreshold

O parâmetro SCLRejectThreshold especifica um valor inteiro de 1 a 9. Esse valor representa a classificação SCL que uma determinada mensagem deve atender ou exceder para que o agente filtro de conteúdo rejeite a mensagem e envie um NDR para o remetente. Para habilitar a funcionalidade de exclusão, você deve definir o parâmetro SCLDeleteEnabled como $true. Além disso, você pode revisar a mensagem NDR padrão editando o parâmetro RejectionResponse. A configuração padrão é 7.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.