Exchange での EWS 操作EWS operations in Exchange

Exchange で使用可能な EWS 操作についての情報を検索します。Find information about the EWS operations that are available in Exchange.

Exchange Web サービス (EWS) には、Exchange ストアからの情報へのアクセスを可能にする多くの操作が用意されています。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 構造が何を表しているかの詳細については、「 Exchange の EWS XML 要素」を参照してください。For more information about what the XML structure represents, see - EWS XML elements in Exchange.

すべての EWS 機能は、スキーマのバージョンに関連付けられています。All EWS functionality is associated with a version of the schema. 新しい EWS スキーマのバージョンは、Exchange Server または Exchange Online の新しいリリースで導入されました。New EWS schema versions are introduced in new releases of Exchange Server or Exchange Online. RequestServerVersion要素には、サーバーバージョンをスキーマバージョンにマップするversion属性が含まれています。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. 以前のバージョンの EWS に対して設計されたクライアントが、新しいバージョンの EWS で動作するように、バージョン付きのスキーマが実装されています。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 エンドポイントを対象とすることができます。These operations can target the EWS endpoint that services your mailbox. Http:///ews/exchange .asmx に似た URL を使用して、EWS エンドポイントを参照できます。 ここで、 はメールボックスをサービスする Exchange クライアントアクセスサーバーです。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. 自動検出を使用して、メールボックスをサービスするクライアントアクセスサーバーへの URL を取得できます。You can use Autodiscover to get the URL to the Client Access server that services your mailbox. 自動検出の詳細については、「 Exchange の自動検出」を参照してください。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
GetDiscoverySearchConfiguration 操作GetDiscoverySearchConfiguration operation
Exchange 2013Exchange 2013
GetHoldOnMailboxes 操作GetHoldOnMailboxes operation
Exchange 2013Exchange 2013
GetNonIndexableItemDetails 操作GetNonIndexableItemDetails operation
Exchange 2013Exchange 2013
GetNonIndexableItemStatistics 操作GetNonIndexableItemStatistics operation
Exchange 2013Exchange 2013
Getsearchablemailemail箱操作GetSearchableMailboxes operation
Exchange 2013Exchange 2013
SearchMailboxes ボックスの操作SearchMailboxes operation
Exchange 2013Exchange 2013
SetHoldOnMailboxes 操作SetHoldOnMailboxes operation
Exchange 2013Exchange 2013

Exchange メールボックスデータの操作Exchange mailbox data operations

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 メールボックスのデータ操作には、アイテム、フォルダー、添付ファイル、およびユーティリティの操作が含まれます。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
アーカイブアイテムの操作ArchiveItem operation
Exchange 2013Exchange 2013
CreateItem 操作CreateItem operation
Exchange 2007Exchange 2007
CopyItem 操作CopyItem operation
Exchange 2007Exchange 2007
DeleteItem 操作DeleteItem operation
Exchange 2007Exchange 2007
FindItem 操作FindItem operation
Exchange 2007Exchange 2007
GetItem 操作GetItem operation
Exchange 2007Exchange 2007
MarkAllItemsAsRead 操作MarkAllItemsAsRead operation
Exchange 2013Exchange 2013
MoveItem 操作MoveItem operation
Exchange 2007Exchange 2007
SendItem 操作SendItem operation
Exchange 2007Exchange 2007
UpdateItem 操作UpdateItem operation
Exchange 2007Exchange 2007

次の表に、Exchange メールボックスデータフォルダーの操作を示します。The following table lists the Exchange mailbox data folder operations.

操作名Operation name 導入バージョンIntroduced in
CreateFolder 操作CreateFolder operation
Exchange 2007Exchange 2007
CreateFolderPath 操作CreateFolderPath operation
Exchange 2013Exchange 2013
CreateManagedFolder 操作CreateManagedFolder operation
Exchange 2007。Exchange 2007. Exchange 2010 以降のバージョンの Exchange では、この機能は強調されていません。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.
CopyFolder 操作CopyFolder operation
Exchange 2007Exchange 2007
DeleteFolder 操作DeleteFolder operation
Exchange 2007Exchange 2007
EmptyFolder 操作EmptyFolder operation
Exchange 2010Exchange 2010
FindFolder 操作FindFolder operation
Exchange 2007Exchange 2007
GetFolder 操作GetFolder operation
Exchange 2007Exchange 2007
MoveFolder 操作MoveFolder operation
Exchange 2007Exchange 2007
UpdateFolder 操作UpdateFolder operation
Exchange 2007Exchange 2007

次の表に、Exchange メールボックスデータ添付操作の一覧を示します。The following table lists the Exchange mailbox data attachment operations.

