Get-MessageTrackingReport

Dieses Cmdlet ist nur in lokalem Exchange funktionsfähig.

Verwenden Sie das Cmdlet Get-MessageTrackingReport, um Daten für einen bestimmten Bericht zur Nachrichtennachverfolgung zurückzugeben. Dieses Cmdlet wird vom Übermittlungsberichtsfeature verwendet.

In Exchange Online wurden Übermittlungsberichte durch die Nachrichtenablaufverfolgung (die Cmdlets Get-MessageTrace und Get-MessageTraceDetail) ersetzt.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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

Beschreibung

Dieses Cmdlet erfordert die ID für den Bericht zur Nachrichtennachverfolgung, den Sie anzeigen möchten. Daher müssen Sie zuerst das Cmdlet Search-MessageTrackingReport verwenden, um die Berichts-ID für die Nachrichtennachverfolgung für eine bestimmte Nachricht zu ermitteln, und dann die Ergebnisse an dieses Cmdlet übergeben. Weitere Informationen finden Sie unter Search-MessageTrackingReport.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

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

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

In diesem Beispiel wird der Bericht zur Nachrichtennachverfolgung für Nachrichten abgerufen, die von einem Benutzer an einen anderen gesendet werden. In diesem Beispiel wird die Zusammenfassung des Nachrichtenverfolgungsberichts für eine Nachricht zurückgegeben, die David Jones an Wendy Richardson gesendet hat.

Beispiel 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 diesem Beispiel wird der Bericht zur Nachrichtennachverfolgung für das folgende Szenario abgerufen: Der Benutzer Cigdem Akin hat eine E-Mail-Nachricht von erwartet, die joe@contoso.com nie eingetroffen ist. Sie hat sich an den Helpdesk gewendet, der im Auftrag von Cigdem einen Nachrichtenverfolgungsbericht generieren, die Anzeigenamen jedoch nicht sehen muss.

In diesem Beispiel werden die Nachrichtenverfolgungsdaten nach den spezifischen Nachrichtenverfolgungsberichten durchsucht und dann ausführliche Informationen zur Problembehandlung für den spezifischen Empfängerpfad zurückgegeben.

Parameter

-BypassDelegateChecking

Mit dem Schalter BypassDelegateChecking können Helpdeskmitarbeiter und Administratoren Berichte zur Nachrichtennachverfolgung für jeden Benutzer abrufen. Sie müssen keinen Wert für diese Option angeben.

Standardmäßig kann jeder Benutzer nur die Nachrichtennachverfolgungsberichte für Nachrichten anzeigen, die er über sein eigenes Postfach sendet oder empfängt. Wenn Sie diesen Schalter verwenden, können Sie die Nachrichtenverfolgungsberichte für den Nachrichtenaustausch unter anderen Benutzern anzeigen.

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

Der DetailLevel-Parameter gibt die Menge an Details an, die in den Ergebnissen zurückgegeben werden sollen. Gültige Werte sind:

  • Basic: Es werden einfache Übermittlungsberichtsinformationen zurückgegeben, die für Benutzer besser geeignet sind.
  • Ausführlich: Es werden vollständige Berichtsinformationen zurückgegeben, einschließlich Servernamen und physischen Topologieinformationen.
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

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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

Die Option DoNotResolve gibt an, ob die Auflösung von E-Mail-Adressen in Anzeigenamen verhindert werden soll. Sie müssen bei dieser Option keinen Wert angeben.

Die Verwendung dieser Option verbessert die Leistung, wobei das Fehlen der Anzeigenamen die Interpretation der Ergebnisse möglicherweise erschwert.

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

Der Parameter Identity gibt die Berichts-ID für die Nachrichtennachverfolgung an, die Sie anzeigen möchten.

Sie müssen das Cmdlet Search-MessageTrackingReport ausführen, um die Nachrichtenverfolgungsberichts-ID für die spezifische Nachricht zu ermitteln, die Sie nachverfolgen, und dann den Wert des Felds MessageTrackingReportID an diesen Parameter übergeben.

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

Der Parameter RecipientPathFilter gibt die E-Mail-Adresse des Empfängers an, wenn Sie den ReportTemplate-Parameter mit dem Wert RecipientPath verwenden.

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

Der Parameter Recipients gibt die E-Mail-Adressen der Empfänger an, wenn Sie den ReportTemplate-Parameter mit dem Wert Summary verwenden. Mehrere E-Mail-Adressen können durch Kommas getrennt angegeben werden.

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

Der ReportTemplate-Parameter gibt ein vordefiniertes Format für die Ausgabe an. Gültige Werte sind:

  • RecipientPath: Gibt einen detaillierten Nachverfolgungsbericht für einen Empfänger der Nachricht zurück. Sie geben den Empfänger mithilfe des Parameters RecipientPathFilter an.
  • Zusammenfassung: Gibt eine Zusammenfassung für alle Empfänger der Nachricht zurück. Sie geben die Empfänger mithilfe des Parameters Recipients an.
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

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 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

Der Status-Parameter filtert die Ergebnisse nach den angegebenen Übermittlungsstatuscodes. Gültige Werte sind:

  • Zugestellt
  • Lesen
  • Ausstehend
  • Übertragen
  • Erfolglos
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

Der Parameter TraceLevel gibt die Details an, die in die Ergebnisse einbezogen werden sollen. Gültige Werte sind:

  • Niedrig: Es werden minimale zusätzliche Daten zurückgegeben, einschließlich der Server, auf die zugegriffen wurde, der Zeitpunkt, die Anzahl der Suchergebnisse für die Nachrichtennachverfolgung und alle Fehlerinformationen.
  • Mittel: Zusätzlich zu den für die Einstellung Niedrig zurückgegebenen Daten werden auch die tatsächlichen Suchergebnisse für die Nachrichtennachverfolgung zurückgegeben.
  • Hoch: Vollständige Diagnosedaten werden zurückgegeben.

Sie müssen nur diesen Parameter nur für die Fehlerbehebung beim Verfolgen von Nachrichten verwenden.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.