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: 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: |
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: 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 é |
ExternalMailEnabled |
Opcional |
System.Boolean |
A entrada válida para o parâmetro ExternalMailEnabled é |
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 é |
OutlookEmailPostmarkValidationEnabled |
Opcional |
System.Boolean |
A entrada válida para o parâmetro OutlookEmailPostmarkValidationEnabled é |
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 |
RejectionResponse |
Opcional |
Microsoft.Exchange.Data.AsciiString |
Esse parâmetro será necessário se você definir o parâmetro SCLRejectEnabled como |
SCLDeleteEnabled |
Opcional |
System.Boolean |
A entrada válida para o parâmetro SCLDeleteEnabled é |
SCLDeleteThreshold |
Opcional |
System.Int32 |
Esse parâmetro aceita um valor inteiro entre |
SCLQuarantineEnabled |
Opcional |
System.Boolean |
A entrada válida para o parâmetro SCLQuarantineEnabled é |
SCLQuarantineThreshold |
Opcional |
System.Int32 |
Esse parâmetro aceita um valor inteiro entre |
SCLRejectEnabled |
Opcional |
System.Boolean |
A entrada válida para o parâmetro SCLRejectEnabled é |
SCLRejectThreshold |
Opcional |
System.Int32 |
Esse parâmetro aceita um valor inteiro entre |
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