Get-MessageTrackingReport

Modulo:: Exchange PowerShell

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 rapporti di recapito sono sostituiti da Traccia messaggio (i cmdlet Get-MessageTraceV2 e Get-MessageTraceDetailV2).

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

Sintassi

Default (Impostazione predefinita)

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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"

foreach ($reportId in $Temp.MessageTrackingReportId) {
    Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}

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 }

In questo esempio viene ottenuto il report di verifica dei messaggi per lo scenario seguente: L'utente Cigdem Akin si aspettava un messaggio di posta elettronica mai joe@contoso.com 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.

In questo esempio vengono cercati i dati di verifica messaggi per i report di verifica messaggi specifici e quindi vengono restituite 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.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DetailLevel

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

Di base: vengono restituite semplici informazioni sul rapporto di consegna, che è più appropriato per gli utenti.
Dettagliato: vengono restituite informazioni complete sul report, inclusi i nomi dei server e le informazioni sulla topologia fisica.

Proprietà dei parametri

Tipo:	MessageTrackingDetailLevel
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

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

Proprietà dei parametri

Tipo:	Fqdn
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

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

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

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

Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.

Proprietà dei parametri

Tipo:	MessageTrackingReportId
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-RecipientPathFilter

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

Proprietà dei parametri

Tipo:	SmtpAddress
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

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

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ReportTemplate

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

RecipientPath: restituisce un report di verifica 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.

Proprietà dei parametri

Tipo:	ReportTemplate
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

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

Proprietà dei parametri

Tipo:	Unlimited
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-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
Non riuscito

Proprietà dei parametri

Tipo:	_DeliveryStatus
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TraceLevel

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

Basso: vengono restituiti dati aggiuntivi minimi, inclusi i server a cui è stato eseguito l'accesso, i tempi, il conteggio dei risultati della ricerca e qualsiasi informazione sugli errori.
Medio: oltre ai dati restituiti per l'impostazione Basso, vengono restituiti anche i risultati effettivi della ricerca di verifica dei messaggi.
Alto: vengono restituiti i dati di diagnostica completi.

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

Proprietà dei parametri

Tipo:	TraceLevel
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.

Commenti e suggerimenti

Questa pagina è stata utile?