操作名Operation name 導入バージョンIntroduced in
CreateAttachment 操作CreateAttachment operation
Exchange 2007Exchange 2007
GetAttachment 操作GetAttachment operation
Exchange 2007Exchange 2007
DeleteAttachment 操作DeleteAttachment operation
Exchange 2007Exchange 2007

次の表に、Exchange メールボックスのアラーム操作を示します。The following table lists the Exchange mailbox reminder operations.

操作名Operation name 導入バージョンIntroduced in
GetReminders 操作GetReminders operation
Exchange 2013Exchange 2013
PerformReminderAction 操作PerformReminderAction operation
Exchange 2013Exchange 2013

次の表に、Exchange メールボックスデータの会話操作を示します。The following table lists the Exchange mailbox data conversation operations.

操作名Operation name 導入バージョンIntroduced in
ApplyConversationAction 操作ApplyConversationAction operation
Exchange 2010 Service Pack 1 (SP1)Exchange 2010 Service Pack 1 (SP1)
FindConversation 操作FindConversation operation
Exchange 2010 SP1Exchange 2010 SP1
GetConversationItems 操作GetConversationItems operation
Exchange 2013Exchange 2013

次の表に、Exchange メールボックスデータユーティリティの操作を示します。The following table lists the Exchange mailbox data utilities operations.

操作名Operation name 導入バージョンIntroduced in
ConvertId 操作ConvertId operation
Exchange 2007 Service Pack 1Exchange 2007 Service Pack 1
ExpandDL 操作ExpandDL operation
Exchange 2007Exchange 2007
GetUserPhoto 操作GetUserPhoto operation
Exchange 2013。Exchange 2013. この操作には、REST と SOAP の実装の両方があります。This operation has both a REST and a SOAP implementation.
MarkAsJunk 操作MarkAsJunk operation
Exchange 2013Exchange 2013
ResolveNames 操作ResolveNames operation
Exchange 2007Exchange 2007
GetPasswordExpirationDate 操作GetPasswordExpirationDate operation
Exchange 2010 SP1Exchange 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
GetUserAvailability 操作GetUserAvailability operation
Exchange 2007Exchange 2007
GetRoomLists 操作GetRoomLists operation
Exchange 2010Exchange 2010
GetRooms 操作GetRooms operation
Exchange 2010Exchange 2010
GetUserOofSettings 操作GetUserOofSettings operation
Exchange 2007Exchange 2007
SetUserOofSettings 操作SetUserOofSettings 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
UploadItems 操作UploadItems operation
Exchange 2010 SP1Exchange 2010 SP1
ExportItems 操作ExportItems operation
Exchange 2010 SP1Exchange 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
AddDelegate 操作AddDelegate operation
Exchange 2007 Service Pack 1 (SP1)Exchange 2007 Service Pack 1 (SP1)
GetDelegate 操作GetDelegate operation
Exchange 2007 SP1Exchange 2007 SP1
UpdateDelegate 操作UpdateDelegate operation
Exchange 2007 SP1Exchange 2007 SP1
RemoveDelegate 操作RemoveDelegate 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
GetInboxRules の操作GetInboxRules operation
Exchange 2010 SP1Exchange 2010 SP1
UpdateInboxRules の操作UpdateInboxRules operation
Exchange 2010 SP1Exchange 2010 SP1

メールアプリの管理操作Mail app management operations

メールアプリの管理操作により、Outlook 用メールアプリを管理できます。The mail app management operations enable you to manage mail apps for Outlook. これらの操作は、Outlook Web App および Outlook 2013 で利用可能なメールアプリに関する情報をインストール、アンインストール、無効化、および取得するために使用できます。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
DisableApp 操作DisableApp operation
Exchange 2013Exchange 2013
GetAppManifests 操作GetAppManifests operation
Exchange 2013Exchange 2013
GetAppMarketplaceUrl 操作GetAppMarketplaceUrl operation
Exchange 2013Exchange 2013
GetClientAccessToken 操作GetClientAccessToken operation
Exchange 2013Exchange 2013
InstallApp 操作InstallApp operation
Exchange 2013Exchange 2013
アン Installapp 操作UninstallApp 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
GetMailTips ヒント操作GetMailTips 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
FindMessageTrackingReport 操作FindMessageTrackingReport operation
Exchange 2010Exchange 2010
GetMessageTrackingReport 操作GetMessageTrackingReport operation
Exchange 2010Exchange 2010

通知の操作 Notification operations

