Opération AddDistributionGroupToImList

  • Article

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

L’opération AddDistributionGroupToImList Exchange Web Services (EWS) ajoute un groupe de distribution à la liste de messagerie instantanée dans le magasin de contacts unifié.

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

Utilisation de l’opération AddDistributionGroupToImList

L’opération AddDistributionGroupToImList prend un argument unique qui identifie un groupe de distribution à ajouter à la liste de messagerie instantanée. Cette opération ne crée pas de groupe de distribution ; le groupe de distribution doit déjà être créé.

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

Tableau 1. En-têtes SOAP de l’opération AddDistributionGroupToImList

Nom de l'en-tête Élément Description
Imitation
ExchangeImpersonation
Identifie l’utilisateur que l’application cliente emprunte l’identité. Cela s’applique à une demande.
MailboxCulture
MailboxCulture
Identifie la culture, telle que définie dans la RFC 3066, « Balises pour l’identification des langues », à utiliser pour accéder à la boîte aux lettres. Cela s’applique à une demande.
RequestVersion
RequestServerVersion
Identifie la version du schéma pour la demande d’opération. Cela s’applique à une demande.
ServerVersion
ServerVersionInfo
Identifie la version du serveur qui a répondu à la requête. Cela s’applique à une réponse.

Exemple de demande d’opération AddDistributionGroupToImList

L’exemple suivant de demande d’opération AddDistributionGroupToImList montre comment ajouter un groupe de distribution à la liste de messagerie instantanée.

<?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" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:AddDistributionGroupToImList>
         <m:SmtpAddress>distributionlist1@example.com</m:SmtpAddress>
      </m:AddDistributionGroupToImList>
   </soap:Body>
</soap:Envelope>

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

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

L’exemple suivant montre une réponse réussie à une demande d’opération AddDistributionGroupToImList .

La réponse réussie contient le nom complet du groupe de distribution, la classe de magasin Exchange pour le groupe de distribution et l’identificateur EWS du nouveau groupe de distribution.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="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">
   <s:Header>
      <t:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013"/>
   </s:Header>
   <s:Body>
      <m:AddDistributionGroupToImListResponse ResponseClass="Success">
         <m:ResponseCode>NoError</m:ResponseCode>
         <m:ImGroup>
            <t:DisplayName>distributionlist1@example.com</t:DisplayName>
            <t:GroupType>IPM.DistList.MOC.DG</t:GroupType>
            <t:ExchangeStoreId Id="AAMkAGQ1MjJjAA=" 
                             ChangeKey="EgAAAA=="/>
      </m:ImGroup>
      </m:AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

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

Réponse d’erreur de l’opération AddDistributionGroupToImList ErrorInvalidImDistributionGroupSmtpAddress

L’exemple suivant montre une réponse d’erreur à une demande d’opération AddDistributionGroupToImList . La réponse d’erreur suivante se produit lorsqu’une tentative d’ajout d’un groupe de distribution qui n’existe pas dans le magasin Exchange est effectué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="349" 
                           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">
      <AddDistributionGroupToImListResponse ResponseClass="Error" 
                                            xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified IM distribution group SMTP address is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImDistributionGroupSmtpAddress</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

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

Voir aussi