Topic Last Modified: 2014-01-23

© 2014 Microsoft Corporation, All Rights Reserved.

This Readme provides information about how to provide comments and get support, information about installation prerequisites, and information about how to install and remove the EWS Managed API assembly and related documents.

Learning more

For online documentation for this release, see Web services in Exchange. This documentation contains sample code and other information to help you use the EWS Managed API.

The Exchange website provides product information for Exchange.

The Exchange Dev Center on MSDN includes developer information and links to Exchange-related resources.

The Exchange TechCenter is your one-stop source for Exchange technical documentation for ITPros.

Feedback

The Exchange team welcomes feedback about the EWS Managed API. You can submit feedback to the Exchange Development Forum. Feedback from our customers is an important part of our development process. Thank you for helping us to develop a better product.

Prerequisites

To use this version of the EWS Managed API, you must have the following installed on the computer where you build client applications:

  • Visual Studio .NET 2008 or a later version

  • The .NET Framework 3.5 or a later version

If you will be running applications that use the EWS Managed API on a different computer, you must have the .NET Framework 3.5 installed on that computer. Most applications do not require Visual Studio to be installed on the client computer.

The EWS Managed API can be used to access information hosted in Exchange Online or on computers that are running versions of Exchange starting with Exchange 2007 SP1.

The Exchange server on which the Client Access server role is installed must have EWS enabled. If EWS is disabled, the EWS Managed API cannot communicate with the server.

Installing the EWS Managed API assembly

To install the EWS Managed API assembly

  1. Download the EwsManagedApi.msi file and store it on your hard disk.

  2. Run the EwsManagedApi.msi file and follow the instructions in the installation wizard. You must accept the terms of the license agreement to install the software.

The following is the default installation path: C:\Program Files\Microsoft\Exchange\Web Services\2.2

Files installed

The following files are installed by EwsManagedApi.msi:

  • Microsoft.Exchange.WebServices.dll   The signed .NET assembly that implements the EWS Managed API.

  • Microsoft.Exchange.WebServices.xml   Provides a Visual Studio .NET IntelliSense file for the EWS Managed API.

  • Microsoft.Exchange.WebServices.Auth.dll   Provides an API to validate, parse and process Exchange Identity Tokens to be used by mail apps for Outlook.

  • Microsoft.Exchange.WebServices.Auth.xml   Provides a Visual Studio .NET IntelliSense file for the Auth library.

  • GettingStarted.doc   Provides additional help for and information about how to use the API.

  • Readme.htm   This file.

  • Redist.txt   Defines which files and directories can be redistributed under the license terms.

Removing the EWS Managed API assembly

To remove the EWS Managed API files from your computer, locate and run the EwsManagedApi.msi installer and select the Remove option.