Set-MalwareFilteringServer
Este cmdlet solo está disponible en el entorno local de Exchange.
Utilice el cmdlet Set-MalwareFilteringServer para configurar los valores del agente de malware en el servicio de transporte o en un servidor de buzones.
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
Set-MalwareFilteringServer
[-Identity] <MalwareFilteringServerIdParameter>
[-BypassFiltering <Boolean>]
[-Confirm]
[-DeferAttempts <Int32>]
[-DeferWaitTime <Int32>]
[-DomainController <Fqdn>]
[-ForceRescan <Boolean>]
[-MinimumSuccessfulEngineScans <Int32>]
[-PrimaryUpdatePath <String>]
[-ScanErrorAction <MalwareScanErrorAction>]
[-ScanTimeout <Int32>]
[-SecondaryUpdatePath <String>]
[-UpdateFrequency <Int32>]
[-UpdateTimeout <Int32>]
[-WhatIf]
[<CommonParameters>] Description
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Set-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10En este ejemplo se establece la siguiente configuración del agente de malware en un servidor de buzones de correo llamado Mailbox01:
- Establece el intervalo de frecuencia de actualización en 2 horas
- Establece el tiempo de espera entre intentos de reenvío en 10 minutos
Parámetros
-BypassFiltering
El parámetro BypassFiltering omite el filtrado de malware temporalmente sin deshabilitar el agente de malware en el servidor. El agente de malware aún seguirá activo, y se le sigue llamando para cada mensaje, pero en realidad no se realiza ningún filtrado de malware. Esto le permite deshabilitar temporalmente y, a continuación, habilitar el filtrado de malware en el servidor sin interrumpir el flujo de correo mediante el reinicio del servicio de transporte de Microsoft Exchange. La entrada válida para este parámetro es $true o $false. El valor predeterminado es $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-DeferAttempts
El parámetro DeferAttempts especifica el número máximo de veces que se aplaza un mensaje que el agente de malware no puede analizar. La entrada válida para este parámetro es un número entero entre 1 y 5. El valor predeterminado es 3.
Una vez alcanzado el número máximo de aplazamientos, la acción que realice el agente de malware dependerá del error. Para errores de motor y tiempos de espera de análisis, la acción es producir un error en el mensaje y devolver un informe de no entrega (NDR) al remitente inmediatamente después del último intento de aplazamiento. Para todos los demás errores, el mensaje se reintenta por un máximo de 48 horas, y cada reintento se realiza con una hora más que el último. Por ejemplo, a partir del último intento de aplazamiento, el primer reintento se llevará acabo en 1 hora, el siguiente reintento se llevará a cabo 2 horas después, el siguiente reintento se llevará a cabo 3 horas después del segundo reintento, y así sucesivamente por 48 horas. Una vez transcurridas las 48 horas, la acción es producir un error en el mensaje y devolver un informe de no entrega (NDR) al remitente.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DeferWaitTime
El parámetro DeferWaitTime especifica el período de tiempo en minutos para aumentar el intervalo de reenvío de mensajes en el filtrado de malware con el fin de reducir la carga de trabajo en el servidor.
Por ejemplo, el primer reintento después del error en la detección original ocurre después del intervalo especificado mediante el parámetro DeferWaitTime. El segundo reintento después del primero ocurre después de dos veces el valor del parámetro DeferWaitTime. El tercer reintento después del segundo reintento se produce después de tres veces el valor del parámetro DeferWaitTime, etc. El parámetro DeferAttempts controla el número máximo de reintentos.
La entrada válida para este parámetro es un número entero entre 0 y 15. El valor predeterminado es 5. Esto significa que la primera reenviación se produce 5 minutos después del examen con error original, el segundo reintento se produce 10 minutos después del primer reintento, el tercer reintento se produce 15 minutos después del segundo reintento, etc. El valor 0 significa que los mensajes se reenviarán para el filtrado de malware después de los intentos de detección erróneos sin ningún retraso.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 2013, Exchange Server 2016, Exchange Server 2019 |
-ForceRescan
El parámetro ForceRescan especifica que el agente de malware debe examinar los mensajes, incluso si el mensaje ya lo ha examinado Exchange Online Protection. La entrada válida para este parámetro es $true o $false. El valor predeterminado es $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
El parámetro Identity especifica el servidor en el que desea configurar los valores de antimalware. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Name
- FQDN
- Distinguished name (DN)
- Nombre distintivo (DN) heredado de Exchange
| Type: | MalwareFilteringServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MinimumSuccessfulEngineScans
Este parámetro está reservado para uso interno de Microsoft.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PrimaryUpdatePath
El parámetro PrimaryUpdatePath especifica dónde descargar actualizaciones del motor de análisis de malware. El valor predeterminado es http://forefrontdl.microsoft.com/server/scanengineupdate. Siempre se intenta primero la ubicación especificada por el parámetro PrimaryUpdatePath.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ScanErrorAction
El parámetro ScanErrorAction especifica la acción a llevar a cabo cuando un mensaje no puede ser analizado por el filtro de malware. Los valores válidos de este parámetro son Block o Allow. El valor predeterminado es Block.
| Type: | MalwareScanErrorAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ScanTimeout
El parámetro ScanTimeout especifica el intervalo de tiempo de espera en segundos para mensajes que no pueden ser analizados por el filtro de malware. La entrada válida para este parámetro es un número entero entre 10 y 900. El valor predeterminado es 300 (5 minutos).
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SecondaryUpdatePath
El parámetro SecondaryUpdatePath especifica una ubicación de descarga alternativa para actualizaciones del motor de análisis de malware. El valor predeterminado es espacio en blanco ($null). Esto significa que no se ha especificado ninguna ubicación de descarga alternativa.
La ubicación de descarga alternativa se utiliza cuando la ubicación especificada por el parámetro PrimaryUpdatePath no está disponible durante el periodo de tiempo especificado por el parámetro UpdateTimeout. En la próxima actualización del motor de análisis de malware, se intentará primero la ubicación especificada por el parámetro de ruta PrimaryUpdate.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UpdateFrequency
El parámetro UpdateFrequency especifica el intervalo de frecuencia en minutos para buscar las actualizaciones del motor de análisis de malware. La entrada válida para este parámetro es un número entero entre 1 y 38880 (27 días). El valor predeterminado es 60 (una hora). Las ubicaciones para buscar actualizaciones se especifican mediante los parámetros PrimaryUpdatePath y SecondaryUpdatePath.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UpdateTimeout
El parámetro UpdateTimeout especifica el intervalo de tiempo de espera en segundos para buscar las actualizaciones del motor de análisis de malware. La entrada válida para este parámetro es un número entero entre 60 y 300. El valor predeterminado es 150 segundos (2,5 minutos).
Si la ubicación especificada por el parámetro PrimaryUpdatePath no está disponible durante el periodo de tiempo especificado por el parámetro UpdateTimeout, se utilizará la ubicación especificada por el parámetro SecondaryUpdatePath.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 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.