Condividi tramite

Get-MailTrafficPolicyReport

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Get-MailTrafficPolicyReport per visualizzare le statistiche sui messaggi interessati dai criteri di prevenzione della perdita dei dati e dalle regole di trasporto degli ultimi 90 giorni.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-MailTrafficPolicyReport
   [-Action <MultiValuedProperty>]
   [-AggregateBy <String>]
   [-Direction <MultiValuedProperty>]
   [-DlpPolicy <MultiValuedProperty>]
   [-Domain <MultiValuedProperty>]
   [-EndDate <DateTime>]
   [-EventType <MultiValuedProperty>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-ProbeTag <String>]
   [-StartDate <DateTime>]
   [-SummarizeBy <MultiValuedProperty>]
   [-TransportRule <MultiValuedProperty>]
   [<CommonParameters>]

Descrizione

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

  • Dominio
  • Data
  • Criteri DLP
  • Regola di trasporto
  • Tipo evento
  • Direzione
  • Numero messaggi

È 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-MailTrafficPolicyReport -Direction Outbound -StartDate 06/13/2015 -EndDate 06/15/2015

In questo esempio vengono recuperate le statistiche dei messaggi in uscita tra il 13 giugno 2015 e il 15 giugno 2015 interessati dai criteri DLP e dalle regole di trasporto.

Esempio 2

Get-MailTrafficPolicyReport -StartDate 12/12/2015 -EndDate 12/12/2015 -Direction Outbound | Format-Table Domain,Date,EventType,Action,MessageCount

Questo esempio recupera gli statici per i messaggi in uscita il 12 dicembre 2015 e visualizza i risultati in una tabella. Ogni combinazione esclusiva di EventType e Action viene visualizzata in una riga separata nella tabella.

Esempio 3

Get-MailTrafficPolicyReport -StartDate 12/12/2015 -EndDate 12/12/2015 -Direction Outbound -SummarizeBy Domain,DlpPolicy,TransportRule,EventType | Format-Table Domain,Date,EventType,Action,MessageCount

Questo esempio è simile al precedente, ma ora i risultati vengono riassunti. Poiché EventType è uno dei valori riepilogati, le righe nella tabella contengono ora valori unici diAction. Il numero totale di righe nel rapporto è minore e i valori di MessageCount sono di conseguenza maggiori in ogni riga.

Parametri

-Action

Il parametro Action filtra il report in base all'azione eseguita sui messaggi. Per visualizzare l'elenco completo dei valori validi per questo parametro, eseguire il comando : Get-MailFilterListReport -SelectionTarget Actions. L'azione specificata deve corrispondere al tipo di rapporto. Ad esempio, è possibile specificare le azioni del filtro antimalware solo per i rapporti di malware.

È 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, Exchange Online Protection

-AggregateBy

Il parametro AggregateBy consente di specificare il periodo di reporting. I valori validi sono Hour, Day o Summary. Il valore predefinito è 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

Il parametro Direction consente di filtrare i risultati in base ai messaggi in entrata o in uscita. I valori validi sono:

  • Inbound
  • In uscita

È 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, Exchange Online Protection

-DlpPolicy

Il parametro DlpPolicy consente di filtrare il report in base al nome del criterio DLP. È possibile specificare più valori separati da virgole. Se il valore contiene spazi è necessario racchiuderlo tra virgolette (").

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

Il parametro Domain consente di filtrare i risultati in base a un dominio accettato nell'organizzazione basata su cloud. È possibile specificare più valori di domini separati da virgole oppure il valore All.

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

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. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

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

Il parametro EventType consente di filtrare il rapporto in base al tipo di evento. I valori validi sono:

  • DLPActionHits
  • DLPPolicyFalsePositive
  • DLPPolicyHits
  • DLPPolicyOverride
  • DLPRuleHits
  • TransportRuleActionHits
  • TransportRuleHits

Per visualizzare l'elenco potenziale di valori validi per questo parametro, eseguire il comando : Get-MailFilterListReport -SelectionTarget EventTypes. Il tipo di evento specificato deve corrispondere al rapporto. Ad esempio, è possibile specificare solo i tipi di evento dei criteri per i report dei criteri.

È 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, Exchange Online Protection

-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, Exchange Online Protection

-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, Exchange Online Protection

-ProbeTag

Questo parametro è riservato all'uso interno da parte di 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

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. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

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

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 ciascuna istanza di uno specifico valore EventType su una singola riga nel rapporto, è possibile utilizzare il parametro SummarizeBy per visualizzare il numero totale di istanze del valore EventType su una riga nel rapporto.

Per questo cmdlet, i valori validi sono:

  • Azione
  • Direzione
  • DLPPolicy
  • Dominio
  • EventType
  • Transportrule

È possibile specificare più valori separati da virgole. Quando si specificano i valori DLPPolicy, Domain, EventType o TransportRule, il valore non viene visualizzato nei risultati (i valori nelle colonne corrispondenti sono vuoti).

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

-TransportRule

Il parametro TransportRule consente di filtrare il report in base al nome della regola di trasporto. È possibile specificare più valori separati da virgole. Se il valore contiene spazi è necessario racchiuderlo tra virgolette (").

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.