Opération GetHoldOnMailboxes

Article
03/29/2023

Importante

À compter du 1er avril 2020, l’opération GetHoldOnMailboxes ne sera plus disponible dans Exchange Online. Cette opération n’est pas affectée dans les versions locales de Exchange Server. Pour plus d’informations, consultez Retrait des outils eDiscovery hérités dans Exchange Online.

Recherchez des informations sur l’opération EWS GetHoldOnMailboxes .

L’opération GetHoldOnMailboxes obtient les boîtes aux lettres qui sont sous une conservation spécifique et la requête de conservation associée.

Cette opération est une nouveauté d’Exchange Server 2013.

Utilisation de l’opération GetHoldOnMailboxes

L’opération GetHoldOnMailboxes fournit au client des informations sur les boîtes aux lettres placées sous une conservation spécifique, des informations sur la requête de conservation associée à chaque conservation, le cas échéant, et des informations sur l’état de conservation pour chaque boîte aux lettres. Pour plus d’informations sur les conservations de boîte aux lettres, y compris les conservations basées sur les requêtes, consultez Conservation sur place sur TechNet.

En-têtes SOAP de l’opération GetHoldOnMailboxes

L’opération GetHoldOnMailboxes peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.

Nom de l'en-tête	Élément	Description
Managementrole	Managementrole	Identifie les rôles de serveur nécessaires pour que l’appelant effectue la demande. Cet en-tête s’applique à une requête.
RequestVersion	RequestServerVersion	Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion	ServerVersionInfo	Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération GetHoldOnMailboxes : Obtenir des informations de conservation de boîte aux lettres

L’exemple suivant de demande d’opération GetHoldOnMailboxes montre comment obtenir les informations de conservation de boîte aux lettres pour la conservation de boîte aux lettres HoldId2.

<?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:GetHoldOnMailboxes>
         <m:HoldId>HoldId2</m:HoldId>
      </m:GetHoldOnMailboxes>
   </soap:Body>
</soap:Envelope>

Le corps SOAP de la demande contient les éléments suivants :

Réponse de l’opération GetHoldOnMailboxes réussie

L’exemple suivant montre une réponse réussie à une demande d’opération GetHoldOnMailboxes pour obtenir les informations de conservation de boîte aux lettres pour la conservation de boîte aux lettres HoldId2.

<?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">
      <GetHoldOnMailboxesResponse ResponseClass="Success" 
                                  xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <MailboxHoldResult>
            <HoldId xmlns="https://schemas.microsoft.com/exchange/services/2006/types">HoldId2</HoldId>
            <Query xmlns="https://schemas.microsoft.com/exchange/services/2006/types">test</Query>
            <MailboxHoldStatuses xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
               <MailboxHoldStatus>
                  <Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDIBPDLT)/cn=Recipients/cn=ecc0fd98c2cadf-Willi</Mailbox>
                  <Status>OnHold</Status>
                  <AdditionalInfo/>
               </MailboxHoldStatus>
               <MailboxHoldStatus>
                  <Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDIBPDLT)/cn=Recipients/cn=dasdat341q8de95-Micha</Mailbox>
                  <Status>OnHold</Status>
                  <AdditionalInfo/>
               </MailboxHoldStatus>
            </MailboxHoldStatuses>
         </MailboxHoldResult>
      </GetHoldOnMailboxesResponse>
   </s:Body>
</s:Envelope>

Le corps SOAP de la réponse contient les éléments suivants :

Réponse d’erreur d’opération GetHoldOnMailboxes

L’exemple suivant montre une réponse d’erreur à une demande d’opération GetHoldOnMailboxes . Il s’agit d’une réponse à une demande d’obtention d’une conservation qui a été supprimée.

<?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">
      <GetHoldOnMailboxesResponse ResponseClass="Error" 
                                  xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specific query-based hold is not found.</MessageText>
         <ResponseCode>ErrorMailboxHoldNotFound</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </GetHoldOnMailboxesResponse>
   </s:Body>
</s:Envelope>

Le corps SOAP de la réponse d’erreur contient les éléments suivants :

Pour obtenir des codes d’erreur supplémentaires génériques pour EWS et spécifiques à cette opération, consultez ResponseCode.