Exchange 中的 EWS 和其他 web 服务中的新增功能What's new in EWS and other web services in Exchange

了解在 Exchange 和 EWS 托管 API 中的 EWS 和 web 服务中的新增功能。Find out what's new in EWS and web services in Exchange and the EWS Managed API.

Exchange 中的 Web 服务已更新,以包含新功能。Web services in Exchange have been updated to include new features.

表1。Exchange Online 中的新 web 服务功能、Exchange 2013 和 EWS 托管 APITable 1. New web service features in Exchange Online, Exchange 2013, and the EWS Managed API

功能Feature 在 Exchange Online 中实施Implemented in Exchange Online 在 Exchange 2013 中实施Implemented in Exchange 2013 在 EWS 托管 API 中实现Implemented in the EWS Managed API
统一联系人存储Unified Contact Store
保留策略Retention policies
用户照片User photos
Outlook 相关邮件应用程序管理Mail apps for Outlook management
建议新会议时间Propose new meeting time

EWS 中的电子数据展示eDiscovery in EWS

电子数据展示是一种联合查询 web 服务,它使外部应用程序(如 SharePoint 2013)能够执行 Exchange 数据的查询。eDiscovery is a federated query web service that enables external applications, such as SharePoint 2013, to perform queries of Exchange data. 发现包括几个阶段,包括标识和保留关键数据、在法庭中剔除和查看数据以及生成数据。Discovery consists of several phases, including identifying and preserving key data, culling down and reviewing the data, and producing data in court. 电子数据展示查询通过跨 Exchange 和 SharePoint 提供单个发现工作流来促进发现过程。eDiscovery queries facilitate the discovery process by providing a single discovery workflow across Exchange and SharePoint.

表2。用于处理电子数据展示的 EWS 操作和 EWS 托管 API 方法Table 2. EWS operations and EWS Managed API methods for working with eDiscovery

操作名称Operation name EWS 托管的 API 方法EWS Managed API method 说明Description
GetDiscoverySearchConfiguration 操作GetDiscoverySearchConfiguration operation
ExchangeService GetDiscoverySearchConfiguration ()ExchangeService.GetDiscoverySearchConfiguration()
获取就地保留的配置信息、已保存的发现搜索以及为发现搜索启用的邮箱。Gets configuration information for in-place holds, saved discovery searches, and the mailboxes that are enabled for discovery search.
GetHoldOnMailboxes 操作GetHoldOnMailboxes operation
ExchangeService GetHoldOnMailboxes ()ExchangeService.GetHoldOnMailboxes()
获取基于查询的保留的状态,它是通过使用SetHoldOnMailboxes操作设置的。Gets the status of a query-based hold, which is set by using the SetHoldOnMailboxes operation.
GetNonIndexableItemDetails 操作GetNonIndexableItemDetails operation
ExchangeService GetNonIndexableItemDetails ()ExchangeService.GetNonIndexableItemDetails()
获取有关无法编制索引的项目的详细信息。Gets details about items that cannot be indexed. 这包括但不限于项目标识符、错误代码、错误说明、对项目编制索引时,以及有关项目的其他信息。This includes, but is not limited to, the item identifier, an error code, an error description, when an attempt was made to index the item, and additional information about the item.
GetNonIndexableItemStatistics 操作GetNonIndexableItemStatistics operation
ExchangeService GetNonIndexableItemStatistics ()ExchangeService.GetNonIndexableItemStatistics()
获取邮箱中无法编制索引的项的计数。Gets the count of items that cannot be indexed in a mailbox.
GetSearchableMailboxes 操作GetSearchableMailboxes operation
ExchangeService GetSearchableMailboxes ()ExchangeService.GetSearchableMailboxes()
获取客户端有权搜索或执行电子数据展示的邮箱的列表。Gets a list of mailboxes that the client has permission to search or perform eDiscovery on.
SearchMailboxes 操作SearchMailboxes operation
ExchangeService SearchMailboxes ()ExchangeService.SearchMailboxes()
搜索与查询关键字匹配的特定邮箱中的项目。Searches for items in specific mailboxes that match query keywords.
SetHoldOnMailboxes 操作SetHoldOnMailboxes operation
ExchangeService SetHoldOnMailboxes ()ExchangeService.SetHoldOnMailboxes()
设置项目的基于查询的保留。Sets a query-based hold on items.

