Get-AttachmentFilterEntry

Artigo
09/30/2014

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

Tópico modificado em: 2007-06-28

O cmdlet Get-AttachmentFilterEntry permite que um administrador de email exiba a lista de entradas de filtro de anexos configuradas em um computador em que a função de servidor Transporte de Borda esteja instalada.

Sintaxe

get-attachmentfilterentry [-Identity <String>] [-DomainController <Fqdn>]

Descrição detalhada

O agente de 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 executar o cmdlet Get-AttachmentFilterEntry em um computador com a função de servidor Transporte de Borda 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

Parâmetro	Necessário	Tipo	Descrição
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.
Identity	Opcional	System.String	Esse parâmetro especifica a entrada de filtro de anexos que o comando recupera. O parâmetro Identity aceita valores no formato `Type:Name`, em que `Type` é um dos dois valores a seguir: ContentType Esse valor corresponderá a entrada de filtro de anexos e o tipo de conteúdo MIME. FileName Esse valor corresponderá a entrada de filtro de anexos e o nome de arquivo simples.

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.

Identity

Opcional

System.String

Esse parâmetro especifica a entrada de filtro de anexos que o comando recupera. O parâmetro Identity aceita valores no formato Type:Name, em que Type é um dos dois valores a seguir:

ContentType Esse valor corresponderá a entrada de filtro de anexos e o tipo de conteúdo MIME.
FileName Esse valor corresponderá a entrada de filtro de anexos e o nome de arquivo simples.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

Os exemplos de código a seguir mostram como recuperar informações sobre entradas de filtro de anexos.

O primeiro exemplo de código retorna todas as entradas de filtro de anexos.

O segundo retorna apenas as entradas de filtro de anexos que filtram nomes de arquivo com extensão .txt.

O terceiro retorna apenas as entradas de filtro de anexos que filtram anexos que têm o tipo de conteúdo MIME image/jpeg.

Get-AttachmentFilterEntry
Get-AttachmentFilterEntry -Identity filename:*.txt
Get-AttachmentFilterEntry -Identity contenttype:image/jpeg

Compartilhar via