Get-MessageTrackingReport

Modul:: Exchange PowerShell

Dieses Cmdlet funktioniert nur in lokalen Exchange-Instanzen.

Verwenden Sie das Get-MessageTrackingReport Cmdlet, um Daten für einen bestimmten Nachrichtenverfolgungsbericht zurückzugeben. Dieses Cmdlet wird vom Feature "Übermittlungsberichte" verwendet.

In Exchange Online werden die Zustellungsberichte durch die Nachrichtenablaufverfolgung (die Cmdlets Get-MessageTraceV2 und Get-MessageTraceDetailV2) ersetzt.

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

Syntax

Default (Standard)

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

Beschreibung

Für dieses Cmdlet wird die ID des Nachrichtenverfolgungsberichts benötigt, den Sie anzeigen möchten. Daher müssen Sie zuerst das Cmdlet Search-MessageTrackingReport verwenden, um die ID des Nachrichtenverfolgungsberichts 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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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"

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

In diesem Beispiel wird der Bericht zur Nachrichtenverfolgung für Nachrichten abgerufen, die von einem Benutzer an einen anderen gesendet werden. Dieses Beispiel gibt die Zusammenfassung des Nachrichtenverfolgungsberichts für eine Nachricht wieder, 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 Nachrichtenverfolgungsbericht für das folgende Szenario abgerufen: Der Benutzer Cigdem Akin erwartete eine E-Mail-Nachricht joe@contoso.com , die nie angekommen ist. Sie hat sich an den Helpdesk gewendet, der im Auftrag von Cigdem einen Nachrichtenverfolgungsbericht generieren, die Anzeigenamen jedoch nicht sehen muss.

Dieses Beispiel durchsucht die Nachrichtenverfolgungsdaten nach den spezifischen Nachrichtenverfolgungsberichten und gibt dann detaillierte Informationen zur Problembehandlung für den jeweiligen Empfängerpfad zurück.

Parameter

-BypassDelegateChecking

Mit dem Schalter BypassDelegateChecking können Helpdesk-Mitarbeiter und Administratoren Nachrichtenverfolgungsberichte für jeden Benutzer abrufen. Sie müssen keinen Wert für diese Option angeben.

Standardmäßig kann jeder Benutzer die Nachrichtenverfolgungsberichte nur für Nachrichten sehen, die er von seinem eigenen Postfach sendet oder empfängt. Wenn Sie diese Option verwenden, können Sie die Berichte zur Nachrichtenverfolgung für den Nachrichtenaustausch zwischen anderen Benutzern anzeigen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DetailLevel

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

Einfach: 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 Informationen zur physischen Topologie.

Parametereigenschaften

Typ:	MessageTrackingDetailLevel
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

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

Parametereigenschaften

Typ:	Fqdn
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DoNotResolve

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

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

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

Der Parameter "Identity" gibt die ID des Nachrichtenverfolgungsberichts an, die Sie anzeigen möchten.

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

Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

Typ:	MessageTrackingReportId
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	1
Obligatorisch.:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-RecipientPathFilter

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

Parametereigenschaften

Typ:	SmtpAddress
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

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

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-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 mit dem Parameter RecipientPathFilter an.
Zusammenfassung: Gibt eine Zusammenfassung für alle Empfänger der Nachricht zurück. Sie geben die Empfänger mithilfe des Empfängerparameters an.

Parametereigenschaften

Typ:	ReportTemplate
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

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

Parametereigenschaften

Typ:	Unlimited
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Status

Der Parameter Status filtert die Ergebnisse nach den angegebenen Statuscodes der Lieferung. Gültige Werte sind:

Zugestellt
Lesen
Ausstehend
Übertragen
Nicht erfolgreich

Parametereigenschaften

Typ:	_DeliveryStatus
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-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 Server, auf die zugegriffen wurde, Timing, Nachrichtenverfolgung, Anzahl der Suchergebnisse und Fehlerinformationen.
Mittel: Zusätzlich zu den Daten, die für die Einstellung "Niedrig" zurückgegeben werden, werden auch die tatsächlichen Suchergebnisse zur Nachrichtenverfolgung 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.

Parametereigenschaften

Typ:	TraceLevel
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Feedback

War diese Seite hilfreich?