Add-AttachmentFilterEntry (RTM)

Artículo
06/26/2014

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-17

Utilice el cmdlet Add-AttachmentFilterEntry para agregar una entrada a la lista de filtros de datos adjuntos en un equipo que tenga instalada la función del servidor Transporte perimetral.

Sintaxis

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

Descripción detallada

El agente de filtro de documentos adjuntos puede bloquear adjuntos y evitar que entren en la organización Microsoft Exchange Server 2007 según el tipo de contenido y el nombre de los datos adjuntos. La configuración del agente de filtro de documentos adjuntos determina la forma en la que se procesan los documentos adjuntos.

Para obtener más información acerca de cómo configurar el agente de filtro de datos adjuntos, vea Set-AttachmentFilterListConfig (RTM) (en inglés).

El cmdlet Add-AttachmentFilterEntry puede filtrar datos adjuntos de correo electrónico de acuerdo con los tipos de contenido MIME y el nombre de archivo. En la siguiente lista se describen cada tipo de datos adjuntos:

Tipos de contenido MIME Los tipos de MIME indican qué son los datos adjuntos, por ejemplo, una imagen JPEG, un archivo ejecutable, un archivo de Microsoft Office Excel 2003 u otro tipo de archivo. Los datos adjuntos de correo electrónico están codificados como texto ASCII. Los servidores y clientes de correo electrónico emplean la información acerca del tipo de contenido MIME para descifrar la información de texto ASCII en un mensaje de correo electrónico y convertirlo en un archivo binario útil que al usuario le resulte familiar. Los tipos de contenido se expresan como type/subtype. Por ejemplo, el tipo de contenido de imagen JPEG se expresa como image/jpeg.

Para obtener más información acerca de los tipos de contenido MIME, vea Solicitud de comentarios (RFC) 1341.
Nombres de archivo Hay dos formas de especificar los nombres de archivo de los datos adjuntos en las listas de filtro de datos adjuntos. Se puede especificar un nombre de archivo exacto, como por ejemplo NombreArchivoMalo.exe; o especificar cualquier archivo que tenga una extensión determinada sustituyendo el nombre a la izquierda del punto por un carácter comodín. Un ejemplo de uso de carácter comodín en un nombre de archivo es *.exe.

Para ejecutar el cmdlet Add-AttachmentFilterEntry en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores de dicho equipo.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Parámetro	Necesario	Tipo	Descripción
Name	Necesario	System.String	Este parámetro especifica el tipo de contenido MIME o el nombre de archivo de los datos adjuntos. Si Type es `FileName`, el parámetro Name admite cualquier nombre exacto de archivo, como por ejemplo `BadFile.Exe`, o la extensión de nombre de archivo, como por ejemplo `.exe`. Si Type* es `ContentType`, el parámetroName admite cualquier tipo de contenido MIME válido.
Tipo	Necesario	Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType	Este parámetro especifica qué tipo de datos adjuntos bloquea la entrada del filtro de datos adjuntos. Los valores válidos son `ContentType` y `Filename`. ContentType Este valor empareja la entrada del filtro de datos adjuntos con el tipo de contenido MIME especificado en el parámetro AttachmentName. FileName Este valor empareja la entrada del filtro de datos adjuntos con nombre simple de archivo especificado en el parámetro AttachmentName.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que tienen instalada la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo escribe en la instancia de ADAM local.

Name

Necesario

System.String

Este parámetro especifica el tipo de contenido MIME o el nombre de archivo de los datos adjuntos. Si Type es FileName, el parámetro Name admite cualquier nombre exacto de archivo, como por ejemplo BadFile.Exe, o la extensión de nombre de archivo, como por ejemplo *.exe. Si Type es ContentType, el parámetroName admite cualquier tipo de contenido MIME válido.

Tipo

Necesario

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType

Este parámetro especifica qué tipo de datos adjuntos bloquea la entrada del filtro de datos adjuntos. Los valores válidos son ContentType y Filename.

ContentType Este valor empareja la entrada del filtro de datos adjuntos con el tipo de contenido MIME especificado en el parámetro AttachmentName.
FileName Este valor empareja la entrada del filtro de datos adjuntos con nombre simple de archivo especificado en el parámetro AttachmentName.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que tienen instalada la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo escribe en la instancia de ADAM local.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

Es recomendable agregar entradas a la lista de filtros de datos adjuntos para proteger a los usuarios contra correos electrónicos malintencionados o inapropiados. Los siguientes ejemplos de código muestran cómo agregar una entrada a una lista de filtro de datos adjuntos.

El primer ejemplo de código agrega una entrada de filtro de datos adjuntos de acuerdo al nombre de archivo. Este filtro de datos adjuntos se aplicará a todos los datos adjuntos que tengan una extensión .txt.

El segundo ejemplo de código agrega una entrada de filtro de datos adjuntos basada en el tipo de contenido MIME image/jpeg, que es un archivo binario de imagen JPEG. Este filtro de datos adjuntos se aplicará a todos los datos adjuntos del tipo de contenido MIME image/jpeg.

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

Share via