GetDiscoverySearchConfiguration-Vorgang
Hier finden Sie Informationen zum EWS-Vorgang GetDiscoverySearchConfiguration .
Der GetDiscoverySearchConfiguration-Vorgang gibt Konfigurationsinformationen für direkte Haltebereiche, gespeicherte Ermittlungssuchen und die Postfächer zurück, die für die Ermittlungssuche aktiviert sind.
Dieser Vorgang wurde in Exchange Server 2013 eingeführt.
Verwenden des GetDiscoverySearchConfiguration-Vorgangs
Der GetDiscoverySearchConfiguration-Vorgang stellt Konfigurationsinformationen für die Ermittlungssuche bereit. Anforderungen können eines oder mehrere der folgenden Argumente enthalten:
SearchId – Identifiziert eine gespeicherte Ermittlungssuche. Wenn dieses Argument in der Anforderung gesendet wird, werden die Werte der anderen Argumente ignoriert.
ExpandGroupMembership – Gibt an, ob die Gruppenmitgliedschaft in der Antwort erweitert wird. Der Wert true gibt an, dass die Gruppenmitgliedschaft erweitert wird, sodass alle durchsuchbaren Postfächer in der Antwort zurückgegeben werden. Der Wert false gibt an, dass nur die Gruppe in der Antwort zurückgegeben wird.
InPlaceHoldConfigurationOnly – Gibt an, ob alle durchsuchbaren Postfächer zusätzlich zur Konfiguration des direkten Aufbewahrungsspeichers zurückgegeben werden. Der Wert true gibt an, dass nur die direkten Aufbewahrungskonfigurationen zurückgegeben werden. Der Wert false gibt an, dass alle durchsuchbaren Postfachbezeichner zusätzlich zu den direkten Aufbewahrungsbezeichnern zurückgegeben werden. Wenn dieses Element nicht vorhanden ist, entspricht das Standardverhalten dem Wert false.
SOAP-Header des GetDiscoverySearchConfiguration-Vorgangs
Der GetDiscoverySearchConfiguration-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. |
GetDiscoverySearchConfiguration-Vorgangsanforderungsbeispiel: Abrufen der Konfiguration der Ermittlungssuche für eine gespeicherte Suche
Das folgende Beispiel einer GetDiscoverySearchConfiguration-Vorgangsanforderung zeigt, wie die Konfiguration einer gespeicherten Suche mit dem Namen "MyDiscSearchFor-sbrown" anzufordern wird. Die Argumente für die Elemente ExpandGroupMembership und InPlaceHoldConfigurationOnly werden ignoriert.
<?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:GetDiscoverySearchConfiguration>
<m:SearchId>MyDiscSearchFor-sbrown</m:SearchId>
<m:ExpandGroupMembership>true</m:ExpandGroupMembership>
<m:InPlaceHoldConfigurationOnly>false</m:InPlaceHoldConfigurationOnly>
</m:GetDiscoverySearchConfiguration>
</soap:Body>
</soap:Envelope>
Der SOAP-Anforderungstext enthält die folgenden Elemente:
Erfolgreiche GetDiscoverySearchConfiguration-Vorgangsantwort: Anforderung für eine einzelne gespeicherte Suche
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetDiscoverySearchConfiguration-Vorgangsanforderung zum Abrufen der Konfiguration einer gespeicherten Suche namens "MyDiscSearchFor-sbrown".
<?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">
<GetDiscoverySearchConfigurationResponse ResponseClass="Success" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<DiscoverySearchConfigurations>
<DiscoverySearchConfiguration xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<SearchId>MyDiscSearchFor-sbrown</SearchId>
<SearchQuery>test item</SearchQuery>
<SearchableMailboxes>
<SearchableMailbox>
<Guid>3c620d04-8b22-432e-92be-5b9321599576</Guid>
<PrimarySmtpAddress>SBrown@contoso.com</PrimarySmtpAddress>
<IsExternalMailbox>false</IsExternalMailbox>
<ExternalEmailAddress/>
<DisplayName>Steven Brown</DisplayName>
<IsMembershipGroup>false</IsMembershipGroup>
<ReferenceId>/o=First/ou=Exchange(FYDILT)/cn=Recipients/cn=313ecf-Steve</ReferenceId>
</SearchableMailbox>
</SearchableMailboxes>
</DiscoverySearchConfiguration>
</DiscoverySearchConfigurations>
</GetDiscoverySearchConfigurationResponse>
</s:Body>
</s:Envelope>
Der SOAP-Antworttext enthält die folgenden Elemente:
Erfolgreiche GetDiscoverySearchConfiguration-Vorgangsantwort: Anforderung für direkte Haltebereiche
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetDiscoverySearchConfiguration-Vorgangsanforderung , um nur direkte Haltebereiche abzurufen.
<?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">
<GetDiscoverySearchConfigurationResponse ResponseClass="Success"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<DiscoverySearchConfigurations>
<DiscoverySearchConfiguration xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<SearchId>MyDiscSearchFor-sbrown</SearchId>
<SearchQuery>test item</SearchQuery>
<InPlaceHoldIdentity>3f37d90f53144558a80814ef0272749a9</InPlaceHoldIdentity>
<ManagedByOrganization/>
</DiscoverySearchConfiguration>
<DiscoverySearchConfiguration xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<SearchId>MyDiscSearch</SearchId>
<SearchQuery>test</SearchQuery>
<InPlaceHoldIdentity>6ea486f0f3f140efb044682a2e782abdf</InPlaceHoldIdentity>
<ManagedByOrganization/>
</DiscoverySearchConfiguration>
</DiscoverySearchConfigurations>
</GetDiscoverySearchConfigurationResponse>
</s:Body>
</s:Envelope>
Der SOAP-Antworttext enthält die folgenden Elemente:
Erfolgreiche GetDiscoverySearchConfiguration-Vorgangsantwort: Anforderung für alle gespeicherten Suchkonfigurationen für die Ermittlung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetDiscoverySearchConfiguration-Vorgangsanforderung zum Abrufen aller gespeicherten Ermittlungssuchen.
<?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">
<GetDiscoverySearchConfigurationResponse ResponseClass="Success"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<DiscoverySearchConfigurations>
<DiscoverySearchConfiguration xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<SearchId>MyDiscSearchFor-sbrown</SearchId>
<SearchQuery>test item</SearchQuery>
<SearchableMailboxes>
<SearchableMailbox>
<Guid>3c620d04-8b33-435e-95be-5b9351599576</Guid>
<PrimarySmtpAddress>SBrown@contoso.com</PrimarySmtpAddress>
<IsExternalMailbox>false</IsExternalMailbox>
<ExternalEmailAddress/>
<DisplayName>Steven Brown</DisplayName>
<IsMembershipGroup>false</IsMembershipGroup>
<ReferenceId>/o=First/ou=Exchange (FYLT)/cn=Recipients/cn=35381a742f0e47e395c8601a60d13ecz-Steve</ReferenceId>
</SearchableMailbox>
</SearchableMailboxes>
</DiscoverySearchConfiguration>
<DiscoverySearchConfiguration xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<SearchId>MyDiscSearch</SearchId>
<SearchQuery>test</SearchQuery>
<SearchableMailboxes>
<SearchableMailbox>
<Guid>e788c4b0-54a2-458c-83b2-22d5bb02b23f</Guid>
<PrimarySmtpAddress>Administrator@contoso.com</PrimarySmtpAddress>
<IsExternalMailbox>false</IsExternalMailbox>
<ExternalEmailAddress/>
<DisplayName>Administrator</DisplayName>
<IsMembershipGroup>false</IsMembershipGroup>
<ReferenceId>/o=First/ou=Exchange (FYLT)/cn=Recipients/cn=ebez7871332d4595abe1c62962911a58-Admin</ReferenceId>
</SearchableMailbox>
<SearchableMailbox>
<Guid>6f6cff39-8967-4a60-b43f-328413c25199</Guid>
<PrimarySmtpAddress>ADavis@contoso.com</PrimarySmtpAddress>
<IsExternalMailbox>false</IsExternalMailbox>
<ExternalEmailAddress/>
<DisplayName>Anthony Davis</DisplayName>
<IsMembershipGroup>false</IsMembershipGroup>
<ReferenceId>/o=First/ou=Exchange (FYLT)/cn=Recipients/cn=f10c9f70519844beb04101d8f40c572z-Antho</ReferenceId>
</SearchableMailbox>
</SearchableMailboxes>
</DiscoverySearchConfiguration>
</DiscoverySearchConfigurations>
</GetDiscoverySearchConfigurationResponse>
</s:Body>
</s:Envelope>
Der SOAP-Antworttext enthält die folgenden Elemente:
Fehlerantwort für GetDiscoverySearchConfiguration-Vorgang
Das folgende Beispiel zeigt eine Fehlerantwort auf eine GetDiscoverySearchConfiguration-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung zum Abrufen einer gespeicherten Suche, die auf dem Server nicht gefunden wird.
<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">
<GetDiscoverySearchConfigurationResponse ResponseClass="Error"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>Search configuration corresponding to the search id was not found.</MessageText>
<ResponseCode>ErrorInvalidArgument</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
<DiscoverySearchConfigurations/>
</GetDiscoverySearchConfigurationResponse>
</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.
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für