Операция SearchMailboxes
Примечание.
Эта операция устарела и больше не поддерживается корпорацией Майкрософт. В качестве замены используйте операцию FindItem .
Найдите сведения об операции EWS SearchMailboxes .
Операция SearchMailboxes выполняет поиск в почтовых ящиках вхождения терминов в элементах почтовых ящиков.
Эта операция появилась в Exchange Server 2013.
Использование операции SearchMailboxes
Операция SearchMailboxes может использовать множество одновременных поисковых запросов для поиска в нескольких почтовых ящиках. Результаты могут быть либо статистическими сведениями о количестве случаев возникновения условий поиска, либо предварительным просмотром элементов, содержащих условия поиска.
Заголовки SOAP операции SearchMailboxes
Операция SearchMailboxes может использовать заголовки SOAP, перечисленные в следующей таблице.
| Имя заголовка | Элемент | Описание |
|---|---|---|
| ManagementRole |
ManagementRole |
Определяет роли сервера, необходимые для выполнения вызывающей стороны запроса. Этот заголовок применим к запросу. |
| RequestVersion |
RequestServerVersion |
Определяет версию схемы для запроса операции. Этот заголовок применим к запросу. |
| ServerVersion |
ServerVersionInfo |
Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу. |
Пример запроса операции SearchMailboxes: поиск в почтовых ящиках по количеству попаданий в поисковые запросы
В следующем примере запроса операции SearchMailboxes показано, как использовать два разных запроса для поиска в трех разных почтовых ящиках статистических сведений о том, сколько раз термин отображается в каждом почтовом ящике.
Примечание.
В этом примере элемент Query намеренно остается пустым. Это показывает, как успешный запрос может содержать условия ошибок на основе поиска для каждого почтового ящика.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body >
<m:SearchMailboxes>
<m:SearchQueries>
<t:MailboxQuery>
<t:Query>Test Item</t:Query>
<t:MailboxSearchScopes>
<t:MailboxSearchScope>
<t:Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDLT)/cn=Recipients/cn=12311a742f0e47e392c8201a60d13ecf-Steve</t:Mailbox>
<t:SearchScope>All</t:SearchScope>
</t:MailboxSearchScope>
<t:MailboxSearchScope>
<t:Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDLT)/cn=Recipients/cn=f00c9f70539844beb52341d8f40c572e-Antho</t:Mailbox>
<t:SearchScope>PrimaryOnly</t:SearchScope>
</t:MailboxSearchScope>
</t:MailboxSearchScopes>
</t:MailboxQuery>
<t:MailboxQuery>
<t:Query></t:Query>
<t:MailboxSearchScopes>
<t:MailboxSearchScope>
<t:Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDLT)/cn=Recipients/cn=accba4fd5ddf12214a0e82ce1645f4e-Danie</t:Mailbox>
<t:SearchScope>ArchiveOnly</t:SearchScope>
</t:MailboxSearchScope>
</t:MailboxSearchScopes>
</t:MailboxQuery>
</m:SearchQueries>
<m:ResultType>StatisticsOnly</m:ResultType>
</m:SearchMailboxes>
</soap:Body>
</soap:Envelope>
Текст SOAP запроса содержит следующие элементы:
Успешный ответ операции SearchMailboxes
В следующем примере показан успешный ответ на запрос операции SearchMailboxes для получения статистических сведений о количестве поисков в целевых почтовых ящиках. Последний запрос содержит пустой элемент Query , который показывает неудачный поиск в почтовом ящике.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:SearchMailboxesResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:SearchMailboxesResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:SearchMailboxesResult>
<t:SearchQueries>
<t:MailboxQuery>
<t:Query>Test Item</t:Query>
<t:MailboxSearchScopes>
<t:MailboxSearchScope>
<t:Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYPDLT)/cn=Recipients/cn=35181a94327e392c8201a60d13ecf-Steve</t:Mailbox>
<t:SearchScope>All</t:SearchScope>
</t:MailboxSearchScope>
<t:MailboxSearchScope>
<t:Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYPDLT)/cn=Recipients/cn=f00c9f789572-beb04001d8f40c572e-Antho</t:Mailbox>
<t:SearchScope>PrimaryOnly</t:SearchScope>
</t:MailboxSearchScope>
</t:MailboxSearchScopes>
</t:MailboxQuery>
</t:SearchQueries>
<t:ResultType>StatisticsOnly</t:ResultType>
<t:ItemCount>2</t:ItemCount>
<t:Size>20206</t:Size>
<t:PageItemCount>0</t:PageItemCount>
<t:PageItemSize>0</t:PageItemSize>
<t:KeywordStats>
<t:KeywordStat>
<t:Keyword>Test Item</t:Keyword>
<t:ItemHits>2</t:ItemHits>
<t:Size>20206</t:Size>
</t:KeywordStat>
</t:KeywordStats>
<t:FailedMailboxes>
<t:FailedMailbox>
<t:Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYPDLT)/cn=Recipients/cn=accba4as3df234234a0e82ce1645f4e-Danie</t:Mailbox>
<t:ErrorCode>0</t:ErrorCode>
<t:ErrorMessage>The search query can't be empty.</t:ErrorMessage>
<t:IsArchive>true</t:IsArchive>
</t:FailedMailbox>
</t:FailedMailboxes>
</m:SearchMailboxesResult>
</m:SearchMailboxesResponseMessage>
</m:ResponseMessages>
</m:SearchMailboxesResponse>
</s:Body>
</s:Envelope>
Текст SOAP ответа содержит следующие элементы:
Ответ на ошибку операции SearchMailboxes
В следующем примере показан ответ на ошибку на запрос операции SearchMailboxes . Это ответ на запрос на поиск в почтовом ящике, если идентификатор почтового ящика неверный.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:SearchMailboxesResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:SearchMailboxesResponseMessage ResponseClass="Error">
<m:MessageText>No mailbox is specified for search operation. If specified in the request,
then it could be due to permission issue.</m:MessageText>
<m:ResponseCode>ErrorInvalidOperation</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:SearchMailboxesResult>
<t:SearchQueries>
<t:MailboxQuery>
<t:Query>subject:Test Item</t:Query>
<t:MailboxSearchScopes>
<t:MailboxSearchScope>
<t:Mailbox>sbrown@contoso.com</t:Mailbox>
<t:SearchScope>All</t:SearchScope>
</t:MailboxSearchScope>
</t:MailboxSearchScopes>
</t:MailboxQuery>
</t:SearchQueries>
<t:ResultType>StatisticsOnly</t:ResultType>
<t:ItemCount>0</t:ItemCount>
<t:Size>0</t:Size>
<t:PageItemCount>0</t:PageItemCount>
<t:PageItemSize>0</t:PageItemSize>
<t:FailedMailboxes>
<t:FailedMailbox>
<t:Mailbox>sbrown@contoso.com</t:Mailbox>
<t:ErrorCode>0</t:ErrorCode>
<t:ErrorMessage>No mailbox is specified for search operation. If specified in the request,
then it could be due to permission issue.</t:ErrorMessage>
<t:IsArchive>false</t:IsArchive>
</t:FailedMailbox>
</t:FailedMailboxes>
</m:SearchMailboxesResult>
</m:SearchMailboxesResponseMessage>
</m:ResponseMessages>
</m:SearchMailboxesResponse>
</s:Body>
</s:Envelope>
Текст soap ответа на ошибку содержит следующие элементы:
Дополнительные коды ошибок, которые являются общими для EWS и относятся к этой операции, см. в разделе ResponseCode.
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по