Microsoft Exchange Web Services Managed API 2.2 Readme |

Topic Last Modified: 2014-01-23

© 2014 Microsoft Corporation, All Rights Reserved.

The Exchange Web Services (EWS) Managed API 2.2 provides a .NET Framework interface to EWS in Exchange Online, Exchange Online as part of Office 365, and versions of Exchange starting with Exchange Server 2007 Service Pack 1 (SP1). You can use this version of the EWS Managed API to evaluate the library for your application needs, to compare it to directly using XML or the auto generated proxy library, and to create production-ready applications.

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

The Get started with EWS Managed API client applications article helps you makeshows you how to create a Hello World application by using the EWS Managed API.

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.
- License Terms.rtf Contains the license terms for using the EWS Managed API and documentation.
- 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.