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 werden Übermittlungsberichte 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
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 Nachrichtenverfolgung, 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"
foreach ($reportId in $Temp.MessageTrackingReportId) {
Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}
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.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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.
Typ: | MessageTrackingDetailLevel |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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.
Typ: | Fqdn |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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 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.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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.
Typ: | MessageTrackingReportId |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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.
Typ: | SmtpAddress |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ReportTemplate
Der Parameter ReportTemplate 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.
Typ: | ReportTemplate |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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.
Typ: | Unlimited |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Status
Der Parameter Status filtert die Ergebnisse nach der angegebenen Übermittlung status Codes. Gültige Werte sind:
- Zugestellt
- Lesen
- Ausstehend
- Überführt
- Erfolglos
Typ: | _DeliveryStatus |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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 der 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.
Typ: | TraceLevel |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | 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 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.