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