Операции EWS в ExchangeEWS operations in Exchange

Сведения об операциях EWS, доступных в Exchange.Find information about the EWS operations that are available in Exchange.

Получить доступ к данным в хранилище Exchange вы можете с помощью множества операций веб-служб Exchange (EWS).Exchange Web Services (EWS) provides many operations that enable you to access information from the Exchange store. Статьи в этом разделе описывают общую структуру запросов, ответов и сообщений об ошибочных ответах, касающихся операций EWS, а также содержат примеры XML для каждой такой операции.The articles in this section provide information about the overall structure of the requests, responses, and error response messages for EWS operations, as well as XML examples for each operation. В них кратко рассмотрены структуры сообщений, которыми обмениваются клиент и сервер.They provide an overview of the message structures that are sent between the client and the server. Эти сведения позволят отладить структуры сообщений, а также узнать, какие действия доступны в запросе EWS.You can use this information to debug message structures and to find information about what you can do in an EWS request. Дополнительные сведения о том, что представляет собой структура XML, см. в статье XML-элементы EWS в Exchange.For more information about what the XML structure represents, see - EWS XML elements in Exchange.

Функциональность EWS связана с версией схемы. Новые версии схемы EWS вводятся в новых выпусках Exchange Server или Exchange Online. Элемент RequestServerVersion содержит атрибут Version, который сопоставляет версию сервера с версией схемы. В данной статье указано, когда была введена каждая операция. Для использования определенных возможностей операций может потребоваться более поздняя версия службы. Версионирование схем позволяет клиентам, разработанным для старой версии веб-служб Exchange, работать с новой их версией.All EWS functionality is associated with a version of the schema. New EWS schema versions are introduced in new releases of Exchange Server or Exchange Online. The RequestServerVersion element contains a Version attribute that maps the server version to the schema version. This article provides information about when each operation was introduced. Specific functionality within an operation might require a later version of the service. The versioned schemas are implemented so that clients that are designed against an older version of EWS will work with a newer version of EWS.

Целевым объектом этих операций может быть конечная точка EWS, которая обслуживает почтовый ящик. Перейти к конечной точке EWS можно с помощью URL-адреса, подобного http://.com/ews/exchange.asmx, где это сервер клиентского доступа Exchange, обслуживающий почтовый ящик. Получить URL-адрес сервера клиентского доступа, обслуживающего почтовый ящик, можно с помощью службы автообнаружения. Дополнительные сведения об автообнаружении см. в статье Автообнаружение для Exchange.These operations can target the EWS endpoint that services your mailbox. You can browse to the EWS endpoint by using a URL that is similar in structure to http://.com/ews/exchange.asmx, where is the Exchange Client Access server that services your mailbox. You can use Autodiscover to get the URL to the Client Access server that services your mailbox. For more information about Autodiscover, see Autodiscover for Exchange.

Операции обнаружения электронных данныхeDiscovery operations

Операции обнаружения электронных данных позволяют выполнять поиск в случае удержания по юридическим причинам, а также определять данные почтового ящика, которые невозможно индексировать и возвратить в результатах поиска для обнаружения.The eDiscovery operations provide search operations for legal holds and identify mailbox data that cannot be indexed and returned in discovery search results.

В таблице ниже перечислены операции обнаружения электронных данных.The following table lists the eDiscovery operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetDiscoverySearchConfigurationGetDiscoverySearchConfiguration operation
Exchange 2013Exchange 2013
Операция GetHoldOnMailboxesGetHoldOnMailboxes operation
Exchange 2013Exchange 2013
Операция GetNonIndexableItemDetailsGetNonIndexableItemDetails operation
Exchange 2013Exchange 2013
Операция GetNonIndexableItemStatisticsGetNonIndexableItemStatistics operation
Exchange 2013Exchange 2013
Операция GetSearchableMailboxesGetSearchableMailboxes operation
Exchange 2013Exchange 2013
Операция SearchMailboxesSearchMailboxes operation
Exchange 2013Exchange 2013
Операция SetHoldOnMailboxesSetHoldOnMailboxes operation
Exchange 2013Exchange 2013

