Créer des groupes de contacts à l’aide d’EWS dans Exchange

  • Article

Découvrez comment créer un groupe de contacts à l’aide de l’API managée EWS ou EWS dans Exchange.

Vous pouvez créer un groupe de contacts, qui est un groupe de distribution privé, à l’aide de l’API managée EWS ou EWS. Pour créer des groupes de contacts, utilisez les méthodes de la classe d’API managée ContactGroup EWS ou utilisez l’opération CreateItem EWS.

Notez que vous ne pouvez pas utiliser l’API managée EWS ou EWS pour créer un groupe de distribution universel ou un groupe de sécurité. Pour créer un groupe de distribution universel ou un groupe de sécurité, vous pouvez utiliser l’applet de commande New-DistributionGroupExchange Management Shell.

Créer un groupe de contacts à l’aide de l’API managée EWS

Pour créer un groupe de contacts, vous avez simplement besoin de quelques informations : un nom pour le groupe et les membres à ajouter au groupe. L’exemple suivant montre comment créer un groupe de contacts simple qui contient quelques membres de groupe.

// Create a new contact group object.
ContactGroup myContactGroup = new ContactGroup(service);
// Give the group a name.
myContactGroup.DisplayName = "My Contact Group";
// Add some members to the group.
myContactGroup.Members.Add(new GroupMember("sadie@contoso.com"));
myContactGroup.Members.Add(new GroupMember("alfred@contoso.com"));
// Save the group.
myContactGroup.Save();

Créer un groupe de contacts à l’aide d’EWS

Cela peut prendre quelques lignes de code supplémentaires, mais vous pouvez créer un groupe de contacts à l’aide de l’opération CreateItem EWS. L’exemple de requête XML suivant montre comment créer un groupe de contacts. Il s’agit également de la requête XML qui est envoyée lorsque vous utilisez l’API managée EWS pour créer un groupe de contacts.

<?xml version="1.0" encoding="utf-8"?>
   <CreateItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages" 
MessageDisposition="SaveOnly">
      <Items xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
         <DistributionList xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
            <DisplayName xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
               My Contact Group
            </DisplayName>
            <Members xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
               <Member xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                  <Mailbox xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                     <EmailAddress xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                        sadie@contoso.com
                     </EmailAddress>
                  </Mailbox>
               </Member>
               <Member xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                  <Mailbox xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                     <EmailAddress xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                        alfred@contoso.com
                     </EmailAddress>
                  </Mailbox>
               </Member>
            </Members>
         </DistributionList>
      </Items>
   </CreateItem>

Voici un exemple de réponse XML réussie à la requête. Notez que les valeurs retournées incluent un ID d’élément pour le nouveau groupe de contacts et une clé de modification que vous pouvez utiliser dans un autre code pour modifier le groupe de contacts ou développer le groupe pour afficher les membres. L’ID d’élément est raccourci pour plus de lisibilité.

<?xml version="1.0" encoding="utf-8"?>
   <CreateItemResponse xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessages xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <CreateItemResponseMessage ResponseClass="Success" 
             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
            <ResponseCode xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
               NoError
            </ResponseCode>
            <Items xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
               <DistributionList xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
                  <ItemId xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                          Id="AAMkADBlY…" 
                          ChangeKey="EgAAABYAAAAD7hO1SJPWTbICFWZ4U3NMAABXzQiK" />
               </DistributionList>
            </Items>
         </CreateItemResponseMessage>
      </ResponseMessages>
   </CreateItemResponse>

Voir aussi