Share via


Set-SenderFilterConfig

 

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

Tópico modificado em: 2007-06-28

Use o cmdlet Set-SenderFilterConfig para modificar a configuração do Filtro por Remetente em um computador em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada.

Sintaxe

Set-SenderFilterConfig [-Action <StampStatus | Reject>] [-BlankSenderBlockingEnabled <$true | $false>] [-BlockedDomains <MultiValuedProperty>] [-BlockedDomainsAndSubdomains <MultiValuedProperty>] [-BlockedSenders <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <SenderFilterConfig>] [-InternalMailEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Set-SenderFilterConfig, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para executar o cmdlet Set-SenderFilterConfig 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 no 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

Action

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.BlockedSenderAction

Este parâmetro especifica a ação que o agente do Filtro por Remetente realiza na mensagem quando um remetente ou domínio bloqueado é encontrado. O parâmetro Action adota os seguintes valores: StampStatus ou Reject. O valor padrão é Reject.

BlankSenderBlockingEnabled

Optional

System.Boolean

A entrada válida para o parâmetro BlankSenderBlockingEnabled é $true ou $false. A configuração padrão é $false. Quando o parâmetro BlankSenderBlockingEnabled é definido como $true, todas as mensagens que não contêm um remetente na instrução SMTP MAIL FROM: serão bloqueadas.

BlockedDomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

A entrada válida para o parâmetro BlockedDomains é um ou mais nomes de domínio. Quando o agente do Filtro por Remetente encontra uma mensagem que foi enviada por um domínio dessa lista, o agente do Filtro por Remetente realiza a ação especificada no parâmetro Action. Caracteres curinga, como '*', são permitidos. O número máximo de entradas para este parâmetro é 800.

BlockedDomainsAndSubdomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

A entrada válida para o parâmetro BlockedDomainsAndSubdomains é um ou mais nomes de domínio. Quando o agente do Filtro por Remetente encontra uma mensagem que foi enviada por um domínio ou subdomínio dessa lista, o agente do Filtro por Remetente realiza a ação especificada no parâmetro Action. Caracteres curinga, como '*', são permitidos. O número máximo de entradas para este parâmetro é 800.

BlockedSenders

Optional

Microsoft.Exchange.Data.MultiValuedProperty

A entrada válida para o parâmetro BlockedSenders é um ou mais endereços SMTP. Quando o agente do Filtro por Remetente encontra uma mensagem que foi enviada por um remetente dessa lista, o agente do Filtro por Remetente realiza a ação especificada no parâmetro Action. O número máximo de entradas para este parâmetro é 800.

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

Optional

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

Optional

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 é definido como $true, o agente do Filtro por Remetente é habilitado no computador em que o comando Set‑SenderFilterConfig está sendo executado.

ExternalMailEnabled

Optional

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 por Remetente para serem processadas.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SenderFilterConfig

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

Optional

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 domínios de remetentes autenticados que pertençam a domínios autorizados em sua empresa são passados para o agente do Filtro por Remetente para serem processadas.

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 Set‑SenderFilterConfig que tem as seguintes modificações na configuração do Filtro por Remetente:

  • Ele permite bloquear remetentes em branco.

  • Ele bloqueia o domínio e o subdomínio de example.com

  • Ele define dois remetentes bloqueados.

Set-SenderFilterConfig -BlankSenderBlockingEnabled:$true -BlockedDomainsAndSubdomains *example.com -BlockedSenders user1@contoso.com, user2@contoso.com