Get-SafeLinksDetailReport
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet Get-SafeLinksDetailReport per restituire informazioni dettagliate sui risultati dei collegamenti sicuri negli ultimi 7 giorni. Ieri è la data più recente che è possibile specificare.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-SafeLinksDetailReport
[-Action <MultiValuedProperty>]
[-AppNameList <MultiValuedProperty>]
[-Domain <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-Page <Int32>]
[-PageSize <Int32>]
[-RecipientAddress <MultiValuedProperty>]
[-StartDate <System.DateTime>]
[<CommonParameters>] Descrizione
Nota: se si esegue Get-SafeLinksDetailReport senza specificare un intervallo di date, il comando restituirà un errore non specificato.
Collegamenti sicuri è una funzionalità di Microsoft Defender per Office 365 che controlla i collegamenti nei messaggi di posta elettronica per verificare se portano a siti Web dannosi. Quando un utente seleziona un collegamento all'interno di un messaggio, l'URL viene temporaneamente riscritto e confrontato con un elenco di siti Web dannosi noti.
Questo cmdlet restituisce le informazioni seguenti:
- ClickTime
- NetworkMessageId
- ClientMessageId
- SenderAddress
- RecipientAddress
- Url
- UrlDomain
- Azione
- Appname
- SourceId
- Organizzazione
- DetectedBy (collegamenti sicuri in Microsoft Defender per Office 365)
- UrlType (attualmente vuoto)
- Flag (0: Consentito 1: Bloccato 2: ClickedEvenBlocked 3: ClickedDuringScan)
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 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.comQuesto esempio restituisce i filtri dei risultati in base alle informazioni seguenti:
- Intervallo di date: dal 7 giugno 2020 al 10 giugno 2020
- Azione: Consentita e bloccata
- AppNameList: client Email e Teams
- Dominio URL: google.com e teams.com
- Indirizzo di posta elettronica del destinatario: faith@contoso.com e chris@contoso.com
Parametri
-Action
Il parametro Action filtra i risultati in base all'azione. I valori validi sono:
- Consentito
- Bloccato
- ClickedDuringScan
- ClickedEvenBlocked
- Analisi
- TenantAllowed
- TenantBlocked
- TenantBlockedAndClickedThrough
È possibile specificare più valori separati da virgole.
Si noti che i valori per questo parametro fanno distinzione tra maiuscole e minuscole.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppNameList
Il parametro AppNameList filtra i risultati in base all'app in cui è stato trovato il collegamento. I valori validi sono:
- client Email
- OfficeDocs
- Teams
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "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
Il parametro Domain filtra i risultati in base al dominio nell'URL.
È possibile specificare più valori separati da virgole.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EndDate
Il parametro EndDate consente di specificare la data di fine dell'intervallo di date.
Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018.
Ieri è la data più recente che è possibile specificare. Non è possibile specificare una data più vecchia di 7 giorni.
| Type: | System.DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Page
Il parametro Page consente di specificare il numero della pagina dei risultati da visualizzare. I valori validi per questo parametro sono i numeri interi compresi tra 1 e 1000. Il valore predefinito è 1.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PageSize
Il parametro PageSize consente di specificare il numero massimo di voci per pagina. I valori validi per questo parametro sono i numeri interi compresi tra 1 e 5000. Il valore predefinito è 1000.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RecipientAddress
Il parametro RecipientAddress consente di filtrare i risultati in base all'indirizzo di posta elettronica del destinatario.
È possibile specificare più valori separati da virgole.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StartDate
Il parametro StartDate consente di specificare la data di inizio dell'intervallo di date.
Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018.
Ieri è la data più recente che è possibile specificare. Non è possibile specificare una data più vecchia di 7 giorni.
| Type: | System.DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |