通过

在 Exchange 中使用 EWS 创建联系人组

  • 项目

了解如何使用 Exchange 中的 EWS 托管 API 或 EWS 创建联系人组。

可以使用 EWS 托管 API 或 EWS 创建联系人组，该组是专用 通讯组。 若要创建联系人组，请使用 ContactGroup EWS 托管 API 类中的方法，或使用 CreateItem EWS 操作。

请注意，不能使用 EWS 托管 API 或 EWS 创建通用通讯组或安全组。 若要创建通用通讯组或安全组，可以使用 New-DistributionGroupExchange 命令行管理程序 cmdlet。

使用 EWS 托管 API 创建联系人组

若要创建联系人组，只需几条信息：组的名称以及要添加到组的成员。 以下示例演示如何创建包含几个组成员的简单联系人组。

// 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 请求示例演示如何创建联系人组。 这也是 使用 EWS 托管 API 创建联系人组时发送的 XML 请求。

<?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 响应的示例。 请注意，返回的值包括新联系人组的项目 ID 和可在其他代码中用于修改联系人组或展开组以查看成员的更改键。 为了提高可读性，将缩短项目 ID。

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

另请参阅