Операции с данными почтовых ящиков ExchangeExchange mailbox data operations

Операции с данными почтовых ящиков Exchange позволяют клиентам обрабатывать и упорядочивать папки, вложения и другие элементы, а также выполнять разрешение неоднозначных имен и расширение списков рассылки. Операции с данными почтовых ящиков Exchange включают операции с папками, вложениями, другими элементами, а также служебными программами.The Exchange mailbox data operations enable clients to handle and organize items, folders, and attachments, as well as ambiguous name resolution and distribution list expansion. Exchange mailbox data operations include item, folder, attachment, and utilities operations.

В таблице ниже перечислены операции с данными почтовых ящиков Exchange.The following table lists the Exchange mailbox data operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция ArchiveItemArchiveItem operation
Exchange 2013Exchange 2013
CreateItem OperationCreateItem operation
Exchange 2007Exchange 2007
CopyItem OperationCopyItem operation
Exchange 2007Exchange 2007
Операция DeleteItemDeleteItem operation
Exchange 2007Exchange 2007
FindItem OperationFindItem operation
Exchange 2007Exchange 2007
GetItem OperationGetItem operation
Exchange 2007Exchange 2007
Операция MarkAllItemsAsReadMarkAllItemsAsRead operation
Exchange 2013Exchange 2013
MoveItem OperationMoveItem operation
Exchange 2007Exchange 2007
SendItem OperationSendItem operation
Exchange 2007Exchange 2007
UpdateItem OperationUpdateItem operation
Exchange 2007Exchange 2007

В таблице ниже перечислены операции с папками данных в почтовых ящиках Exchange.The following table lists the Exchange mailbox data folder operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
CreateFolder OperationCreateFolder operation
Exchange 2007Exchange 2007
Операция CreateFolderPathCreateFolderPath operation
Exchange 2013Exchange 2013
Операция CreateManagedFolderCreateManagedFolder operation
Exchange 2007. Вместо этой возможности в Exchange 2010 и более поздних версий используются другие. Дополнительные сведения о том, как применять теги и политики хранения для управления записями сообщений, см. в статье Переход от использования управляемых папок к использованию политик хранения. Exchange 2007. This functionality has been deemphasized in versions of Exchange starting with Exchange 2010. For more information about how to migrate to using retention tags and policies for messaging records management, see Migrate from Managed Folders.
Операция CopyFolderCopyFolder operation
Exchange 2007Exchange 2007
Операция DeleteFolderDeleteFolder operation
Exchange 2007Exchange 2007
Операция EmptyFolderEmptyFolder operation
Exchange 2010Exchange 2010
FindFolder OperationFindFolder operation
Exchange 2007Exchange 2007
GetFolder OperationGetFolder operation
Exchange 2007Exchange 2007
Операция MoveFolderMoveFolder operation
Exchange 2007Exchange 2007
Операцию UpdateFolderUpdateFolder operation
Exchange 2007Exchange 2007

В таблице ниже перечислены операции с вложениями в почтовых ящиках Exchange.The following table lists the Exchange mailbox data attachment operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция CreateAttachmentCreateAttachment operation
Exchange 2007Exchange 2007
Операция GetAttachmentGetAttachment operation
Exchange 2007Exchange 2007
Операция DeleteAttachmentDeleteAttachment operation
Exchange 2007Exchange 2007

В таблице ниже перечислены операции с напоминаниями в почтовых ящиках Exchange.The following table lists the Exchange mailbox reminder operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetRemindersGetReminders operation
Exchange 2013Exchange 2013
Операция PerformReminderActionPerformReminderAction operation
Exchange 2013Exchange 2013

