Поделиться через

Как: создать группы контактов с помощью EWS в Exchange

  • Статья

Узнайте, как создать группу контактов с помощью управляемого API EWS или EWS в Exchange.

Вы можете создать группу контактов, которая является частной группой рассылки, с помощью управляемого API EWS или EWS. Чтобы создать группы контактов, используйте методы класса ContactGroup EWS Managed API или используйте операцию CreateItem EWS.

Обратите внимание, что вы не можете использовать управляемый API EWS или EWS для создания универсальной группы рассылки или группы безопасности. Чтобы создать универсальную группу рассылки или группу безопасности, можно использовать командлет Командлет Командной консоли ExchangeNew-DistributionGroup.

Создание группы контактов с помощью управляемого API EWS

Чтобы создать группу контактов, вам просто потребуется несколько фрагментов информации: имя группы и участники, которые нужно добавить в группу. В следующем примере показано, как создать простую группу контактов, содержащую пару членов группы.

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

Создание группы контактов с помощью EWS

Это может занять несколько строк кода, но вы можете создать группу контактов с помощью операции CreateItem EWS. В следующем примере XML-запроса показано, как создать группу контактов. Это также XML-запрос, который отправляется при использовании управляемого API EWS для создания группы контактов.

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

Ниже приведен пример успешного XML-ответа на запрос. Обратите внимание, что возвращаемые значения включают идентификатор элемента для новой группы контактов и ключ изменения, который можно использовать в другом коде, чтобы изменить группу контактов или развернуть группу, чтобы увидеть участников. Идентификатор элемента сокращается для удобства чтения.

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

См. также