在 EWS 中存档Archiving in EWS

存档邮箱是与用户相关联的辅助邮箱。Archive mailboxes are secondary mailboxes that are associated with a user. 存档邮箱通常用于管理电子邮件存储限制。Archive mailboxes are typically used to manage email storage limits. 例如,较旧的电子邮件项目可能会定期从收件箱移动到存档邮箱。For example, older email items might periodically be moved from the Inbox to the archive mailbox.

Exchange 引入了两种新的 EWS 操作,可用于存档主邮箱中的一组邮件项目。Exchange introduces two new EWS operations that you can use to archive a set of mail items from a primary mailbox. 以这种方式存档收件箱项目可保留项目的文件夹层次结构。Archiving Inbox items in this way preserves the folder hierarchy of the items. 此外,存档邮箱现在可以本地存储在客户端上,也可以远程存储为用户对用户不透明的方式,方法是使用文件夹路径指向存档的内容。In addition, archive mailboxes can now be stored either locally on a client, or remotely, in a way that is mostly opaque to a user, by using a folder path to point to the contents of the archive.

表3。用于处理存档的 EWS 操作和 EWS 托管 API 方法Table 3. EWS operations and EWS Managed API methods for working with archiving

操作名称Operation name EWS 托管的 API 方法EWS Managed API method 说明Description
ArchiveItem 操作ArchiveItem operation
ExchangeService ArchiveItems ()ExchangeService.ArchiveItems()
将项目从主邮箱移动到存档邮箱。Moves an item from the primary mailbox to the archive mailbox.
CreateFolderPath 操作CreateFolderPath operation
未实现。Not implemented.
在主邮箱或存档邮箱中创建文件夹层次结构。Creates a folder hierarchy in a primary or archive mailbox.

EWS 中的角色Personas in EWS

角色是与个人相关联的数据的集合。A persona is a collection of data that is associated with an individual. 数据可以来自一个或多个源,并通过通用链接 ID 与角色相关联。The data can come from one or more sources and is associated with the persona by means of a common link ID. 通过 EWS 中的角色,可以从多个源中链接、搜索、浏览和检索有关人员的信息,并将该信息组织到一个逻辑实体中。Personas in EWS enable you to link, search, browse, and retrieve information about a person from multiple sources and organize that information into a single logical entity. 角色与联系人的不同之处在于,联系人是与个人相关联的单个源中的数据集合;例如,个人 Outlook 联系人或全局地址列表(GAL)中的条目。Personas differ from contacts in that a contact is a collection of data from a single source that is associated with an individual; for example, a personal Outlook contact or an entry in a global address list (GAL).

EWS 托管 API 无法实现此功能。The EWS Managed API does not implement this functionality.


统一联系人存储区还通过支持该功能的操作公开了角色功能。The Unified Contact Store also exposes persona functionality by means of the operations that support that feature.

表4。用于处理角色的 EWS 操作Table 4. EWS operations for working with personas

操作名称Operation name 说明Description
FindPeople 操作FindPeople operation
返回指定的联系人文件夹中的所有 persona 对象,或检索与指定的查询字符串匹配的所有联系人。Returns all persona objects from a specified contact folder or retrieves all contacts that match a specified query string.
GetPersona 操作GetPersona operation
检索角色。Retrieves a persona.

EWS 中的统一联系人存储Unified Contact Store in EWS

统一联系人存储是一项功能,可跨 Office 产品提供一致的联系人体验,并充当第三方应用程序使用相同的联系人存储的集成点。The Unified Contact Store is a feature that provides a consistent contact experience across Office products and acts as an integration point for third-party applications to use the same contact store. 它允许用户和应用程序存储、管理和访问联系人信息,并使其在 Lync、Exchange 2013、Outlook、Outlook Web App 和任何其他实现对统一联系人存储的访问权限的应用程序之间全局可用。It allows users and applications to store, manage, and access contact information and make it available globally among Lync, Exchange 2013, Outlook, Outlook Web App and any other application that implements access to the Unified Contact Store. Exchange 是统一联系人存储区体验的联系人存储区。Exchange is the contact store for the Unified Contact Store experience.

