查找有关 Exchange 中可用的 EWS 操作的信息。
Exchange Web 服务 (EWS) 提供了许多操作,使你能够从 Exchange 存储访问信息。 本节中的文章提供了有关 EWS 操作的请求、响应和错误响应消息的总体结构信息,以及每个操作的 XML 示例。 它们提供了客户端和服务器之间发送的消息结构概述。 可以使用此信息调试消息结构,并查找有关可以在 EWS 请求中可执行操作的信息。 有关 XML 结构所表示的详细信息,请参阅 - Exchange 中的 EWS XML 元素。
所有 EWS 功能都与架构的某个版本相关联。 Exchange Server 或 Exchange Online 的新版本中引入了新的 EWS 架构版本。 RequestServerVersion 元素包含 版本 属性,该属性将服务器版本映射到架构版本。 本文提供有关何时引入每项操作的信息。 操作中的特定功能可能需要更高版本的服务。 实现版本控制架构,以便针对较旧版本 EWS 设计的客户端可以使用较新版本的 EWS。
这些操作可以针对为邮箱提供服务的 EWS 终结点。 可以使用结构类似于 http:// clientaccessserver.com>/ews/exchange.asmx 的 URL 浏览到 EWS 终结点,其中 <clientaccessserver> 是为邮箱提供服务的 Exchange 客户端访问服务器。< 可以使用自动发现获取为邮箱提供服务的客户端访问服务器的 URL。 有关自动发现的详细信息,请参阅 Exchange 的自动发现。
电子数据展示操作
电子数据展示操作提供合法保留的搜索操作,并标识无法在发现搜索结果中编制索引和返回的邮箱数据。
下表列出了电子数据展示操作。
| 操作名称 | 引入版本 |
|---|---|
| GetDiscoverySearchConfiguration 操作 |
Exchange 2013 |
| GetHoldOnMailboxes 操作 |
Exchange 2013 |
| GetNonIndexableItemDetails 操作 |
Exchange 2013 |
| GetNonIndexableItemStatistics 操作 |
Exchange 2013 |
| GetSearchableMailboxes 操作 |
Exchange 2013 |
| SearchMailboxes 操作 |
Exchange 2013 |
| SetHoldOnMailboxes 操作 |
Exchange 2013 |
Exchange 邮箱数据操作
Exchange 邮箱数据操作使客户端能够处理和组织项目、文件夹和附件,以及不明确的名称解析和通讯组列表扩展。 Exchange 邮箱数据操作包括项目、文件夹、附件和实用程序操作。
下表列出了 Exchange 邮箱数据操作。
| 操作名称 | 引入版本 |
|---|---|
| ArchiveItem 操作 |
Exchange 2013 |
| CreateItem 操作 |
Exchange 2007 |
| CopyItem 操作 |
Exchange 2007 |
| DeleteItem 操作 |
Exchange 2007 |
| FindItem 操作 |
Exchange 2007 |
| GetItem 操作 |
Exchange 2007 |
| MarkAllItemsAsRead 操作 |
Exchange 2013 |
| MoveItem 操作 |
Exchange 2007 |
| SendItem 操作 |
Exchange 2007 |
| UpdateItem 操作 |
Exchange 2007 |
下表列出了 Exchange 邮箱数据文件夹操作。
| 操作名称 | 引入版本 |
|---|---|
| CreateFolder 操作 |
Exchange 2007 |
| CreateFolderPath 操作 |
Exchange 2013 |
| CreateManagedFolder 操作 |
Exchange 2007。 从 Exchange 2010 开始,此功能已取消在 Exchange 版本中强调。 有关如何迁移到使用保留标记和策略进行消息传递记录管理的详细信息,请参阅 从托管文件夹迁移。 |
| CopyFolder 操作 |
Exchange 2007 |
| DeleteFolder 操作 |
Exchange 2007 |
| EmptyFolder 操作 |
Exchange 2010 |
| FindFolder 操作 |
Exchange 2007 |
| GetFolder 操作 |
Exchange 2007 |
| MoveFolder 操作 |
Exchange 2007 |
| UpdateFolder 操作 |
Exchange 2007 |
下表列出了 Exchange 邮箱数据附件操作。
| 操作名称 | 引入版本 |
|---|---|
| CreateAttachment 操作 |
Exchange 2007 |
| GetAttachment 操作 |
Exchange 2007 |
| DeleteAttachment 操作 |
Exchange 2007 |
下表列出了 Exchange 邮箱提醒操作。
| 操作名称 | 引入版本 |
|---|---|
| GetReminders 操作 |
Exchange 2013 |
| PerformReminderAction 操作 |
Exchange 2013 |
下表列出了 Exchange 邮箱数据会话操作。
| 操作名称 | 引入版本 |
|---|---|
| ApplyConversationAction 操作 |
Exchange 2010 Service Pack 1 (SP1) |
| FindConversation 操作 |
Exchange 2010 SP1 |
| GetConversationItems 操作 |
Exchange 2013 |
下表列出了 Exchange 邮箱数据实用程序操作。
| 操作名称 | 引入版本 |
|---|---|
| ConvertId 操作 |
Exchange 2007 Service Pack 1 |
| ExpandDL 操作 |
Exchange 2007 |
| GetUserPhoto 操作 |
Exchange 2013。 此操作同时具有 REST 和 SOAP 实现。 |
| MarkAsJunk 操作 |
Exchange 2013 |
| ResolveNames 操作 |
Exchange 2007 |
| GetPasswordExpirationDate 操作 |
Exchange 2010 SP1 |
可用性操作
可用性操作通过提供更安全、最新的和丰富的闲/忙信息来改善日历和闲/忙共享体验。 闲/忙数据是安排会议的关键组成部分。 可用性操作为有效计划提供了可靠的基础。
下表列出了可用性操作。
| 操作名称 | 引入版本 |
|---|---|
| GetUserAvailability 操作 |
Exchange 2007 |
| GetRoomLists 操作 |
Exchange 2010 |
| GetRooms 操作 |
Exchange 2010 |
| GetUserOofSettings 操作 |
Exchange 2007 |
| SetUserOofSettings 操作 |
Exchange 2007 |
批量传输操作
通过批量传输操作使客户端可以将项目流式传入和传出到邮箱。
下表列出了批量传输操作。
| 操作名称 | 引入版本 |
|---|---|
| UploadItems 操作 |
Exchange 2010 SP1 |
| ExportItems 操作 |
Exchange 2010 SP1 |
代理管理操作
代理管理操作使客户端能够从其邮箱中添加、获取、更新和删除代理。
下表列出了代理管理操作。
| 操作名称 | 引入版本 |
|---|---|
| AddDelegate 操作 |
Exchange 2007 Service Pack 1 (SP1) |
| GetDelegate 操作 |
Exchange 2007 SP1 |
| UpdateDelegate 操作 |
Exchange 2007 SP1 |
| RemoveDelegate 操作 |
Exchange 2007 SP1 |
收件箱规则操作
收件箱规则操作使客户端能够获取收件箱规则,并针对服务器上的邮件对其进行更新。 收件箱规则是一组条件和关联操作,使客户端能够在邮件传递到文件夹时自动组织、分类和操作邮件。
下表列出了收件箱规则操作。
| 操作名称 | 引入版本 |
|---|---|
| GetInboxRules 操作 |
Exchange 2010 SP1 |
| UpdateInboxRules 操作 |
Exchange 2010 SP1 |
邮件应用管理操作
通过邮件应用管理操作,可以管理 Outlook 的邮件应用。 可以使用这些操作来安装、卸载、禁用和获取有关 Outlook Web App 和 Outlook 2013 可用的邮件应用的信息。
下表列出了邮件应用管理操作。
| 操作名称 | 引入版本 |
|---|---|
| DisableApp 操作 |
Exchange 2013 |
| GetAppManifests 操作 |
Exchange 2013 |
| GetAppMarketplaceUrl 操作 |
Exchange 2013 |
| GetClientAccessToken 操作 |
Exchange 2013 |
| InstallApp 操作 |
Exchange 2013 |
| UninstallApp 操作 |
Exchange 2013 |
邮件提示操作
邮件提示操作使客户端能够在作者撰写邮件时向服务器请求有关收件人邮箱的信息。 下表列出了邮件提示操作。
| 操作名称 | 引入版本 |
|---|---|
| GetMailTips 操作 |
Exchange 2010 |
邮件跟踪操作
通过邮件跟踪操作,客户端可以查找符合指定条件的邮件,并在邮件跟踪报告中获取有关每条消息的详细跟踪信息。
下表列出了邮件跟踪操作。
| 操作名称 | 引入版本 |
|---|---|
| FindMessageTrackingReport 操作 |
Exchange 2010 |
| GetMessageTrackingReport 操作 |
Exchange 2010 |
通知操作
通知操作会通知与指定邮箱项目和文件夹相关联事件的客户端应用程序。 订阅模型可以是基于推送的、基于拉取的或基于流式处理的。
下表列出了通知操作。
| 操作名称 | 引入版本 |
|---|---|
| GetEvents 操作 |
Exchange 2007 |
| GetStreamingEvents 操作 |
Exchange 2010 SP1 |
| 订阅操作 |
Exchange 2007 |
| Unsubscribe 操作 |
Exchange 2007 |
角色操作
角色操作提供了一个用于查找和获取有关链接联系人信息的接口。 下表列出了角色操作。
| 操作名称 | 引入版本 |
|---|---|
| FindPeople 操作 |
Exchange 2013 |
| GetPersona 操作 |
Exchange 2013 |
保留策略操作
保留策略操作提供链接到用户保留策略的所有保留标记列表。
下表列出了保留策略操作。
| 操作名称 | 引入版本 |
|---|---|
| GetUserRetentionPolicyTags 操作 |
Exchange 2013 |
服务配置操作
通过服务配置操作,客户端可以获取统一消息、保护规则、策略提示和邮件提示服务的配置信息。
下表列出了服务配置操作。
| 操作名称 | 引入版本 |
|---|---|
| GetServiceConfiguration 操作 |
Exchange 2010 |
共享操作
共享操作使客户端能够共享日历数据和联系人数据。
下表列出了共享操作。
| 操作名称 | 引入版本 |
|---|---|
| CreateItem (AcceptSharingInvitation) |
Exchange 2010。 尽管 CreateItem 操作适用于所有版本的 EWS,但 AcceptSharingInvitation 响应对象仅适用于从 Exchange 2010 开始的版本的 EWS。 |
| GetSharingFolder 操作 |
Exchange 2010 |
| GetSharingMetadata 操作 |
Exchange 2010 |
| RefreshSharingFolder 操作 |
Exchange 2010 |
同步操作
同步操作为用户的文件夹和项目提供了单向的同步缓存副本。
下表列出了同步操作。
| 操作名称 | 引入版本 |
|---|---|
| SyncFolderHierarchy 操作 |
Exchange 2007 |
| SyncFolderItems 操作 |
Exchange 2007 |
时区操作
时区操作使客户端能够获取服务器所支持的时区定义列表。
下表列出了时区操作。
| 操作名称 | 引入版本 |
|---|---|
| GetServerTimeZones 操作 |
Exchange 2010 |
统一消息操作
统一消息操作使客户端能够读取有关统一消息属性的信息,并通过手机播放语音邮件。
下表列出了统一消息操作。
| 操作名称 | 引入版本 |
|---|---|
| DisconnectPhoneCall 操作 |
Exchange 2010 |
| GetPhoneCallInformation 操作 |
Exchange 2010 |
| PlayOnPhone 操作 (EWS) |
Exchange 2010 |
使用 GetServiceConfiguration 操作 以获取邮箱的统一消息配置信息。 对于针对 Exchange 2007 的统一消息应用程序,使用统一消息 Web 服务。 更多相关信息,请参阅 Exchange 的统一消息 Web 服务参考。
统一联系人存储操作
统一联系人存储跨 Office 产品提供一致的联系人体验,并作为第三方应用程序的集成店使用相同的联系人存储。 它使用户和应用程序能够存储、管理和访问联系人信息,并使其在 Lync、Exchange 2013、Outlook、Outlook Web App 和任何其他实现统一联系人存储访问权限的应用程序中全局可用。 Exchange 是统一联系人存储体验的内容存储。
下表列出了统一联系人存储操作。
| 操作名称 | 引入版本 |
|---|---|
| AddNewImContactToGroup 操作 |
Exchange 2013 |
| AddImContactToGroup 操作 |
Exchange 2013 |
| AddImGroup 操作 |
Exchange 2013 |
| AddNewTelUriContactToGroup 操作 |
Exchange 2013 |
| AddDistributionGroupToImList 操作 |
Exchange 2013 |
| GetImItemList 操作 |
Exchange 2013 |
| GetImItems 操作 |
Exchange 2013 |
| RemoveContactFromImList 操作 |
Exchange 2013 |
| RemoveImContactFromGroup 操作 |
Exchange 2013 |
| RemoveDistributionGroupFromImList 操作 |
Exchange 2013 |
| RemoveImGroup 操作 |
Exchange 2013 |
| SetImGroup 操作 |
Exchange 2013 |
用户配置操作
用户配置操作使客户端能够创建、删除、获取和更新用户配置信息。
下表列出了用户配置操作。
| 操作名称 | 引入版本 |
|---|---|
| CreateUserConfiguration 操作 |
Exchange 2010 |
| DeleteUserConfiguration 操作 |
Exchange 2010 |
| GetUserConfiguration 操作 |
Exchange 2010 |
| UpdateUserConfiguration 操作 |
Exchange 2010 |