Add-AttachmentFilterEntry

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet solo está disponible o es efectivo en los servidores de transporte perimetral de Exchange local.

Use el cmdlet Add-AttachmentFilterEntry para agregar una entrada a la lista de filtros de datos adjuntos que el agente de filtrado de datos adjuntos usa en los servidores de transporte perimetral.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Add-AttachmentFilterEntry
   -Name <String>
   -Type <AttachmentType>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Description

En los servidores de transporte perimetral, el agente de filtrado de datos adjuntos bloquea los datos adjuntos de los mensajes en función del tipo de contenido y del nombre de archivo de los datos adjuntos. La configuración del agente de filtrado de datos adjuntos determina la forma en la que se procesan los mensajes que contienen esos datos adjuntos. Para obtener más información sobre cómo configurar el agente de filtro de datos adjuntos, vea Set-AttachmentFilterListConfig.

En los servidores de transporte perimetral, deberá ser miembro del grupo de administradores locales para ejecutar este cmdlet.

Ejemplos

Ejemplo 1

Add-AttachmentFilterEntry -Name *.txt -Type FileName

En este ejemplo se agrega una entrada de filtro de datos adjuntos basada en un nombre de archivo. Después de ejecutar este comando, el agente de filtrado de datos adjuntos filtra todos los datos adjuntos que tienen la extensión .txt.

Ejemplo 2

Add-AttachmentFilterEntry -Name image/jpeg -Type ContentType

En este ejemplo se 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. Después de ejecutar este comando, el agente de filtrado de datos adjuntos filtra todos los datos adjuntos que tienen el tipo de contenido MIME image/jpeg.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

El parámetro DomainController no es compatible con los servidores de transporte perimetral. Un servidor de transporte perimetral usa la instancia local de Active Directory Lightweight Directory Services (AD LDS) para leer y escribir datos.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

El parámetro Name especifica los archivos que desea bloquear. Los valores admitidos son:

  • Nombre de archivo exacto (por ejemplo, BadFile.exe) o extensión de nombre de archivo (por ejemplo, *.exe). Debe usar el valor Filename para el parámetro Type.
  • Un tipo de contenido MIME válido (por ejemplo, application/javascript o text/scriplet). Debe usar el valor ContentType para el parámetro Type.
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Type

El parámetro Type especifica qué tipo de datos adjuntos bloquea la entrada del filtro de datos adjuntos. Los valores admitidos son:

  • ContentType: este valor coincide con la entrada de filtro de datos adjuntos con el tipo de contenido MIME especificado en el parámetro Name.
  • FileName: este valor coincide con la entrada de filtro de datos adjuntos con el nombre de archivo simple especificado en el parámetro Name.
Type:AttachmentType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.