Präzise Suchabfragen für Sicherungs- und Wiederherstellungs-APIs

Verwenden Sie präzise Suchabfragen, um bestimmte Postfachartefakte zu filtern und zu suchen, wenn Sie die Microsoft Graph-APIs für Sicherung und Wiederherstellung verwenden. Mit der präzisen Suche können Sie präzise Abfrageausdrücke erstellen, um E-Mails, Kalenderereignisse, Kontakte, Aufgaben und Notizen basierend auf verschiedenen Kriterien wie Absender, Betreff, Teilnehmern und Anlagen zu finden.

Übersicht

Die artifactQuery-Ressource enthält eine queryExpression Eigenschaft, mit der Sie Suchkriterien für Postfachartefakte angeben können. Sie können mehrere Eigenschaften mithilfe logischer Operatoren kombinieren, um komplexe Suchausdrücke zu erstellen, die Wiederherstellungspunkte nach Ihren spezifischen Anforderungen filtern.

Unterstützte Eigenschaften

In der folgenden Tabelle werden die Eigenschaften beschrieben, die Sie in Abfrageausdrücken verwenden können.

Eigenschaft Beschreibung Werttyp Unterstützte Operatoren Unterstützung von Wildcards
Subject Der Betreff der Nachricht oder die primäre durchsuchbare Zeichenfolge für andere Elementtypen Zeichenfolge -like, -and (bis zu 3) * (nach Zeichenfolge)
Sender Nachrichten vom angegebenen Absender Anzeigename, Alias, SMTP-Adresse oder LegacyDN -like * (nach Zeichenfolge)
Teilnehmer Nachrichten mit dem angegebenen Empfänger in den Feldern "An", "Bcc" oder "Cc" Anzeigename, Alias, SMTP-Adresse oder LegacyDN -like, -and (bis zu 3) * (nach Zeichenfolge)
HasAttachment Ob die Nachricht über eine Anlage verfügt Boolescher Wert (true oder false) -eq Nein
MessageKind Der Postfachelementtyp, nach dem gesucht werden soll Enumeration: Email, Notiz, Aufgabe, Kontakt, Kalender -eq Nein

Beispiele

Suchen nach E-Mails von einem bestimmten Absender mit Anlagen

(Sender -like 'abc@contoso.com') -and (HasAttachment -eq 'true')

Suchen nach E-Mails mit bestimmten Betreff-Schlüsselwörtern und mehreren Teilnehmern

(Subject -like 'Project Alpha*') -and (Participants -like 'john@contoso.com' -and Participants -like 'sarah@contoso.com')

Suchen nach Kalenderereignissen, die von einem bestimmten Benutzer organisiert werden

(MessageKind -eq 'Calendar') -and (Sender -like 'admin@contoso.com')

Suchen nach Kontakten nach Namensmuster

(MessageKind -eq 'Contact') -and (Subject -like 'Smith*')

Suchen nach E-Mails, die mehrere Kriterien kombinieren, einschließlich Nachrichtentyp, Betreff, Absender und Anlagen

(MessageKind -eq 'Email') -and (Subject -like 'Invoice*') -and (Sender -like 'vendor*') -and (HasAttachment -eq 'true')