New features in the EWS Managed API 2.0
Learn about the new features introduced in the EWS Managed API 2.0.
Last modified: February 06, 2014
Applies to: EWS Managed API
Note: This content applies to the EWS Managed API 2.0 and earlier versions. For the latest information about the EWS Managed API, see Web services in Exchange.
In this article
eDiscovery and the EWS Managed API
Archiving and the EWS Managed API
Retention policies and the EWS Managed API
Mail apps for Outlook
OAuth validation
Other new features in the EWS Managed API
Additional resources
The EWS Managed API 2.0 has been updated to support the new public Exchange Web Services (EWS) features in Exchange Server 2013, including the following:
eDiscovery
Archiving
Retention policies
Mail apps for Outlook
Note
The EWS Managed API does not support the personas, Unified Contact Store, or create folder hierarchy features in Exchange 2013.
eDiscovery and the EWS Managed API
The electronic discovery (eDiscovery) feature 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. eDiscovery queries facilitate the discovery process by providing a single discovery workflow across Exchange and SharePoint. The following ExchangeService object members are entry points into the eDiscovery feature:
The EWS Managed API also provides two methods that enable you to get information about items that cannot be searched via eDiscovery:
Archiving and the EWS Managed API
In addition to the basic EWS functionality that can be used for archiving data maintained in the Exchange store, the new ArchiveItem operation enables item-level archiving into an archive mailbox. You can use the ArchiveItems(IEnumerable<ItemId>, FolderId) method to archive one or more items, including tasks, email messages, contacts, or other Exchange store items, into an archive mailbox.
Retention policies and the EWS Managed API
In Exchange 2013, user retention policy tags can be retrieved from the server. This enables clients to implement user-based retention tags on folders and folder items. The GetUserRetentionPolicyTags() method provides the policy information. You can access policy tags from the RetentionDate property on email message, contact, meeting, and task items, and from the PolicyTag and PolicyTag property on folders and items.
Mail apps for Outlook
The EWS Managed API now provides methods that you can use to manage mail apps for Outlook. You can use the following methods to install, uninstall, disable, and get information about mail apps that are available for Outlook Web App and Outlook 2013:
OAuth validation
The EWS Managed API now includes the new partner DLL, Microsoft.Exchange.WebServices.Auth.dll. You can use this DLL to validate user identity tokens sent from an Exchange server.
Other new features in the EWS Managed API
The EWS Managed API includes the following functionality to support new scenarios:
New client statistics reporting for clients that target Exchange Online. Additionally, the new RequestId header is returned in every response so that you can now access the unique request ID from the HttpResponseHeaders on the ExchangeService object. This enables you to easily associate a request with a log entry on the server.
A new MarkAsJunk(IEnumerable<ItemId>, Boolean, Boolean) method, which enables you to mark items as junk and block senders.
A new GetConversationItems(ConversationId, PropertySet, String, IEnumerable<FolderId>, Nullable<ConversationSortOrder>) method, which enables you to request all the items in a conversation, along with the conversation node structure.
Support for server-to-server scenarios by means of the OAuthCredentials object.
Pretty-printing for trace logging.
New user settings added to the UserSettingName type.
A new ManagementRoles property, which restricts access based on group membership.