Set-AttachmentFilterListConfig

 

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-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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionConnectors <MultiValuedProperty>] [-Instance <AttachmentFilteringConfig>] [-RejectResponse <String>] [-WhatIf [<SwitchParameter>]]

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
Action	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.
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.
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.
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á 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

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