SearchMailboxes-Vorgang
Hinweis
Dieser Vorgang ist veraltet und wird von Microsoft nicht mehr unterstützt. Verwenden Sie als Ersatz den FindItem-Vorgang .
Hier finden Sie Informationen zum EWS-Vorgang SearchMailboxes .
Der SearchMailboxes-Vorgang durchsucht Postfächer nach Vorkommen von Begriffen in Postfachelementen.
Dieser Vorgang wurde in Exchange Server 2013 eingeführt.
Verwenden des SearchMailboxes-Vorgangs
Der SearchMailboxes-Vorgang kann viele gleichzeitige Suchabfragen verwenden, um die Ermittlungssuche für mehrere Postfächer durchzuführen. Die Ergebnisse können entweder statistische Informationen darüber sein, wie oft Suchbegriffe auftreten, oder eine Vorschau der Elemente, die die Suchbegriffe enthalten.
SearchMailboxes-Vorgang SOAP-Header
Der SearchMailboxes-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.
Headername | Element | Beschreibung |
---|---|---|
Managementrole |
Managementrole |
Identifiziert die Serverrollen, die erforderlich sind, damit der Aufrufer die Anforderung ausführen kann. Dieser Header gilt für eine Anforderung. |
RequestVersion |
RequestServerVersion |
Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung. |
ServerVersion |
ServerVersionInfo |
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort. |
SearchMailboxes-Vorgangsanforderungsbeispiel: Durchsuchen von Postfächern nach der Anzahl von Suchbegriffstreffern
Das folgende Beispiel für eine SearchMailboxes-Vorgangsanforderung zeigt, wie Sie mithilfe von zwei verschiedenen Abfragen drei verschiedene Postfächer nach statistischen Informationen darüber durchsuchen, wie oft ein Begriff in jedem Postfach angezeigt wird.
Hinweis
In diesem Beispiel wird das Query-Element absichtlich leer gelassen. Dies zeigt, wie eine erfolgreiche Anforderung Fehlerbedingungen pro Postfachsuche enthalten kann.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://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>
Der SOAP-Anforderungstext enthält die folgenden Elemente:
Erfolgreiche SearchMailboxes-Vorgangsantwort
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine SearchMailboxes-Vorgangsanforderung , um statistische Informationen darüber zu erhalten, wie oft Suchbegriffe in den Zielpostfächern gefunden werden. Die letzte Abfrage enthält ein leeres Query-Element , das eine fehlgeschlagene Postfachsuche anzeigt.
<?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="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
Der SOAP-Antworttext enthält die folgenden Elemente:
SearchMailboxes-Vorgangsfehlerantwort
Das folgende Beispiel zeigt eine Fehlerantwort auf eine SearchMailboxes-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung zum Durchsuchen eines Postfachs, wenn der Postfachbezeichner falsch ist.
<?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="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
Der SOAP-Text der Fehlerantwort enthält die folgenden Elemente:
Weitere Fehlercodes, die für EWS generisch und für diesen Vorgang spezifisch sind, finden Sie unter ResponseCode.