В таблице ниже перечислены операции с беседами в почтовых ящиках Exchange.The following table lists the Exchange mailbox data conversation operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция ApplyConversationActionApplyConversationAction operation
Exchange 2010 с пакетом обновления 1 (SP1)Exchange 2010 Service Pack 1 (SP1)
FindConversation OperationFindConversation operation
Exchange 2010 SP1Exchange 2010 SP1
GetConversationItems operationGetConversationItems operation
Exchange 2013Exchange 2013

В таблице ниже перечислены операции с использованием служебных программ в почтовых ящиках Exchange.The following table lists the Exchange mailbox data utilities operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция ConvertIdConvertId operation
Exchange 2007 с пакетом обновления 1 (SP1)Exchange 2007 Service Pack 1
Операция ExpandDLExpandDL operation
Exchange 2007Exchange 2007
Операция GetUserPhotoGetUserPhoto operation
Exchange 2013. Эта операция может выполняться как с помощью REST, так и с помощью протокола SOAP.Exchange 2013. This operation has both a REST and a SOAP implementation.
MarkAsJunk OperationMarkAsJunk operation
Exchange 2013Exchange 2013
Операция ResolveNamesResolveNames operation
Exchange 2007Exchange 2007
Операция GetPasswordExpirationDateGetPasswordExpirationDate operation
Exchange 2010 с пакетом обновления 1 (SP1)Exchange 2010 SP1

Операции проверки доступностиAvailability operations

Операции проверки доступности повышают удобство работы с календарем и обмена сведениями о доступности, так как предоставляют защищенные, актуальные и полные сведения о доступности. Сведения о доступности критически важны при планировании собраний. Поэтому операции проверки доступности обеспечивают его эффективность.The availability operations improve the calendar and free/busy sharing experience by providing more secure, up-to-date, and rich free/busy information. Free/busy data is a critical component of scheduling meetings. The availability operations provide a reliable foundation for effective scheduling.

В таблице ниже перечислены операции проверки доступности.The following table lists the availability operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetUserAvailabilityGetUserAvailability operation
Exchange 2007Exchange 2007
Операция GetRoomListsGetRoomLists operation
Exchange 2010Exchange 2010
Операция GetRoomsGetRooms operation
Exchange 2010Exchange 2010
Операция GetUserOofSettingsGetUserOofSettings operation
Exchange 2007Exchange 2007
Операция SetUserOofSettingsSetUserOofSettings operation
Exchange 2007Exchange 2007

Операции массовой передачи данныхBulk transfer operations

С помощью операций массовой передачи данных клиенты могут выполнять потоковую передачу элементов в почтовый ящик и из него.The bulk transfer operations enable clients to stream items into and out of a mailbox.

В таблице ниже перечислены операции массовой передачи данных.The following table lists the bulk transfer operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция UploadItemsUploadItems operation
Exchange 2010 с пакетом обновления 1 (SP1)Exchange 2010 SP1
Операция ExportItemsExportItems operation
Exchange 2010 с пакетом обновления 1 (SP1)Exchange 2010 SP1

Операции управления делегированиемDelegate management operations

С помощью операций управления делегированием клиенты могут добавлять, получать, обновлять и удалять делегатов в почтовых ящиках.The delegate management operations enable clients to add, get, update, and remove delegates from their mailboxes.

В таблице ниже перечислены операции управления делегированием.The following table lists the delegate management operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция AddDelegateAddDelegate operation
Exchange 2007 с пакетом обновления 1 (SP1)Exchange 2007 Service Pack 1 (SP1)
Операция GetDelegateGetDelegate operation
Exchange 2007 SP1Exchange 2007 SP1
Операция UpdateDelegateUpdateDelegate operation
Exchange 2007 SP1Exchange 2007 SP1
Операция RemoveDelegateRemoveDelegate operation
Exchange 2007 SP1Exchange 2007 SP1

Операции с правилами для папки "Входящие"Inbox rules operations

