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:
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