Share via


Set-AttachmentFilterListConfig (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-06

Use o cmdlet Set-AttachmentFilterListConfig para modificar a configuração do agente de Filtro de Anexo no computador que está executando o Microsoft Exchange Server 2007 e no qual a função de servidor Transporte de Borda esteja instalada.

Sintaxe

set-attachmentfilterlistconfig [-Action <Reject | Strip | SilentDelete>] [-AdminMessage <String>] [-DomainController <Fqdn>] [-ExceptionConnectors <MultiValuedProperty>] [-Instance <AttachmentFilteringConfig>] [-RejectResponse <String>]

Descrição detalhada

O agente de Filtro de Anexo pode impedir que anexos entrem na organização do Exchange 2007 com base no tipo de conteúdo e no nome de arquivo do anexo. Você pode usar o cmdlet Set-AttachmentFilterListConfig para modificar as informações de configuração do agente de Filtro de Anexo e gerenciar como os anexos são processados. As mesmas opções de configuração são aplicadas a todas as entradas de uma lista de filtros de anexo configurada no computador local em que a função de servidor Transporte de Borda está instalada. Você deve configurar separadamente cada computador em que a função de servidor Transporte de Borda está instalada.

Para executar o cmdlet Set-AttachmentFilterListConfig em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve fazer logon usando 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 Exchange 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário Tipo Descrição

Ação

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.FilterActions

Este parâmetro especifica como o agente de Filtro de Anexo lida com um anexo que corresponda a uma entrada da lista de filtros de anexo. O valor padrão é Block. Os valores válidos incluem o seguinte:

  • Reject   Este valor impede que mensagens e anexos de email sejam entregues ao destinatário e emite uma notificação de falha na entrega ao remetente.

  • Strip   Este valor remove o anexo ofensivo da mensagem de email e permite que a mensagem e outros anexos que não correspondam a uma entrada da lista de filtros de anexo sejam transmitidos. Uma notificação de que o anexo foi removido é adicionada à mensagem de email.

  • SilentDelete   Este valor impede que as mensagens e os anexos de email sejam entregues ao destinatário. Nenhuma notificação de que a mensagem e o anexo de email foram bloqueados é enviada ao remetente.

AdminMessage

Opcional

System.String

 Esse parâmetro especifica o conteúdo de um arquivo de texto que substitui os anexos que foram removidos pelo agente de Filtragem de Anexo. O parâmetro AdminMessage aparece apenas quando o agente de Filtragem de Anexo está configurado para remover um anexo que foi identificado como inválido.

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.

ExceptionConnectors

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parâmetro especifica uma lista de conectores que devem ser excluídos da filtragem de anexo. Os filtros de anexo não são aplicados às mensagens de email recebidas por esses conectores. Você deve usar a GUID do conector para especificar o valor ExceptionConnectors.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentFilteringConfig

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.

RejectResponse

Opcional

System.String

Este parâmetro será requerido apenas se você definir o parâmetro Action como Reject. O parâmetro RejectResponse aceita uma cadeia de caracteres. Insira o corpo da mensagem a ser entregue na notificação de falha na entrega para os remetentes cujas mensagens contêm um anexo que está bloqueado. Não exceda 240 caracteres no argumento. Ao passar um argumento, você deve incluir o parâmetro RejectResponse entre aspas duplas, se a frase contiver espaços, como mostra o exemplo: "Message rejected". A configuração padrão é Message rejected due to unacceptable attachments.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

Por padrão, o agente de Filtro de Anexo está configurado para bloquear anexos que correspondam a uma entrada da lista de filtros de anexo e suas mensagens. O exemplo de código a seguir modifica a ação que o agente de Filtro de Anexo executa em um anexo que corresponda a uma entrada da lista de filtros de anexo de modo que a mensagem e o anexo de email não sejam entregues ao destinatário e uma notificação de falha na entrega seja enviada ao remetente. O exemplo de código especifica também um conector que não executará o agente de Filtro de Anexo.

Set-AttachmentFilterListConfig -Action Reject -ExceptionConnectors fc4d8ce2-2c0d-4116-b036-143b19a81384