Детализированные поисковые запросы для API резервного копирования и восстановления

Используйте детализированные поисковые запросы для фильтрации и поиска определенных артефактов почтовых ящиков при использовании API резервного копирования и восстановления Microsoft Graph. Детализированный поиск позволяет создавать точные выражения запросов для поиска сообщений электронной почты, событий календаря, контактов, задач и заметок на основе различных критериев, таких как отправитель, тема, участники и вложения.

Обзор

Ресурс artifactQuery содержит queryExpression свойство, позволяющее указать критерии поиска для артефактов почтовых ящиков. Вы можете объединить несколько свойств с помощью логических операторов для создания сложных выражений поиска, которые фильтруют точки восстановления на основе конкретных требований.

Поддерживаемые свойства

В следующей таблице описаны свойства, которые можно использовать в выражениях запросов.

Свойство	Описание	Тип значения	Поддерживаемые операторы	Поддержка подстановочных знаков
Subject	Тема сообщения или основная строка с возможностью поиска для других типов элементов	String	-like, -and (до 3)	* (после строки)
Sender	Сообщения от указанного отправителя	Отображаемое имя, псевдоним, SMTP-адрес или устаревшее имя	-like	* (после строки)
Участники	Сообщения с указанным получателем в полях Кому, СК или Копия	Отображаемое имя, псевдоним, SMTP-адрес или устаревшее имя	-like, -and (до 3)	* (после строки)
HasAttachment	Содержит ли сообщение вложение	Логическое значение (true или false)	-eq	Нет
MessageKind	Тип элемента почтового ящика, для которого выполняется поиск	Перечисление: Email, Примечание, Задача, Контакт, Календарь	-eq	Нет

Примеры

Поиск сообщений электронной почты от определенного отправителя с вложениями

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

Поиск сообщений электронной почты с ключевыми словами конкретной темы и несколькими участниками

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

Поиск событий календаря, организованных определенным пользователем

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

Поиск контактов по шаблону имени

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

Поиск сообщений электронной почты, сочетающих несколько критериев, включая тип сообщения, тему, отправителя и вложения

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