Freigeben über


Search-MessageTrackingReport

Dieses Cmdlet ist nur in lokalem Exchange funktionsfähig.

Verwenden Sie das Cmdlet Search-MessageTrackingReport, um nach einem eindeutigen Nachrichtenverfolgungsbericht auf der Grundlage der angegebenen Suchkriterien zu suchen. Sie können dann die ID des Nachrichtenverfolgungsberichts an das Cmdlet Get-MessageTrackingReport übergeben, um vollständige Informationen zur Nachrichtenverfolgung zu erhalten. Weitere Informationen finden Sie unter Get-MessageTrackingReport. Die Cmdlets für Nachrichtenverfolgungsberichte werden von der Zustellungsberichtfunktion 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

Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      -Sender <SmtpAddress>
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]
Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      [-Recipients <SmtpAddress[]>]
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]

Beschreibung

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

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

In diesem Beispiel wird der Nachrichtenverfolgungsbericht für Nachrichten gesucht, die von einem Benutzer zum anderen gesendet wurden. In diesem Beispiel wird der Nachrichtenverfolgungsbericht für eine Nachricht zurückgegeben, die von "David Jones" an "Wendy Richardson" gesendet wurde.

Beispiel 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -BypassDelegateChecking -DoNotResolve

In diesem Beispiel wird der Bericht zur Nachrichtennachverfolgung nach folgendem Szenario durchsucht: Der Benutzer Cigdem Akin hat eine E-Mail-Nachricht 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 Nachrichtenverfolgungsberichte zurückgegeben, die der Helpdesk zum Beheben des Problems analysieren soll.

Parameter

-BypassDelegateChecking

Die Option BypassDelegateChecking ermöglicht dem Help Desk-Personal und den Administratoren, Nachrichten für jeden Benutzer zu verfolgen. Sie müssen keinen Wert für diese Option angeben.

Standardmäßig können Benutzer nur Nachrichten nachverfolgen, die sie von ihrem Postfach senden oder darin empfangen.

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

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
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

-DomainController

Dieser Parameter ist im lokalen Exchange verfügbar.

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

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 Identity-Parameter begrenzt die Ergebnisse auf das angegebene Postfach. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

  • Name
  • Alias
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • Domäne\benutzername
  • E-Mail-Adresse
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Benutzer-ID oder User Principal Name (UPN)

Wenn Sie diesen Parameter ohne den Sender-Parameter verwenden, ist das angegebene Postfach der Nachrichtensender, der in der Suche verwendet wird. Sie können die Empfänger mit dem Parameter Recipients angeben.

Wenn Sie diesen Parameter mit dem Sender-Parameter verwenden, ist das angegebene Postfach der Absender der Nachricht, der in der Suche verwendet wird.

Type:MailboxIdParameter
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

-MessageEntryId

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

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

-MessageId

Der MessageId-Parameter filtert die Ergebnisse nach derMessage-ID-Kopfzeile der Nachricht. Dieser Wert wird auch Client-ID genannt. Das Format der Message-ID hängt von dem Messagingserver ab, der die Nachricht gesendet hat. Der Wert muss für jede Nachricht eindeutig sein. Allerdings erstellen nicht alle Messagingserver Werte für die Message-ID auf dieselbe Weise. Achten Sie darauf, die vollständige Nachrichten-ID-Zeichenfolge (die spitze Klammern enthalten kann) einzuschließen und den Wert in Anführungszeichen (z. B. "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com") einzuschließen.

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

-Recipients

Der Parameter Recipients filtert die Ergebnisse nach den E-Mail-Adressen der angegebenen Empfänger. Mehrere E-Mail-Adressen können durch Kommas getrennt angegeben werden.

Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter Sender.

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

-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

-Sender

Der Sender-Parameter gibt die E-Mail-Adresse des Absenders für Nachrichten an, die an das Postfach gesendet werden, das durch den Identity-Parameter angegeben wird.

Sie müssen diesen Parameter zusammen mit dem Parameter Identity verwenden.

Type:SmtpAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Subject

Der Parameter Subject such nach Nachrichten mit dem angegebenen Subject-Feldwert. Wenn der Wert Leerzeichen enthält, muss er in Anführungszeichen („“) gesetzt 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

-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 Nachrichtenverfolgung und alle Fehlerinformationen.
  • Mittel: Zusätzlich zu allen Daten, die für die Einstellung Niedrig zurückgegeben werden, 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

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Aliases:wi
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

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.