Share via

Creación de grupos de contactos mediante EWS en Exchange

  • Artículo

Obtenga información sobre cómo crear un grupo de contactos mediante la API administrada de EWS o EWS en Exchange.

Puede crear un grupo de contactos, que es un grupo de distribución privado, mediante la API administrada de EWS o EWS. Para crear grupos de contactos, use los métodos de la clase De API administrada de EWS ContactGroup o use la operación CreateItem EWS.

Tenga en cuenta que no puede usar la API administrada de EWS ni EWS para crear un grupo de distribución universal o un grupo de seguridad. Para crear un grupo de distribución universal o un grupo de seguridad, puede usar el cmdlet New-DistributionGroupExchange Management Shell.

Creación de un grupo de contactos mediante la API administrada de EWS

Para crear un grupo de contactos, solo necesita un par de elementos de información: un nombre para el grupo y los miembros que se van a agregar al grupo. En el ejemplo siguiente se muestra cómo crear un grupo de contactos sencillo que contiene un par de miembros del 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();

Creación de un grupo de contactos mediante EWS

Puede que se necesiten algunas líneas de código más, pero puede crear un grupo de contactos mediante la operación EWS CreateItem . En el siguiente ejemplo de solicitud XML se muestra cómo crear un grupo de contactos. Esta es también la solicitud XML que se envía cuando se usa la API administrada de EWS para crear un grupo de contactos.

<?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>

A continuación se muestra un ejemplo de una respuesta XML correcta a la solicitud. Tenga en cuenta que los valores devueltos incluyen un identificador de elemento para el nuevo grupo de contactos y una clave de cambio que puede usar en otro código para modificar el grupo de contactos o expandir el grupo para ver los miembros. El identificador de elemento se acorta para mejorar la legibilidad.

<?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>

Vea también