EWS 托管 API 无法实现此功能。The EWS Managed API does not implement this functionality.

表5。使用统一联系人存储区的 EWS 操作Table 5. EWS operations for working with the Unified Contact Store

操作名称Operation name 说明Description
AddNewImContactToGroup 操作AddNewImContactToGroup operation
将新的 IM 联系人添加到组中。Adds a new IM contact to a group. 统一联系人存储最多可以包含1000个联系人。The Unified Contact Store can contain a maximum of 1000 contacts.
AddImContactToGroup 操作AddImContactToGroup operation
将现有 IM 联系人添加到组中。Adds an existing IM contact to a group. 统一联系人存储最多可以包含1000个联系人。The Unified Contact Store can contain a maximum of 1000 contacts.
AddImGroup 操作AddImGroup operation
添加新的 IM 组。Adds a new IM group. 统一联系人存储最多可包含64个组。The Unified Contact Store can contain a maximum of 64 groups.
AddNewTelUriContactToGroup 操作AddNewTelUriContactToGroup operation
根据联系人的电话号码将新联系人添加到组中。Adds a new contact to a group based on a contact's phone number.
AddDistributionGroupToImList 操作AddDistributionGroupToImList operation
添加新的通讯组列表组。Adds a new distribution list group. 统一联系人存储最多可包含64个组。The Unified Contact Store can contain a maximum of 64 groups.
GetImItemList 操作GetImItemList operation
检索 IM 组和 IM 联系人角色的列表。Retrieves a list of IM groups and IM contact personas.
GetImItems 操作GetImItems operation
检索有关指定的 IM 组和 IM 联系人角色的信息。Retrieves information about the specified IM groups and IM contact personas.
RemoveContactFromImList 操作RemoveContactFromImList operation
从所有 IM 组中删除指定的联系人。Removes the specified contact from all IM groups.
RemoveImContactFromGroup 操作RemoveImContactFromGroup operation
从组中删除 IM 联系人。Removes an IM contact from a group.
RemoveDistributionGroupFromImList 操作RemoveDistributionGroupFromImList operation
删除指定的 IM 通讯组列表组。Removes the specified IM distribution list group.
RemoveImGroup 操作RemoveImGroup operation
删除指定的 IM 组。Removes the specified IM group.
SetImGroup 操作SetImGroup operation
更改组的显示名称。Changes the display name of a group.

EWS 中的保留策略Retention policies in EWS

保留策略是 Exchange 中用于对一个或多个保留标记进行分组的策略,用于将保留设置应用于文件夹或单个项目(如电子邮件和语音邮件),并将保留设置应用于邮箱。Retention policies are policies that are used in Exchange to group one or more retention tags, to apply retention settings to folders or individual items such as email and voice mail messages, and to apply retention settings to a mailbox.

Exchange 包括三种类型的保留标记:Exchange includes three types of retention tags:

  • 应用于未应用其他类型的保留标记的邮箱项目的默认策略标记。Default policy tags that apply to mailbox items that have no other type of retention tag applied.

  • 应用于默认文件夹(如收件箱)的系统文件夹策略标记。System folder policy tags that are applied to default folders such as the Inbox.

  • 用户可应用于他们创建的文件夹或单个项目的个人标记。Personal tags that a user can apply to folders they create or to individual items.

