Topic Last Modified: 2010-06-30

© 2009 Microsoft Corporation, All Rights Reserved.

The Microsoft Exchange Web Services (EWS) Managed API 1.1 provides a new Microsoft .NET interface to the Microsoft Exchange Server 2007 and Exchange Server 2010 Web services. 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 automatically 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 document Getting Started with the EWS Managed API contains more information to help you use the EWS Managed API. The document is installed in the same folder in which the assembly is installed.

For online documentation for this release, see the Exchange Web Services Managed API 1.0 SDK. There you can find documentation, sample code, and other information to help you use the EWS Managed API. Note that the April 2010 release of the Exchange Web Services Managed API SDK describes most, but not all of the capabilities of this version of the managed API. Refer to the Known Issues section of this Readme for more information.

The Microsoft Exchange Server Web site provides product and licensing information for Exchange Server, including white papers, product literature, Exchange-related events, service packs, and more. Visit the site frequently for new and updated content.

The Microsoft Exchange Server Developer Center Web site on MSDN includes news, additional development information, downloads, technical articles, newsgroups, and more. Visit the Microsoft Exchange Server Developer Center frequently for new and updated developer information.

The Microsoft Exchange Server TechCenter is your one-stop source for technical documentation about Exchange Server. The library is a catalog of technical Exchange Server content that has been reviewed and approved by the Exchange Server product team at Microsoft.

Feedback

The Exchange team welcomes feedback about the preliminary Exchange Web Services Managed API. You can submit feedback to the Exchange Server 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:

  • Microsoft Visual Studio .NET 2008 or later

  • Microsoft .NET Framework version 3.5 or later

If you will be running applications that use the EWS Managed API on a different computer, you must have the .NET Framework version 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 on computers that are running the following versions of Microsoft Exchange Server:

  • Exchange Server 2007 Service Pack 1 (SP1) or later

  • Exchange Server 2010 or later

The Exchange server on which the Client Access server role is installed must have Exchange Web Services enabled. If Exchange Web Services 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 default install path is C:\Program Files\Microsoft\Exchange\Web Services\1.1.

Important:
To help prevent conflicts between different versions of the EWS Managed API installed by other applications, do not install the EWS Managed API assembly in the Global Assembly Cache (GAC).

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.

  • 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 Client API Assembly

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

Known Issues

Do Not Install into GAC   To help prevent conflicts between versions of the EWS Managed API installed by other applications, do not install the EWS Managed API assembly in the Global Assembly Cache (GAC).

Documentation does not include EmptyFolder API Due to scheduling changes with this release, documentation for the EmptyFolder APIs could not be published in the April 2010 release of the SDK. You can find information about that in the Exchange Developer Center article Emptying a Folder the Easy Way by Using the EWS Managed API. Information about the EmptyFolder API will be added to the next release of the SDK.