Exchange 中 EWS 和其他 Web 服务的新增功能
了解 Exchange 和 EWS 托管 API 中的 EWS 和 Web 服务中的新增功能。
Exchange 中的 Web 服务已更新为包含新功能。
表 1. Exchange Online、Exchange 2013 和 EWS 托管 API 中的新 Web 服务功能
| 功能 | 在 Exchange Online 中实现 | 在 Exchange 2013 中实现 | 在 EWS 托管 API 中实现 |
|---|---|---|---|
| 电子数据展示 |
是 |
是 |
是 |
| 存档 |
是 |
是 |
是 |
| Personas |
是 |
是 |
否 |
| 统一联系人存储 |
是 |
是 |
否 |
| 保留策略 |
是 |
是 |
是 |
| 用户照片 |
是 |
是 |
否 |
| 用于 Outlook 管理的邮件应用 |
是 |
是 |
是 |
| 建议新的会议时间 |
是 |
否 |
否 |
EWS 中的电子数据展示
电子数据展示是一种联合查询 Web 服务，它使外部应用程序（如 SharePoint 2013）能够执行 Exchange 数据的查询。 发现由几个阶段组成，包括识别和保留关键数据、剔除和审查数据，以及在法庭上生成数据。 电子数据展示查询通过跨 Exchange 和 SharePoint 提供单个发现工作流来促进发现过程。
表 2. 用于处理电子数据展示的 EWS 操作和 EWS 托管 API 方法
| 操作名称 | EWS 托管 API 方法 | 说明 |
|---|---|---|
| GetDiscoverySearchConfiguration 操作 |
ExchangeService.GetDiscoverySearchConfiguration () |
获取就地保留、保存的发现搜索以及启用发现搜索的邮箱的配置信息。 |
| GetHoldOnMailboxes 操作 |
ExchangeService.GetHoldOnMailboxes () |
获取使用 SetHoldOnMailboxes 操作设置的基于查询的保留的状态。 |
| GetNonIndexableItemDetails 操作 |
ExchangeService.GetNonIndexableItemDetails () |
获取有关无法编制索引的项的详细信息。 这包括（但不限于）项标识符、错误代码、错误说明、尝试为项编制索引时以及有关该项的其他信息。 |
| GetNonIndexableItemStatistics 操作 |
ExchangeService.GetNonIndexableItemStatistics () |
获取邮箱中无法编制索引的项目计数。 |
| GetSearchableMailboxes 操作 |
ExchangeService.GetSearchableMailboxes () |
获取客户端有权搜索或对其执行电子数据展示的邮箱的列表。 |
| SearchMailboxes 操作 |
ExchangeService.SearchMailboxes () |
搜索特定邮箱中与查询关键字匹配的项目。 |
| SetHoldOnMailboxes 操作 |
ExchangeService.SetHoldOnMailboxes () |
对项设置基于查询的保留。 |
EWS 中的存档
存档邮箱是与用户关联的辅助邮箱。 存档邮箱通常用于管理电子邮件存储限制。 例如，较旧的电子邮件项目可能会定期从收件箱移动到存档邮箱。
Exchange 引入了两个新的 EWS 操作，可用于存档主邮箱中的一组邮件项目。 以这种方式存档收件箱项目会保留项目的文件夹层次结构。 此外，现在可以使用文件夹路径指向存档内容，将存档邮箱存储在客户端本地或远程存储，其方式对用户大多不透明。
表 3. 用于处理存档的 EWS 操作和 EWS 托管 API 方法
| 操作名称 | EWS 托管 API 方法 | 说明 |
|---|---|---|
| ArchiveItem 操作 |
ExchangeService.ArchiveItems () |
将项目从主邮箱移动到存档邮箱。 |
| CreateFolderPath 操作 |
未实现。 |
在主邮箱或存档邮箱中创建文件夹层次结构。 |
EWS 中的角色
角色是与个人关联的数据的集合。 数据可以来自一个或多个源，并通过通用链接 ID 与角色相关联。 EWS 中的角色可用于链接、搜索、浏览和检索来自多个源的人员的信息，并将该信息组织到单个逻辑实体中。 角色与联系人的不同之处在于，联系人是来自与个人关联的单个源的数据的集合;例如，个人 Outlook 联系人或全局地址列表中的条目 (GAL) 。
EWS 托管 API 无法实现此功能。
注意
统一联系人存储还通过支持该功能的操作公开角色功能。
表 4. 用于处理角色的 EWS 操作
| 操作名称 | 说明 |
|---|---|
| FindPeople 操作 |
返回指定联系人文件夹中的所有角色对象，或检索与指定查询字符串匹配的所有联系人。 |
| GetPersona 操作 |
检索角色。 |
EWS 中的统一联系人存储
统一联系人存储是一项功能，可跨 Office 产品提供一致的联系人体验，并充当第三方应用程序使用同一联系人存储的集成点。 它允许用户和应用程序存储、管理和访问联系人信息，并使其在 Lync、Exchange 2013、Outlook Outlook Web App 以及实现对统一联系人存储的访问的任何其他应用程序之间全局可用。 Exchange 是统一联系人存储体验的联系人存储。
EWS 托管 API 无法实现此功能。
表 5. 使用统一联系人存储的 EWS 操作
| 操作名称 | 说明 |
|---|---|
| AddNewImContactToGroup 操作 |
将新的 IM 联系人添加到组。 统一联系人存储最多可包含 1000 个联系人。 |
| AddImContactToGroup 操作 |
将现有 IM 联系人添加到组。 统一联系人存储最多可包含 1000 个联系人。 |
| AddImGroup 操作 |
添加新的 IM 组。 统一联系人存储最多可包含 64 个组。 |
| AddNewTelUriContactToGroup 操作 |
根据联系人的电话号码将新联系人添加到组。 |
| AddDistributionGroupToImList 操作 |
添加新的通讯组列表组。 统一联系人存储最多可包含 64 个组。 |
| GetImItemList 操作 |
检索 IM 组和 IM 联系人角色的列表。 |
| GetImItems 操作 |
检索有关指定 IM 组和 IM 联系人角色的信息。 |
| RemoveContactFromImList 操作 |
从所有 IM 组中删除指定的联系人。 |
| RemoveImContactFromGroup 操作 |
从组中删除 IM 联系人。 |
| RemoveDistributionGroupFromImList 操作 |
删除指定的 IM 通讯组列表组。 |
| RemoveImGroup 操作 |
删除指定的 IM 组。 |
| SetImGroup 操作 |
更改组的显示名称。 |
EWS 中的保留策略
保留策略是在 Exchange 中用于对一个或多个保留标记进行分组、将保留设置应用于文件夹或单个项目（如电子邮件和语音邮件）以及将保留设置应用于邮箱的策略。
Exchange 包括三种类型的保留标记：
应用于未应用其他类型的保留标记的邮箱项目的默认策略标记。
应用于默认文件夹（如收件箱）的系统文件夹策略标记。
用户可应用于其创建的文件夹或单个项的个人标记。
只能将一个保留策略分配给邮箱，但该策略可以有一个或多个各种类型的保留标记链接到邮箱。 保留标记可以随时链接到保留策略或取消与保留策略的链接。 Exchange 中的 EWS 公开了一个新操作 GetUserRetentionPolicyTags，EWS 托管 API 实现了一个新方法 ExchangeService.GetUserRetentionPolicyTags () ，该方法提供链接到保留策略的所有标记的列表。 可以使用 CreateItem、 CreateFolder、 UpdateItem、 UpdateFolder、 GetItem 和 GetFolder 操作设置和检索项目和文件夹的保留策略标记。
请求用户照片
可以使用 GetUserPhoto 操作的两个实现之一从 Exchange 服务器请求用户照片： REST 或 SOAP。 REST 终结点使用标准 HTTPS GET 请求来获取用户照片。 该服务将返回存储在 Exchange 中的用户照片或来自 Active Directory 域服务 (AD DS) 的照片。
EWS 托管 API 无法实现此功能。 但是，可以通过获取附加到联系人的照片，使用 EWS 托管 API 返回存储在邮箱中的用户照片。
在 EWS 中阻止发件人并将电子邮件标记为垃圾邮件
现在，可以使用 EWS 中的新 MarkAsJunk 操作 或 EWS 托管 API 中的 ExchangeService.MarkAsJunk () 方法阻止发件人并将电子邮件标记为垃圾邮件。
Outlook 邮件应用程序
EWS 现在支持管理 Outlook 的邮件应用。
表 6. 用于处理 Outlook 邮件应用的 EWS 操作和 EWS 托管 API 方法
| 操作名称 | EWS 托管 API 方法 | 说明 |
|---|---|---|
| DisableApp 操作 |
ExchangeService.DisableApp () |
禁用已安装的应用。 |
| GetAppManifests 操作 |
ExchangeService.GetAppManifests () |
获取邮箱的应用清单。 |
| GetAppMarketplaceUrl 操作 |
ExchangeService.GetAppMarketplaceUrl () |
获取应用市场 URL。 |
| GetClientAccessToken 操作 |
ExchangeService.GetClientAccessToken () |
获取客户端访问令牌。 |
| InstallApp 操作 |
ExchangeService.InstallApp () |
为邮箱安装应用。 |
| UninstallApp 操作 |
ExchangeService.UninstallApp |
从邮箱卸载应用。 |
建议新的会议时间
Exchange 版本 15.00.0800.007 中引入了建议的新时间功能。 这允许与会者向会议组织者 建议新的会议时间 。
EWS 托管 API 无法实现此功能。