Remove-AttachmentFilterEntry

 

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 Remove-AttachmentFilterEntry para remover uma entrada da lista de filtros de anexo que esteja configurada em um computador em que a função de servidor Transporte de Borda esteja instalada.

Sintaxe

remove-attachmentfilterentry -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

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. Você pode usar o cmdlet Remove-AttachmentFilterEntry para remover uma entrada da lista de filtros de anexo que está configurada em um computador em que a função de servidor Transporte de Borda ou de Transporte de Hub está instalada.

Para executar o cmdlet Remove-AttachmentFilterEntry 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
Identity	Necessário	System.String	Este parâmetro especifica qual tipo de anexo essa entrada de filtro remove. O parâmetro Identity aceita valores no formato Type:Name, em que Type é um dos seguintes valores: ContentType   Esse valor faz a correspondência entre essa entrada de filtro de anexos e o tipo de conteúdo MIME. FileName   Esse valor faz a correspondência entre essa entrada do filtro de anexos e o nome do arquivo simples. Em Type:Name, Name pode ser o nome do arquivo da entrada de filtro de anexos a ser removido ou o tipo de conteúdo da entrada de filtro de anexos a ser removido.
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.
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

Você pode remover entradas da lista de filtros de anexo que não sejam mais necessárias. Os exemplos de código a seguir mostram como remover uma entrada da lista de filtros de anexo.

O primeiro exemplo de código remove a entrada de filtro de anexos que filtra nomes de arquivos com uma extensão .txt.

O segundo exemplo de código remove a entrada de filtro de anexos que filtra anexos com o tipo de conteúdo MIME image/jpeg.

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