Get-SafeLinksAggregateReport

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Get-SafeLinksAggregateReport per restituire informazioni generali sui risultati dei collegamenti sicuri negli ultimi 90 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-SafeLinksAggregateReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-StartDate <System.DateTime>]
   [-SummarizeBy <String>]
   [<CommonParameters>]

Descrizione

Nota: se si esegue Get-SafeLinksAggregateReport 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.

Per il periodo di segnalazione specificato, il cmdlet restituisce le seguenti informazioni:

  • Azione
  • App
  • MessageCount
  • RecipientCount

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

In questo esempio vengono restituiti i risultati riepilogati in base ai risultati di Email Client e Teams per l'intervallo di date specificato.

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.

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

-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 90 giorni.

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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 90 giorni.

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

-SummarizeBy

Il parametro SummarizeBy restituisce i totali in base ai valori specificati. Se si raccolgono i dati sui filtri utilizzando uno dei valori accettati da questo parametro, è possibile utilizzare il parametro SummarizeBy per riepilogare i risultati sulla base di quei valori. Per diminuire il numero di righe restituite nel rapporto, può essere opportuno utilizzare il parametro SummarizeBy. La riepilogazione consente di ridurre la quantità di dati recuperata nel rapporto e velocizza la creazione del rapporto stesso. Ad esempio, invece di visualizzare ogni istanza di un valore specifico di Action o AppNameList in una singola riga del report, è possibile usare il parametro SummarizeBy per visualizzare il numero totale di istanze di tale azione o app specifica in una riga del report.

Per questo cmdlet, i valori validi sono:

  • Azione: vengono restituiti solo i valori specificati dal parametro Action.
  • App: vengono restituiti solo i valori specificati dal parametro AppNameList.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online