Get-SafeLinksDetailReport
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet Get-SafeLinksDetailReport para devolver información detallada sobre los resultados de Vínculos seguros de los últimos 7 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-SafeLinksDetailReport
[-Action <MultiValuedProperty>]
[-AppNameList <MultiValuedProperty>]
[-Domain <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-Page <Int32>]
[-PageSize <Int32>]
[-RecipientAddress <MultiValuedProperty>]
[-StartDate <System.DateTime>]
[<CommonParameters>]
Description
Nota: Si ejecuta Get-SafeLinksDetailReport 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.
Este cmdlet devuelve la siguiente información:
- ClickTime
- NetworkMessageId
- ClientMessageId
- SenderAddress
- RecipientAddress
- Url
- UrlDomain
- Acción
- AppName
- SourceId
- Organización
- DetectedBy (vínculos seguros en Microsoft Defender para Office 365)
- UrlType (actualmente vacío)
- Marcas (0: Permitido 1: Bloqueado 2: ClickedEvenBlocked 3: ClickedDuringScan)
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-SafeLinksDetailReport -StartDate 06-07-2020 -EndDate 06-10-2020 -Action Allowed,Blocked -AppNameList "Email Client","Teams" -Domain google.com,teams.com -RecipientAddress faith@contoso.com,chris@contoso.com
Este ejemplo devuelve filtros de los resultados mediante la siguiente información:
- Intervalo de fechas: del 7 de junio de 2020 al 10 de junio de 2020
- Acción: permitido y bloqueado
- AppNameList: Email Cliente y Teams
- Dominio url: google.com y teams.com
- Dirección de correo electrónico del destinatario: faith@contoso.com y chris@contoso.com
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.
Tenga en cuenta que los valores de este parámetro distinguen mayúsculas de minúsculas.
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 |
-Domain
El parámetro Domain filtra los resultados por el dominio en la dirección URL.
Puede especificar distintos valores separados por comas.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 7 días.
Type: | System.DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 |
-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 |
-RecipientAddress
El parámetro RecipientAddress filtra los resultados por la dirección de correo electrónico del destinatario.
Puede especificar distintos valores separados por comas.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 7 días.
Type: | System.DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |