Get-MessageTrackingReport

Questo cmdlet funziona solo in Exchange locale.

Utilizzare il cmdlet Get-MessageTrackingReport per restituire i dati per uno specifico rapporto di tracciabilità dei messaggi. Il cmdlet viene utilizzato dalla funzionalità relativa ai rapporti di recapito.

In Exchange Online, i report di recapito sono stati sostituiti dalla traccia dei messaggi (i cmdlet Get-MessageTrace e Get-MessageTraceDetail).

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

Sintassi

Get-MessageTrackingReport
   [-Identity] <MessageTrackingReportId>
   [-BypassDelegateChecking]
   [-DetailLevel <MessageTrackingDetailLevel>]
   [-DomainController <Fqdn>]
   [-DoNotResolve]
   [-RecipientPathFilter <SmtpAddress>]
   [-Recipients <String[]>]
   [-ReportTemplate <ReportTemplate>]
   [-ResultSize <Unlimited>]
   [-Status <DeliveryStatus>]
   [-TraceLevel <TraceLevel>]
   [<CommonParameters>]

Descrizione

Il cmdlet richiede l'ID del rapporto di tracciabilità dei messaggi che si desidera visualizzare. Pertanto, è innanzitutto necessario usare il cmdlet Search-MessageTrackingReport per trovare l'ID del rapporto di tracciabilità di uno specifico messaggio e inoltrare i risultati al cmdlet. Per maggiori informazioni, vedere Search-MessageTrackingReport.

È 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

$Temp = Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate Summary

In questo esempio si ottiene il rapporto di tracciabilità dei messaggi per i messaggi inviati da un utente a un altro. In questo esempio viene restituito il riepilogo del rapporto di tracciabilità di un messaggio che David Jones ha inviato a Wendy Richardson.

Esempio 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object { Get-MessageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigdem@fabrikam.com" -ReportTemplate RecipientPath }

Questo esempio ottiene il report di rilevamento dei messaggi per lo scenario seguente: l'utente Cigdem Akin si aspettava un messaggio di posta elettronica da joe@contoso.com cui non è mai arrivato. Si è messa in contatto con il supporto tecnico, che ha la necessità di generare il rapporto di tracciabilità dei messaggi per conto di Cigdem e non necessita di vedere i nomi visualizzati.

Questo esempio cerca nei dati di rilevamento messaggi i report di rilevamento dei messaggi specifici e quindi restituisce informazioni dettagliate sulla risoluzione dei problemi per il percorso del destinatario specifico.

Parametri

-BypassDelegateChecking

L'opzione BypassDelegateChecking consente al personale di supporto tecnico e agli amministratori di ottenere rapporti di tracciabilità dei messaggi per qualsiasi utente. Con questa opzione non è necessario specificare alcun valore.

Per impostazione predefinita, ogni utente può solo visualizzare i rapporti di tracciabilità dei messaggi inviati o ricevuti dalla propria cassetta postale. L'opzione consente di visualizzare i rapporti di tracciabilità dei messaggi per gli scambi di messaggi tra gli altri utenti.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DetailLevel

Il parametro DetailLevel specifica il numero di dettagli da restituire nei risultati. I valori validi sono:

  • Basic: vengono restituite informazioni semplici sul report di recapito, più appropriate per gli utenti.
  • Dettagliato: vengono restituite informazioni complete sul report, inclusi i nomi dei server e le informazioni sulla topologia fisica.
Type:MessageTrackingDetailLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotResolve

L'opzione DoNotResolve specifica se impedire la risoluzione degli indirizzi di posta elettronica nei nomi visualizzati. Con questa opzione non è necessario specificare alcun valore.

L'utilizzo di questo parametro migliora le prestazioni, ma la mancanza di nomi visualizzati potrebbe rendere più complessa l'interpretazione dei risultati.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Il parametro Identity specifica il rapporto di tracciabilità dei messaggi da visualizzare.

Eseguire il cmdlet Search-MessageTrackingReport per trovare l'ID del rapporto di tracciabilità dei messaggi per il messaggio specifico di cui si desidera tenere traccia e quindi impostare il valore del campo MessageTrackingReportID su questo parametro.

Type:MessageTrackingReportId
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RecipientPathFilter

Il parametro RecipientPathFilter consente di specificare l'indirizzo di posta elettronica del destinatario quando si utilizza il parametro ReportTemplate con il valore RecipientPath.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Recipients

Il parametro Recipients consente di specificare gli indirizzi di posta elettronica dei destinatari quando si utilizza il parametro ReportTemplate con il valore Summary. È possibile indicare più indirizzi di posta elettronica separati da virgole.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ReportTemplate

Il parametro ReportTemplate specifica un formato predefinito per l'output. I valori validi sono:

  • RecipientPath: restituisce un report di rilevamento dettagliato per un destinatario del messaggio. Specificare il destinatario usando il parametro RecipientPathFilter.
  • Riepilogo: restituisce un riepilogo per tutti i destinatari del messaggio. Specificare i destinatari usando il parametro Recipients.
Type:ReportTemplate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Status

Il parametro Status filtra i risultati in base ai codici relativi allo stato di consegna specificato. I valori validi sono:

  • Recapito effettuato
  • Lettura
  • In sospeso
  • Trasferito
  • Infruttuoso
Type:_DeliveryStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TraceLevel

Il parametro TraceLevel specifica i dettagli da includere nei risultati. I valori validi sono:

  • Bassa: vengono restituiti dati aggiuntivi minimi, inclusi i server a cui è stato eseguito l'accesso, la tempistica, i conteggi dei risultati della ricerca di rilevamento dei messaggi ed eventuali informazioni sugli errori.
  • Medio: oltre ai dati restituiti per l'impostazione Bassa, vengono restituiti anche i risultati effettivi della ricerca di rilevamento dei messaggi.
  • Alto: vengono restituiti dati di diagnostica completi.

È necessario utilizzare soltanto questo parametro per risolvere i problemi relativi alla tracciabilità dei messaggi.

Type:TraceLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.