Compartir a través de


Get-MailTrafficATPReport

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Get-MailTrafficATPReport para ver los resultados de las detecciones de Exchange Online Protection y Microsoft Defender para Office 365 en la organización basada en la nube durante los últimos 90 días.

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

Get-MailTrafficATPReport
   [-Action <MultiValuedProperty>]
   [-AggregateBy <String>]
   [-Direction <MultiValuedProperty>]
   [-Domain <MultiValuedProperty>]
   [-EndDate <DateTime>]
   [-EventType <MultiValuedProperty>]
   [-NumberOfRows <Int32>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-PivotBy <MultiValuedProperty>]
   [-ProbeTag <String>]
   [-StartDate <DateTime>]
   [-SummarizeBy <MultiValuedProperty>]
   [<CommonParameters>]

Description

Datos adjuntos seguros es una característica de Microsoft Defender para Office 365 que abre datos adjuntos de correo electrónico en un entorno especial de hipervisor para detectar actividades malintencionadas.

Vínculos seguros es una característica de Microsoft Defender para Office 365 que comprueba los vínculos en los mensajes de correo electrónico para ver si conducen a sitios web malintencionados. Cuando un usuario hace clic en un vínculo de un mensaje, la dirección URL se reescribe temporalmente y se compara con una lista de sitios web malintencionados conocidos. Vínculos seguros incluye una característica de seguimiento de URL para determinar quién ha llegado a un sitio web malintencionado.

Para el período de informes especificado, el cmdlet devuelve la siguiente información:

  • Fecha
  • Tipo de evento
  • Dirección
  • Origen del veredicto
  • Número de mensajes

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

Get-MailTrafficATPReport

En este ejemplo se recuperan los detalles de los mensajes de los últimos 92 días.

Ejemplo 2

Get-MailTrafficATPReport -StartDate (Get-Date "12/25/2021 12:01 AM").ToUniversalTime() -EndDate (Get-Date "12/25/2021 11:59 PM").ToUniversalTime() -Direction Outbound

En este ejemplo se recuperan las estadísticas de los mensajes salientes el 25 de diciembre de 2021 y se muestran los resultados en una tabla.

Parámetros

-Action

El parámetro Action filtra el informe por la acción realizada en los mensajes. Para ver la lista completa de valores válidos para este parámetro, ejecute el comando : Get-MailFilterListReport -SelectionTarget Actions. La acción que especifique debe corresponderse con el tipo de informe. Por ejemplo, sólo puede especificar acciones de filtrado de malware para los informes de malware.

El parámetro Action filtra el informe por la acción realizada por las directivas de DLP, reglas de transporte, filtro de malware o filtro de correo no deseado. Para ver una lista completa de los valores válidos para este parámetro, ejecute el comando Get-MailFilterListReport -SelectionTarget Actions. La acción que especifique debe corresponderse con el tipo de informe. Por ejemplo, sólo puede especificar acciones de filtrado de malware para los informes de malware.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AggregateBy

El parámetro AggregateBy especifica el periodo del informe. Sus valores válidos son: Hour, Day o Summary. El valor predeterminado es Day.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Direction

El parámetro Direction filtra los resultados por mensajes entrantes o salientes. Los valores admitidos son:

  • Entrada
  • Salida
  • IntraOrg

Puede especificar distintos valores separados por comas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Domain

El parámetro Domain filtra los resultados por dominio aceptado en la organización basada en la nube. Puede especificar varios valores de dominio separados por comas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndDate

El parámetro EndDate especifica el final del intervalo de fechas en hora universal coordinada (UTC).

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.

Si usa el parámetro EndDate, también debe usar el parámetro StartDate.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EventType

El parámetro EventType filtra el informe por el tipo de evento. Los valores admitidos son:

  • Filtro avanzado
  • Motor antimalware
  • Campaña
  • Detonación de archivos
  • Reputación de detonación de archivos
  • Reputación de los archivos
  • Coincidencia de huella digital
  • Filtro general
  • Suplantación de marca
  • Dominio de suplantación
  • Suplantación de usuarios
  • Suplantación de inteligencia de buzón
  • Mensaje pasado
  • Detección de análisis mixto
  • Suplantación electrónica DMARC
  • Suplantación de seguridad de dominio externo
  • Suplantación de seguridad para la organización
  • Detonación de URL
  • Reputación de detonación de URL
  • Reputación malintencionada de URL

Nota: Algunos valores corresponden a características que solo están disponibles en Defender para Office 365 (solo plan 1 y plan 2 o plan 2).

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-NumberOfRows

El parámetro NumberOfRows especifica el número de filas que se devolverán en el informe. El valor máximo es 10000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Page

El parámetro Page especifica el número de páginas de resultados que desea ver. La entrada válida para este parámetro es un número entero entre 1 y 1000. El valor predeterminado es 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PageSize

El parámetro PageSize especifica el número máximo de entradas por página. La entrada válida para este parámetro es un número entero entre 1 y 5000. El valor predeterminado es 1000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PivotBy

{{ Fill PivotBy Description }}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ProbeTag

Este parámetro está reservado para uso interno de Microsoft.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-StartDate

El parámetro StartDate especifica el inicio del intervalo de fechas en hora universal coordinada (UTC).

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.

Si usa el parámetro StartDate, también debe usar el parámetro EndDate.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SummarizeBy

El parámetro SummarizeBy devuelve totales basados en los valores especificados. Si su informe filtra datos mediante el uso de cualquiera de los valores aceptados por este parámetro, puede usar el parámetro SummarizeBy para resumir los resultados según dichos valores. Para reducir la cantidad de filas que devuelve el informe, considere usar el parámetro SummarizeBy. Resumir reduce la cantidad de datos que se recuperan para el informe y entrega el informe más rápido. Por ejemplo, en vez de ver cada instancia de un valor específico de EventType en una fila independiente en el informe, puede usar el parámetro SummarizeBy para ver la cantidad total de instancias de ese valor de EventType en una fila en el informe.

Para este cmdlet, los valores válidos son:

  • Acción
  • Dirección
  • Dominio
  • EventType

Puede especificar distintos valores separados por comas. Cuando se especifican los valores Action o Domain, el valor no se muestra en los resultados (los valores de las columnas correspondientes están en blanco).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection