Opération AddDistributionGroupToImListAddDistributionGroupToImList operation

Trouvez des informations sur l’opération EWS AddDistributionGroupToImList .Find information about the AddDistributionGroupToImList EWS operation.

L’opération AddDistributionGroupToImList les services Web Exchange (EWS) ajoute un groupe de distribution à la liste de messagerie instantanée dans le magasin de contacts unifié.The AddDistributionGroupToImList Exchange Web Services (EWS) operation adds a distribution group to the instant messaging (IM) list in the Unified Contact Store.

Cette opération est une nouveauté d’Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Utilisation de l’opération AddDistributionGroupToImListUsing the AddDistributionGroupToImList operation

L’opération AddDistributionGroupToImList prend un seul argument qui identifie un groupe de distribution à ajouter à la liste de messagerie instantanée.The AddDistributionGroupToImList operation takes a single argument that identifies a distribution group to add to the IM list. Cette opération ne crée pas de groupe de distribution ; le groupe de distribution doit déjà être créé.This operation does not create a distribution group; the distribution group must already be created.

Cette opération peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.This operation can use the SOAP headers that are listed in the following table.

Tableau 1. En-têtes SOAP d’opération AddDistributionGroupToImListTable 1. AddDistributionGroupToImList operation SOAP headers

Nom de l'en-têteHeader name ÉlémentElement DescriptionDescription
Emprunt d’identitéImpersonation
ExchangeImpersonationExchangeImpersonation
Identifie l’utilisateur qui emprunte l’identité de l’application cliente.Identifies the user whom the client application is impersonating. Ceci s’applique à une demande.This is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifie la culture, telle que définie dans la norme RFC 3066, « balises pour l’identification des langues », à utiliser pour accéder à la boîte aux lettres.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Ceci s’applique à une demande.This is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifie la version de schéma de la demande d’opération.Identifies the schema version for the operation request. Ceci s’applique à une demande.This is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifie la version du serveur qui a répondu à la demande.Identifies the version of the server that responded to the request. Ceci s’applique à une réponse.This is applicable to a response.

Exemple de requête d’opération AddDistributionGroupToImListAddDistributionGroupToImList operation request example

L’exemple suivant de demande d’opération AddDistributionGroupToImList indique comment ajouter un groupe de distribution à la liste de messagerie instantanée.The following example of an AddDistributionGroupToImList operation request shows how to add a distribution group to the IM list.

<?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 :The request SOAP body contains the following elements:

Réponse de l’opération AddDistributionGroupToImList réussieSuccessful AddDistributionGroupToImList operation response

L’exemple suivant montre une réponse réussie à une demande d’opération AddDistributionGroupToImList .The following example shows a successful response to an AddDistributionGroupToImList operation request.

La réponse réussie contient le nom d’affichage du groupe de distribution, la classe de la banque Exchange pour le groupe de distribution et l’identificateur EWS du nouveau groupe de distribution.The successful response contains the distribution group display name, the Exchange store class for the distribution group, and the EWS identifier of the new distribution group.

<?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 réponse contient les éléments suivants :The response SOAP body contains the following elements:

AddDistributionGroupToImList Operation ErrorInvalidImDistributionGroupSmtpAddress Error ResponseAddDistributionGroupToImList operation ErrorInvalidImDistributionGroupSmtpAddress error response

L’exemple suivant montre une réponse d’erreur à une demande d’opération AddDistributionGroupToImList .The following example shows an error response to an AddDistributionGroupToImList operation request. La réponse d’erreur suivante se produit lors d’une tentative d’ajout d’un groupe de distribution qui n’existe pas dans la Banque d’informations Exchange.The following error response occurs when an attempt is made to add a distribution group that does not exist in the Exchange store.

<?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 :The error response SOAP body contains the following elements:

Voir aussiSee also