通知操作は、指定されたメールボックスのアイテムとフォルダーに関連付けられているイベントをクライアントアプリケーションに通知します。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
GetEvents 操作GetEvents operation
Exchange 2007Exchange 2007
GetStreamingEvents の操作GetStreamingEvents operation
Exchange 2010 SP1Exchange 2010 SP1
サブスクライブ操作Subscribe operation
Exchange 2007Exchange 2007
Unsubscribe 操作Unsubscribe operation
Exchange 2007Exchange 2007

Persona 操作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
FindPeople 操作FindPeople operation
Exchange 2013Exchange 2013
GetPersona 操作GetPersona 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
GetUserRetentionPolicyTags 操作GetUserRetentionPolicyTags 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
GetServiceConfiguration 操作GetServiceConfiguration 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。Exchange 2010. CreateItem操作は、すべてのバージョンの EWS に適用できますが、 acceptsharinginvitation応答オブジェクトは、exchange 2010 以降のバージョンの exchange の ews にのみ適用されます。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.
GetSharingFolder 操作GetSharingFolder operation
Exchange 2010Exchange 2010
GetSharingMetadata 操作GetSharingMetadata operation
Exchange 2010Exchange 2010
RefreshSharingFolder 操作RefreshSharingFolder 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
SyncFolderHierarchy 操作SyncFolderHierarchy operation
Exchange 2007Exchange 2007
SyncFolderItems 操作SyncFolderItems 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
GetServerTimeZones 操作GetServerTimeZones 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
切断電話操作DisconnectPhoneCall operation
Exchange 2010Exchange 2010
GetPhoneCallInformation 操作GetPhoneCallInformation operation
Exchange 2010Exchange 2010
PlayOnPhone 操作 (EWS)PlayOnPhone operation (EWS)
Exchange 2010Exchange 2010

GetServiceConfiguration 操作を使用して、メールボックスのユニファイドメッセージング構成情報を取得します。Use the GetServiceConfiguration operation to get the Unified Messaging configuration information for a mailbox. ユニファイドメッセージング web サービスは、Exchange 2007 を対象としたユニファイドメッセージングアプリケーションに対して使用します。Use the Unified Messaging web service for Unified Messaging applications that target Exchange 2007. 詳細については、「ユニファイドメッセージング web サービスリファレンス (Exchange)」を参照してください。For more information, see Unified Messaging web service reference for Exchange.

統合連絡先ストアの操作Unified Contact Store operations

統合連絡先ストアは、Office 製品間で一貫した連絡先環境を提供し、サードパーティアプリケーションが同じ連絡先ストアを使用するための統合ポイントとして機能します。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. これにより、ユーザーとアプリケーションは、連絡先情報を格納、管理、およびアクセスして、Lync、Exchange 2013、Outlook、Outlook Web App、および統合連絡先ストアへのアクセスを実装するその他のアプリケーション間でグローバルに利用できるようになります。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 は、統合連絡先ストアの機能のコンテンツストアです。Exchange is the content store for the Unified Contact Store experience.

次の表に、統合連絡先ストアの操作を示します。The following table lists the Unified Contact Store operations.

操作名Operation name 導入バージョンIntroduced in
AddNewImContactToGroup 操作AddNewImContactToGroup operation
Exchange 2013Exchange 2013
AddImContactToGroup 操作AddImContactToGroup operation
Exchange 2013Exchange 2013
AddImGroup 操作AddImGroup operation
Exchange 2013Exchange 2013
AddNewTelUriContactToGroup 操作AddNewTelUriContactToGroup operation
Exchange 2013Exchange 2013
Adddeploy Grouptoimlist 操作AddDistributionGroupToImList operation
Exchange 2013Exchange 2013
GetImItemList 操作GetImItemList operation
Exchange 2013Exchange 2013
GetImItems 操作GetImItems operation
Exchange 2013Exchange 2013
RemoveContactFromImList 操作RemoveContactFromImList operation
Exchange 2013Exchange 2013
RemoveImContactFromGroup 操作RemoveImContactFromGroup operation
Exchange 2013Exchange 2013
RemoveDistributionGroupFromImList 操作RemoveDistributionGroupFromImList operation
Exchange 2013Exchange 2013
RemoveImGroup 操作RemoveImGroup operation
Exchange 2013Exchange 2013
SetImGroup 操作SetImGroup 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
CreateUserConfiguration 操作CreateUserConfiguration operation
Exchange 2010Exchange 2010
DeleteUserConfiguration 操作DeleteUserConfiguration operation
Exchange 2010Exchange 2010
GetUserConfiguration 操作GetUserConfiguration operation
Exchange 2010Exchange 2010
UpdateUserConfiguration 操作UpdateUserConfiguration operation
Exchange 2010Exchange 2010

関連項目See also