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 エンドポイントを参照できます。
電子情報開示の操作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 |