Add-AttachmentFilterEntry

Artigo
09/30/2014

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

Tópico modificado em: 2009-04-28

Use o cmdlet Add-AttachmentFilterEntry para adicionar uma entrada à lista de filtros de anexo em um computador em que a função de servidor Transporte de Borda esteja instalada.

Sintaxe

add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O agente do Filtro de Anexo pode impedir que anexos entrem na organização do Microsoft Exchange Server 2007 com base no tipo de conteúdo e no nome de arquivo do anexo. A configuração do agente de Filtragem de Anexo determina como os anexos são processados.

Para obter mais informações sobre como configurar o agente de Filtragem de Anexo, consulte Set-AttachmentFilterListConfig.

O cmdlet Add-AttachmentFilterEntry pode filtrar anexos de email com base nos tipos de conteúdo MIME e no nome do arquivo. A lista a seguir descreve cada tipo de anexo:

Tipos de conteúdo MIME Os tipos de conteúdo MIME indicam qual é o tipo de anexo, por exemplo, se é uma imagem JPEG, um arquivo executável, um arquivo do Microsoft Office Excel 2003 ou outro tipo de arquivo. Os anexos de email são codificados em mensagens de email como texto ASCII. Os servidores e clientes de email usam as informações sobre o tipo de conteúdo MIME para decodificar as informações do texto ASCII em um email e as converter em um arquivo binário utilizável que seja familiar para o usuário. Os tipos de conteúdo são expressos como type/subtype. Por exemplo, o tipo de conteúdo de imagem JPEG é expresso como image/jpeg.

Para obter mais informações sobre os tipos de conteúdo MIME, consulte a RFC Request for Comments (RFC) 1341.

Dica

UNRESOLVED_TOKEN_VAL(exNote3rdPartyURL)
Nomes de arquivo Há duas formas de especificar nomes de arquivo de anexo na lista de filtro de anexo. Você pode especificar um nome de arquivo exato, como arquivo.exe. Como alternativa, você pode especificar qualquer arquivo que tenha um tipo específico de extensão substituindo o nome do arquivo à esquerda do ponto por um caractere curinga. Um exemplo do uso de um caractere curinga em um nome de arquivo é *.exe.

Para executar o cmdlet Add-AttachmentFilterEntry 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 Exchange 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Name	Necessário	System.String	Esse parâmetro especifica o tipo de conteúdo MIME ou nome de arquivo do anexo. Se Type for `FileName`, o parâmetro Name poderá assumir qualquer nome de arquivo exato, como `BadFile.Exe`, ou extensão de nome de arquivo, como `.exe`. Se o Type* for `ContentType`, o parâmetro Name poderá assumir qualquer tipo de conteúdo MIME válido.
Type	Necessário	Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType	Esse parâmetro especifica que tipo de anexo a entrada de filtro de anexo bloqueia. Os valores válidos são `ContentType` e `Filename`. ContentType Este valor faz a correspondência entre a entrada de filtro de anexo e o tipo de conteúdo MIME especificado no parâmetro AttachmentName. FileName Este valor faz a correspondência entre a entrada de filtro de anexo e o nome simples de arquivo especificado no parâmetro AttachmentName.
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	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.
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

Você pode desejar adicionar entradas à lista de filtros de anexo para ajudar a proteger os usuários contra anexos de email mal-intencionados ou não apropriados. Os exemplos de código a seguir mostram como adicionar uma entrada a uma lista de filtro de anexo.

O primeiro exemplo de código adiciona uma entrada de filtro de anexo com base em um nome de arquivo. Esse filtro de anexo será aplicado a todos os anexos que tenham uma extensão .txt.

O segundo exemplo de código adiciona uma entrada de filtro de anexo com base no tipo de conteúdo MIME image/jpeg, que é um arquivo binário de imagem JPEG. Esse filtro de anexo será aplicado a todos os anexos do tipo de conteúdo MIME image/jpeg.

add-attachmentfilterentry -name *.txt -type FileName
add-attachmentfilterentry -name image/jpeg -type ContentType

Compartilhar via