Операции с правилами для папки "Входящие" позволяют клиентам получать правила для папки "Входящие" и обновлять их для сообщений на сервере. Правила для папки "Входящие" это наборы условий и связанных с ними действий, с помощью которых клиенты могут автоматически упорядочивать и классифицировать сообщения, доставляемые в папки, а также выполнять с ними действия.The Inbox rules operations enable clients to get Inbox rules and update them for messages on the server. Inbox rules are sets of conditions and associated actions that enable clients to automatically organize, categorize, and act on messages as the messages are delivered to a folder.

В таблице ниже перечислены операции с правилами для папки "Входящие"The following table lists the Inbox rules operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetInboxRulesGetInboxRules operation
Exchange 2010 с пакетом обновления 1 (SP1)Exchange 2010 SP1
Операция UpdateInboxRulesUpdateInboxRules operation
Exchange 2010 SP1Exchange 2010 SP1

Операции управления почтовыми приложениямиMail app management operations

Операции управления почтовыми приложениями позволяют управлять почтовыми приложениями для Outlook. С помощью этих операций можно устанавливать, удалять и отключать почтовые приложения, доступные для Outlook Web App и Outlook 2013, а также получать о них информацию.The mail app management operations enable you to manage mail apps for Outlook. You can use these operations to install, uninstall, disable, and get information about mail apps that are available for Outlook Web App and Outlook 2013.

В таблице ниже перечислены операции управления почтовыми приложениями.The following table lists the mail app management operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция DisableAppDisableApp operation
Exchange 2013Exchange 2013
Операция GetAppManifestsGetAppManifests operation
Exchange 2013Exchange 2013
Операция GetAppMarketplaceUrlGetAppMarketplaceUrl operation
Exchange 2013Exchange 2013
Операция GetClientAccessTokenGetClientAccessToken operation
Exchange 2013Exchange 2013
Операция InstallAppInstallApp operation
Exchange 2013Exchange 2013
Операция UninstallAppUninstallApp operation
Exchange 2013Exchange 2013

Операция с подсказками электронной почтыMail tips operation

Операция с подсказками электронной почты позволяет клиентам запрашивать у сервера сведения о почтовых ящиках получателей, когда автор составляет сообщение. В таблице ниже указана операция с подсказками электронной почты.The mail tips operation enables clients to request information from the server about recipient mailboxes when an author is composing a message. The following table lists the mail tips operation.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetMailTipsGetMailTips operation
Exchange 2010Exchange 2010

Операции отслеживания сообщенийMessage tracking operations

С помощью операций отслеживания сообщений клиенты могут находить сообщения, соответствующие определенным условиям, и получать подробные сведения об отслеживании каждого сообщения в отчетах об отслеживании сообщений.The message tracking operations enable clients to find messages that meet specified criteria and to get detailed tracking information about each message in a message tracking report.

В таблице ниже перечислены операции отслеживания сообщений.The following table lists the message tracking operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция FindMessageTrackingReportFindMessageTrackingReport operation
Exchange 2010Exchange 2010
Операция GetMessageTrackingReportGetMessageTrackingReport operation
Exchange 2010Exchange 2010

Операции с уведомлениямиNotification operations

Операции с уведомлениями сообщают клиентскому приложению о событиях, связанных с элементами и папками в определенном почтовом ящике. Модель подписки может базироваться на push- и pull-технологии, а также потоковой передаче данных.The notification operations notify the client application of events that are associated with items and folders a specified mailbox. The subscription model can be push-based, pull-based, or streaming-based.

В таблице ниже перечислены операции с уведомлениями.The following table lists the notification operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetEventsGetEvents operation
Exchange 2007Exchange 2007
Операция GetStreamingEventsGetStreamingEvents operation
Exchange 2010 SP1Exchange 2010 SP1
Операции подпискиSubscribe operation
Exchange 2007Exchange 2007
Отписаться операцииUnsubscribe operation
Exchange 2007Exchange 2007