只有一个保留策略可分配给一个邮箱,但策略可以有一个或多个链接到它的不同类型的保留标记。Only one retention policy can be assigned to a mailbox, but the policy can have one or more retention tags of various types linked to it. 可以随时将保留标记链接到保留策略或从保留策略中取消链接。Retention tags can be linked to or unlinked from a retention policy at any time. Exchange 中的 EWS 公开新操作、 GetUserRetentionPolicyTags和 EWS 托管 API 实现一个新的方法ExchangeService (),该方法提供链接到保留策略的所有标记的列表。EWS in Exchange exposes a new operation, GetUserRetentionPolicyTags, and the EWS Managed API implements a new method, ExchangeService.GetUserRetentionPolicyTags(), that provides a list of all the tags that are linked to a retention policy. 您可以使用CreateItemCreateFolderUpdateItemUpdateFolderGetItemGetFolder操作来设置和检索项目和文件夹的保留策略标记。You can set and retrieve retention policy tags for items and folders by using the CreateItem, CreateFolder, UpdateItem, UpdateFolder, GetItem, and GetFolder operations.

请求用户照片Requesting user photos

您可以使用GetUserPhoto 操作的两个实现中的一种实现,从 Exchange 服务器请求用户照片: REST或 SOAP。You can request user photos from the Exchange server by using one of the two implementations of the GetUserPhoto operation: REST or SOAP. REST 终结点使用标准 HTTPS get请求获取用户照片。The REST endpoint uses a standard HTTPS GET request to get the user photo. 服务将返回存储在 Exchange 中的用户照片或 Active Directory 域服务(AD DS)中的照片。The service will either return a user photo stored in Exchange or a photo from Active Directory Domain Services (AD DS).

EWS 托管 API 无法实现此功能。The EWS Managed API does not implement this functionality. 但是,可以通过获取附加到联系人的照片,使用 EWS 托管 API 返回存储在邮箱中的用户照片。You can, however, use the EWS Managed API to return user photos that are stored in a mailbox by getting the photo that is attached to a contact.

阻止发件人并在 EWS 中将电子邮件标记为垃圾邮件Block senders and mark email as junk in EWS

您现在可以使用 EWS 中的新MarkAsJunk 操作或 EWS 托管 API 中的ExchangeService ()方法,阻止发件人并将电子邮件标记为垃圾邮件。You can now block senders and mark email as junk by using the new MarkAsJunk operation in EWS or the ExchangeService.MarkAsJunk() method in the EWS Managed API.

Outlook 邮件应用程序Mail apps for Outlook

EWS 现在支持对 Outlook 的邮件应用程序进行管理。EWS now includes support for managing mail apps for Outlook.

表6。使用适用于 Outlook 的邮件应用程序的 EWS 操作和 EWS 托管 API 方法Table 6. EWS operations and EWS Managed API methods for working with mail apps for Outlook

操作名称Operation name EWS 托管的 API 方法EWS Managed API method 说明Description
DisableApp 操作DisableApp operation
ExchangeService DisableApp ()ExchangeService.DisableApp()
禁用已安装的应用程序。Disables an installed app.
Getappmanifests 已操作GetAppManifests operation
ExchangeService Getappmanifests 已()ExchangeService.GetAppManifests()
获取邮箱的应用程序清单。Gets the app manifests for a mailbox.
GetAppMarketplaceUrl 操作GetAppMarketplaceUrl operation
ExchangeService GetAppMarketplaceUrl ()ExchangeService.GetAppMarketplaceUrl()
获取应用程序市场 URL。Gets the app marketplace URL.
GetClientAccessToken 操作GetClientAccessToken operation
ExchangeService GetClientAccessToken ()ExchangeService.GetClientAccessToken()
获取客户端访问令牌。Gets client access tokens.
InstallApp 操作InstallApp operation
ExchangeService InstallApp ()ExchangeService.InstallApp()
为邮箱安装应用程序。Installs an app for a mailbox.
UninstallApp 操作UninstallApp operation
ExchangeService。 UninstallAppExchangeService.UninstallApp
从邮箱中卸载应用程序。Uninstalls an app from a mailbox.

建议新会议时间Propose new meeting time

建议的新时间功能是在 Exchange 的15.00.0800.007 版本中引入的。The propose new time feature was introduced in version 15.00.0800.007 of Exchange. 这样,会议与会者就可以向会议组织者建议新的会议时间This allows meeting attendees to propose new meeting times to the meeting organizer.

EWS 托管 API 无法实现此功能。The EWS Managed API does not implement this functionality.

另请参阅See also