Compartilhar via

Criar grupos de contatos usando o EWS no Exchange

  • Artigo

Saiba como criar um grupo de contatos usando a API Gerenciada do EWS ou o EWS no Exchange.

Você pode criar um grupo de contatos, que é um grupo de distribuição privado, usando a API Gerenciada do EWS ou o EWS. Para criar grupos de contatos, use os métodos na classe API Gerenciada do ContactGroup EWS ou use a operação CreateItem EWS.

Observe que você não pode usar a API Gerenciada do EWS ou o EWS para criar um grupo de distribuição universal ou um grupo de segurança. Para criar um grupo de distribuição universal ou um grupo de segurança, você pode usar o cmdlet Shell do Exchange Management do New-DistributionGroup.

Criar um grupo de contatos usando a API Gerenciada do EWS

Para criar um grupo de contatos, você só precisa de algumas informações: um nome para o grupo e os membros a serem adicionados ao grupo. O exemplo a seguir mostra como criar um grupo de contatos simples que contém alguns membros do grupo.

// 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();

Criar um grupo de contatos usando o EWS

Pode levar mais algumas linhas de código, mas você pode criar um grupo de contatos usando a operação CreateItem EWS. O exemplo de solicitação XML a seguir mostra como você pode criar um grupo de contatos. Essa também é a solicitação XML enviada quando você usa a API Gerenciada do EWS para criar um grupo de contatos.

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

A seguir está um exemplo de uma resposta XML bem-sucedida à solicitação. Observe que os valores retornados incluem uma ID de item para o novo grupo de contatos e uma chave de alteração que você pode usar em outro código para modificar o grupo de contatos ou expandir o grupo para ver os membros. A ID do item é abreviada para legibilidade.

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

Confira também