Get-MessageTraceDetail

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Il cmdlet Get-MessageTraceDetail consente di visualizzare i dettagli degli eventi di traccia dei messaggi per un messaggio specifico. Si noti che questi risultati dettagliati vengono restituiti meno rapidamente rispetto ai risultati Get-MessageTrace.

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

Sintassi

Get-MessageTraceDetail
   -MessageTraceId <Guid>
   -RecipientAddress <String>
   [-Action <MultiValuedProperty>]
   [-EndDate <DateTime>]
   [-Event <MultiValuedProperty>]
   [-MessageId <String>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-ProbeTag <String>]
   [-SenderAddress <String>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

Descrizione

È possibile usare questo cmdlet per cercare i dati dei messaggi negli ultimi 10 giorni. Se si immette un periodo di tempo più vecchio di 10 giorni, si riceverà un errore e il comando non restituirà alcun risultato.

Per cercare i dati dei messaggi che hanno più di 10 giorni, usare i cmdlet Start-HistoricalSearch e Get-HistoricalSearch.

È 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-MessageTraceDetail -MessageTraceId ae5c1219-4c90-41bf-fef5-08d837917e7c -RecipientAddress robert@contoso.com

In questo esempio vengono recuperate informazioni dettagliate sulla traccia dei messaggi con il valore ae5c1219-4c90-41bf-fef5-08d837917e7c ricevuto da robert@contoso.com.

Esempio 2

Get-MessageTrace -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018 | Get-MessageTraceDetail

In questo esempio viene utilizzato il cmdlet Get-MessageTrace per recuperare le informazioni di traccia dei messaggi per i messaggi con il valore di ID messaggio di rete di Exchange 2bbad36aa4674c7ba82f4b307fff549f inviato tra john@contoso.com il 13 giugno 2018 e il 15 giugno 2018 e esegue la pipeline dei risultati al cmdlet Get-MessageTraceDetail.

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

-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".

Se non si usano i parametri StartDate e EndDate, vengono restituiti solo i dati delle ultime 48 ore.

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

-Event

Il parametro Event consente di filtrare il rapporto in base all'evento messaggio. Di seguito sono riportati esempi di eventi comuni:

RECEIVE: il messaggio è stato ricevuto dal servizio.
SEND: il messaggio è stato inviato dal servizio.
FAIL: il messaggio non è stato recapitato.
DELIVER: il messaggio è stato recapitato a una cassetta postale.
EXPAND: il messaggio è stato inviato a un gruppo di distribuzione espanso.
TRANSFER: i destinatari sono stati spostati in un messaggio biforcato a causa della conversione del contenuto, dei limiti del destinatario del messaggio o degli agenti.
DEFER: il recapito del messaggio è stato posticipato e potrebbe essere ritento in un secondo momento.

È 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

-MessageId

Il parametro MessageId consente di filtrare i risultati in base al campo dell'intestazione Message-ID del messaggio. Questo valore è anche noto come ID client. Il formato di Message-ID dipende dal server di messaggistica che ha inviato il messaggio. Questo valore deve essere univoco per ciascun messaggio. Tuttavia, non tutti i server di messaggistica creano i valori di Message-ID nello stesso modo. Assicurarsi di includere la stringa id messaggio completa (che può includere parentesi angolari) e racchiudere il valore tra virgolette (ad esempio, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com").

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

-MessageTraceId

Il parametro MessageTraceId filtra i risultati in base al valore dell'ID traccia del messaggio. Questo valore GUID viene generato per ogni messaggio elaborato dal sistema (ad esempio, c20e0f7a-f06b-41df-fe33-08d9da155ac1).

Il valore MessageTraceId è disponibile anche nell'output dei cmdlet seguenti:

Get-MailDetailATPReport
Get-MailDetailDlpPolicyReport
Get-MailDetailEncryptionReport
Get-MailDetailTransportRuleReport
Get-MessageTrace

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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

-RecipientAddress

Il parametro RecipientAddress consente di filtrare i risultati in base all'indirizzo di posta elettronica del destinatario.

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

-SenderAddress

Il parametro SenderAddress consente di filtrare i risultati in base all'indirizzo di posta elettronica del mittente. È possibile specificare più valori separati da virgole.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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.