New features in the EWS Managed API
Published: July 16, 2012
Learn about the new features introduced in the EWS Managed API 2.0.
Applies to: Exchange Server 2013 | Exchange Online | EWS Managed API
The EWS Managed API has been updated to support the new public Exchange Web Services (EWS) features in Exchange Server 2013, including the following:
Mail apps for Outlook
The EWS Managed API does not support the personas, Unified Contact Store, or create folder hierarchy features in Exchange 2013.
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:
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.
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.
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:
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.
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.
For a list of API-level changes, see New EWS Managed API content.