Операции с пользователямиPersona operations

При использовании операции с пользователями доступен интерфейс, с помощью которого можно находить и получать сведения о связанном контакте. В таблице ниже перечислены операции с пользователями.The persona operations provide an interface to find and get information about a linked contact. The following table lists the persona operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция FindPeopleFindPeople operation
Exchange 2013Exchange 2013
Операция GetPersonaGetPersona operation
Exchange 2013Exchange 2013

Операция с политиками храненияRetention policy operation

Операция с политиками хранения предоставляет список всех тегов хранения, связанных с политикой хранения пользователя.The retention policy operation provides a list of all the retention tags that are linked to a user's retention policy.

В таблице ниже указана операция с политикой хранения.The following table lists the retention policy operation.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetUserRetentionPolicyTagsGetUserRetentionPolicyTags operation
Exchange 2013Exchange 2013

Операция с конфигурацией службService configuration operation

Операция с конфигурацией служб позволяет клиентам получать сведения о конфигурации для служб единой системы обмена сообщениями, правил защиты, подсказок политики и подсказок электронной почты.The service configuration operation enables clients to get configuration information for the Unified Messaging, Protection Rules, Policy Tips, and Mail Tips services.

В таблице ниже указана операция с конфигурацией служб.The following table lists the service configuration operation.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetServiceConfigurationGetServiceConfiguration operation
Exchange 2010Exchange 2010

Операции общего доступаSharing operations

С помощью операций общего доступа клиенты могут обмениваться данными календарей и контактов.The sharing operations enable clients to share calendar data and contacts data.

В таблице ниже перечислены операции общего доступа.The following table lists the sharing operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
CreateItem (AcceptSharingInvitation)CreateItem (AcceptSharingInvitation)
Exchange 2010. Хотя операция CreateItem применима ко всем версиям EWS, объект ответа AcceptSharingInvitation применим только к EWS в Exchange 2010 и более поздних версий. Exchange 2010. Although the CreateItem operation is applicable to all versions of EWS, the AcceptSharingInvitation response object is only applicable to EWS in versions of Exchange starting with Exchange 2010.
Операция GetSharingFolderGetSharingFolder operation
Exchange 2010Exchange 2010
Операция GetSharingMetadataGetSharingMetadata operation
Exchange 2010Exchange 2010
Операция RefreshSharingFolderRefreshSharingFolder operation
Exchange 2010Exchange 2010

Операции синхронизацииSynchronization operations

Операции синхронизации предоставляют односторонне синхронизированную кэшированную копию папок и элементов пользователя.The synchronization operations provide a one-way synchronized cached copy of a user's folders and items.

В таблице ниже перечислены операции синхронизации.The following table lists the synchronization operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция SyncFolderHierarchySyncFolderHierarchy operation
Exchange 2007Exchange 2007
Операция SyncFolderItemsSyncFolderItems operation
Exchange 2007Exchange 2007

Операция с часовыми поясамиTime zone operation

Операция с часовыми поясами позволяет клиентам получить список определений часовых поясов, поддерживаемых сервером.The time zone operation enables clients to get a list of time zone definitions that are supported by the server.

В таблице ниже указана операция с часовыми поясами.The following table lists the time zone operation.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция GetServerTimeZonesGetServerTimeZones operation
Exchange 2010Exchange 2010

Операции с единой системой обмена сообщениямиUnified Messaging operations

При помощи операций с единой системой обмена сообщениями клиенты могут читать сведения о свойствах единой системы обмена сообщениями и воспроизводить сообщения голосовой почты по телефону.The Unified Messaging operations enable clients to read information about Unified Messaging properties and to play voice mail messages over the phone.

