SetHoldOnMailboxes-Vorgang
Wichtig
Ab dem 1. April 2020 ist der SetHoldOnMailboxes-Vorgang in Exchange Online nicht mehr verfügbar. Dieser Vorgang ist in lokalen Versionen von Exchange Server nicht betroffen. Weitere Informationen finden Sie unter Außerbetriebnahme von älteren eDiscovery-Tools in Exchange Online.
Hier finden Sie Informationen zum EWS-Vorgang SetHoldOnMailboxes .
Der SetHoldOnMailboxes-Vorgang legt eine Aufbewahrungsrichtlinie für Postfächer fest.
Dieser Vorgang wurde in Exchange Server 2013 eingeführt.
Verwenden des Vorgangs SetHoldOnMailboxes
Der SetHoldOnMailboxes-Vorgang legt ein Postfach für ein oder mehrere Postfächer fest.
SOAP-Header des SetHoldOnMailboxes-Vorgangs
Der SetHoldOnMailboxes-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. |
SetHoldOnMailboxes-Vorgangsanforderungsbeispiel: Anwenden eines Haltefelds auf ein Postfach
Das folgende Beispiel für eine SetHoldOnMailboxes-Vorgangsanforderung zeigt, wie ein Haltefeld auf zwei Postfächer angewendet wird. Der Postfachspeicher wurde mit dem Befehl New-MailboxSearch erstellt.
<?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:SetHoldOnMailboxes>
<m:ActionType>Create</m:ActionType>
<m:HoldId>HoldId2</m:HoldId>
<m:Query>test</m:Query>
<m:Mailboxes>
<t:String>/o=First/ou=Exchange(DLT)/cn=Recipients/cn=1fa441ff5e4749ba43ecc0fd94c21adf-Willi</t:String>
<t:String>/o=First/ou=Exchange(DLT)/cn=Recipients/cn=aed2346adaa34ffc9f0f339917e8de95-Micha</t:String>
</m:Mailboxes>
<m:Language>English</m:Language>
<m:IncludeNonIndexableItems>false</m:IncludeNonIndexableItems>
<m:Deduplication>true</m:Deduplication>
</m:SetHoldOnMailboxes>
</soap:Body>
</soap:Envelope>
Der SOAP-Anforderungstext enthält die folgenden Elemente:
Erfolgreiche Antwort des SetHoldOnMailboxes-Vorgangs
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine SetHoldOnMailboxes-Vorgangsanforderung zum Anhalten von zwei Postfächern.
<?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">
<SetHoldOnMailboxesResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<MailboxHoldResult>
<HoldId xmlns="http://schemas.microsoft.com/exchange/services/2006/types">HoldId2</HoldId>
<Query xmlns="http://schemas.microsoft.com/exchange/services/2006/types">test</Query>
<MailboxHoldStatuses xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
<MailboxHoldStatus>
<Mailbox>o=First/ou=Exchange(DLT)/cn=Recipients/cn=1fa441ff5e4749ba43ecc0fd94c21adf-Willi</Mailbox>
<Status>Pending</Status>
<AdditionalInfo/>
</MailboxHoldStatus>
<MailboxHoldStatus>
<Mailbox>/o=First/ou=Exchange(DLT)/cn=Recipients/cn=aed2346adaa34ffc9f0f339917e8de95-Micha</Mailbox>
<Status>Pending</Status>
<AdditionalInfo/>
</MailboxHoldStatus>
</MailboxHoldStatuses>
</MailboxHoldResult>
</SetHoldOnMailboxesResponse>
</s:Body>
</s:Envelope>
Der SOAP-Antworttext enthält die folgenden Elemente:
Fehlerantwort des SetHoldOnMailboxes-Vorgangs
Das folgende Beispiel zeigt eine Fehlerantwort auf eine SetHoldOnMailboxes-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung, die einen falsch angegebenen Postfachbezeichner enthält.
<?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">
<SetHoldOnMailboxesResponse ResponseClass="Error"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>No mailbox is specified for hold operation. If specified in the request, then it could be the object does not exist in AD or is a Distribution Group.</MessageText>
<ResponseCode>ErrorInvalidOperation</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</SetHoldOnMailboxesResponse>
</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.