Get-SafeLinksAggregateReport

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Online

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

Use el cmdlet Get-SafeLinksAggregateReport para devolver información general sobre los resultados de Vínculos seguros de los últimos 90 días. Ayer es la fecha más reciente que puede especificar.

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-SafeLinksAggregateReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-StartDate <System.DateTime>]
   [-SummarizeBy <String>]
   [<CommonParameters>]

Description

Nota: Si ejecuta Get-SafeLinksAggregateReport sin especificar un intervalo de fechas, el comando devolverá un error no especificado.

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.

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

  • Acción
  • Aplicación
  • MessageCount
  • RecipientCount

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-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"

En este ejemplo se devuelven los resultados resumidos por Email cliente y los resultados de Teams para el intervalo de fechas especificado.

Parámetros

-Action

El parámetro Action filtra los resultados por acción. Los valores admitidos son:

  • Permitido
  • Blocked
  • ClickedDuringScan
  • ClickedEvenBlocked
  • Análisis
  • TenantAllowed
  • TenantBlocked
  • TenantBlockedAndClickedThrough

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

-AppNameList

El parámetro AppNameList filtra los resultados por la aplicación donde se encontró el vínculo. Los valores admitidos son:

  • cliente de Email
  • OfficeDocs
  • Teams

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

-EndDate

El parámetro EndDate especifica la fecha de finalización del intervalo de fechas.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018.

Ayer es la fecha más reciente que puede especificar. No se puede especificar una fecha que tenga más de 90 días.

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

-StartDate

El parámetro StartDate especifica la fecha de inicio del intervalo de fechas.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018.

Ayer es la fecha más reciente que puede especificar. No se puede especificar una fecha que tenga más de 90 días.

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

-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 disminuye la cantidad de datos que recuperan para el informe y lo entrega más rápidamente. Por ejemplo, en lugar de ver cada instancia de un valor específico de Action o AppNameList en una fila individual del informe, puede usar el parámetro SummarizeBy para ver el número total de instancias de esa acción o aplicación específica en una fila del informe.

Para este cmdlet, los valores válidos son:

  • Acción: solo se devuelven los valores especificados por el parámetro Action.
  • Aplicación: solo se devuelven los valores especificados por el parámetro AppNameList.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online