В таблице ниже перечислены операции с единой системой обмена сообщениями.The following table lists the Unified Messaging operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция DisconnectPhoneCallDisconnectPhoneCall operation
Exchange 2010Exchange 2010
Операция GetPhoneCallInformationGetPhoneCallInformation operation
Exchange 2010Exchange 2010
Операция PlayOnPhone (EWS)PlayOnPhone operation (EWS)
Exchange 2010Exchange 2010

Операция GetServiceConfiguration позволяет получить сведения о конфигурации единой системы обмена сообщениями для почтового ящика. Для приложений единой системы обмена сообщениями, предназначенных для Exchange 2007, используйте веб-службу единой системы обмена сообщениями. Дополнительные сведения см. в статье Единой системы обмена сообщениями веб-службы ссылки для Exchange.Use the GetServiceConfiguration operation to get the Unified Messaging configuration information for a mailbox. Use the Unified Messaging web service for Unified Messaging applications that target Exchange 2007. For more information, see Unified Messaging web service reference for Exchange.

Операции с единым хранилищем контактовUnified Contact Store operations

Единое хранилище контактов позволяет использовать общий список контактов для всех продуктов Office и выполняет роль точки интеграции для сторонних приложений, чтобы они использовали то же самое хранилище контактов. С помощью него пользователи и приложения могут хранить сведения о контактах, управлять ими, получать к ним доступ, а также открывать глобальный доступ к ним в Lync, Exchange 2013, Outlook, Outlook Web App и других приложениях, в которых реализован доступ к единому хранилищу контактов. Exchange выполняет функцию хранилища содержимого для единого хранилища контактов.The Unified Contact Store provides a consistent contact experience across Office products and acts as an integration point for third-party applications to use the same contact store. It enables users and applications to store, manage, and access contact information and make it available globally among Lync, Exchange 2013, Outlook, Outlook Web App, and any other application that implements access to the Unified Contact Store. Exchange is the content store for the Unified Contact Store experience.

В таблице ниже перечислены операции с единым хранилищем контактов.The following table lists the Unified Contact Store operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция AddNewImContactToGroupAddNewImContactToGroup operation
Exchange 2013Exchange 2013
Операция AddImContactToGroupAddImContactToGroup operation
Exchange 2013Exchange 2013
Операция AddImGroupAddImGroup operation
Exchange 2013Exchange 2013
Операция AddNewTelUriContactToGroupAddNewTelUriContactToGroup operation
Exchange 2013Exchange 2013
Операция AddDistributionGroupToImListAddDistributionGroupToImList operation
Exchange 2013Exchange 2013
Операция GetImItemListGetImItemList operation
Exchange 2013Exchange 2013
Операция GetImItemsGetImItems operation
Exchange 2013Exchange 2013
Операция RemoveContactFromImListRemoveContactFromImList operation
Exchange 2013Exchange 2013
Операция RemoveImContactFromGroupRemoveImContactFromGroup operation
Exchange 2013Exchange 2013
Операция RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation
Exchange 2013Exchange 2013
Операция RemoveImGroupRemoveImGroup operation
Exchange 2013Exchange 2013
Операция SetImGroupSetImGroup operation
Exchange 2013Exchange 2013

Операции с конфигурациями пользователейUser configuration operations

Операции с конфигурациями пользователей позволяют клиентам создавать, удалять, получать и обновлять сведения о конфигурации пользователей.The user configuration operations enable clients to create, delete, get, and update user configuration information.

В таблице ниже перечислены операции с конфигурациями пользователей.The following table lists the user configuration operations.

Имя операцииOperation name Версия, где параметр был представленIntroduced in
Операция CreateUserConfigurationCreateUserConfiguration operation
Exchange 2010Exchange 2010
Операция DeleteUserConfigurationDeleteUserConfiguration operation
Exchange 2010Exchange 2010
Операция GetUserConfigurationGetUserConfiguration operation
Exchange 2010Exchange 2010
Операция UpdateUserConfigurationUpdateUserConfiguration operation
Exchange 2010Exchange 2010

См. такжеSee also