Exchange での EWS 操作

Exchange で使用できる EWS 操作に関する情報を検索します。

Exchange Web サービス (EWS) には、Exchange ストアから情報にアクセスするための数多くの操作が用意されています。 このセクションの記事では、EWS 操作の要求、応答、およびエラー応答メッセージの全体的な構造に関する情報と、各操作の XML 例について説明します。 クライアントとサーバーの間で送信されるメッセージ構造の概要を示します。 この情報を使用すると、メッセージ構造をデバッグしたり、EWS 要求で実行できる操作に関する情報を検索したりできます。 XML 構造体が表す内容の詳細については、「Exchange での WS XML 要素」を参照してください。

EWS のすべての機能は、スキーマのバージョンに関連付けられます。 新しい EWS スキーマ バージョンは、Exchange Server または Exchange Online の新しいリリースで導入されました。 RequestServerVersion 要素には、サーバー バージョンをスキーマ バージョンにマップする Version 属性が含まれています。 この記事では、各操作がいつ導入されたかについて説明します。 操作内の特定の機能には、新しいバージョンのサービスが必要になる場合があります。 バージョン管理されたスキーマは、古いバージョンの EWS に対して設計されたクライアントが新しいバージョンの EWS で動作するように実装されます。

これらの操作は、メールボックスにサービスを提供する EWS エンドポイントを対象にすることができます。 EWS エンドポイントを参照するには、clientaccessserver.com>/ews/exchange.asmx http://< 構造に似た URL を使用します。clientaccessserver>< はメールボックスを処理する Exchange クライアント アクセス サーバーです。 自動検出を使用して、メールボックスにサービスを提供するクライアント アクセス サーバーの URL を取得できます。 これらの方法の詳細については、「Exchange の自動検出」をご覧ください。

電子情報開示の操作

電子情報開示操作では、訴訟ホールドの検索操作が提供され、証拠開示検索結果でインデックスを作成して返すことができないメールボックス データが識別されます。

電子情報開示操作の一覧を次の表に示します。

操作名 導入バージョン
GetDiscoverySearchConfiguration 操作
Exchange 2013
GetHoldOnMailboxes 操作
Exchange 2013
GetNonIndexableItemDetails 操作
Exchange 2013
GetNonIndexableItemStatistics 操作
Exchange 2013
GetSearchableMailboxes 操作
Exchange 2013
SearchMailboxes 操作
Exchange 2013
SetHoldOnMailboxes 操作
Exchange 2013

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

Exchange メールボックスのデータ操作を使用すると、クライアントはアイテム、フォルダー、添付ファイル、あいまいな名前解決と配布リストの展開を処理および整理できます。 Exchange メールボックスのデータ操作には、アイテム、フォルダー、添付ファイル、ユーティリティの操作が含まれます。

次の表に、Exchange メールボックスのデータ操作を示します。

操作名 導入バージョン
ArchiveItem 操作
Exchange 2013
CreateItem 操作
Exchange 2007
CopyItem 操作
Exchange 2007
DeleteItem 操作
Exchange 2007
FindItem 操作
Exchange 2007
GetItem 操作
Exchange 2007
MarkAllItemsAsRead 操作
Exchange 2013
MoveItem 操作
Exchange 2007
SendItem 操作
Exchange 2007
UpdateItem 操作
Exchange 2007

次の表に、Exchange メールボックス データ フォルダーの操作を示します。

操作名 導入バージョン
CreateFolder 操作
Exchange 2007
CreateFolderPath 操作
Exchange 2013
CreateManagedFolder 操作
Exchange 2007。 この機能は、Exchange 2010 以降のバージョンの Exchange でスケール化されています。 メッセージング レコード管理に保持タグとポリシーを使用して移行する方法の詳細については、「管理フォルダーからの移行」を参照してください。
CopyFolder 操作
Exchange 2007
DeleteFolder 操作
Exchange 2007
EmptyFolder 操作
Exchange 2010
FindFolder 操作
Exchange 2007
GetFolder 操作
Exchange 2007
MoveFolder 操作
Exchange 2007
UpdateFolder 操作
Exchange 2007

次の表に、Exchange メールボックス データの添付ファイルの操作を示します。

操作名 導入バージョン
CreateAttachment 操作
Exchange 2007
GetAttachment 操作
Exchange 2007
DeleteAttachment 操作
Exchange 2007

次の表に、Exchange メールボックスアラーム操作の一覧を示します。

操作名 導入バージョン
GetReminders 操作
Exchange 2013
PerformReminderAction 操作
Exchange 2013

次の表に、Exchange メールボックス データの会話操作を示します。

操作名 導入バージョン
ApplyConversationAction 操作
Exchange 2010 Service Pack 1 (SP1)
FindConversation 操作
Exchange 2010 SP1
GetConversationItems 操作
Exchange 2013

次の表に、Exchange メールボックス データ ユーティリティの操作を示します。

操作名 導入バージョン
ConvertId 操作
Exchange 2007 Service Pack 1
ExpandDL 操作
Exchange 2007
GetUserPhoto 操作
Exchange 2013。 この操作には、REST と SOAP の両方の実装があります。
MarkAsJunk 操作
Exchange 2013
ResolveNames 操作
Exchange 2007
GetPasswordExpirationDate 操作
Exchange 2010 SP1

可用性操作

可用性操作では、より安全で最新の、豊富な空き時間情報を提供することで、予定表と空き時間情報の共有エクスペリエンスが向上します。 空き時間データは、会議をスケジュールする上で重要なコンポーネントです。 可用性操作は、効果的なスケジュール設定のための信頼性の高い基盤を提供します。

次の表に、可用性操作の一覧を示します。

操作名 導入バージョン
GetUserAvailability 操作
Exchange 2007
GetRoomLists 操作
Exchange 2010
GetRooms 操作
Exchange 2010
GetUserOofSettings 操作
Exchange 2007
SetUserOofSettings 操作
Exchange 2007

一括転送操作

一括転送操作を使用すると、クライアントはメールボックスに対してアイテムをストリーム配信できます。

次の票に一括転送操作のリストを示します。

操作名 導入バージョン
UploadItems 操作
Exchange 2010 SP1
ExportItems 操作
Exchange 2010 SP1

管理操作の委任

代理管理操作を使用すると、クライアントはメールボックスに代理人を追加、取得、更新、および削除できます。

次の表に、代理人管理操作のリストを示します。

操作名 導入バージョン
AddDelegate 操作
Exchange 2007 Service Pack 1 (SP1)
GetDelegate 操作
Exchange 2007 SP1
UpdateDelegate 操作
Exchange 2007 SP1
RemoveDelegate 操作
Exchange 2007 SP1

受信トレイ ルールの操作

受信トレイ ルール操作を使用すると、クライアントは受信トレイ ルールを取得し、サーバー上のメッセージに対して更新できます。 受信トレイ ルールは、メッセージがフォルダーに配信されるときにクライアントがメッセージを自動的に整理、分類、および操作できるようにする条件と関連するアクションのセットです。

次の票に受信トレイ ルールの操作のリストを次の表に示します。

操作名 導入バージョン
GetInboxRules の操作
Exchange 2010 SP1
UpdateInboxRules の操作
Exchange 2010 SP1

メール アプリの管理操作

メール アプリ管理操作を使用すると、Outlook 用のメール アプリを管理できます。 これらの操作を使用して、Outlook Web App と Outlook 2013 で使用できるメール アプリのインストール、アンインストール、無効化、および情報の取得を行うことができます。

次の表に、メール アプリの管理操作のリストを示します。

操作名 導入バージョン
DisableApp 操作
Exchange 2013
GetAppManifests 操作
Exchange 2013
GetAppMarketplaceUrl 操作
Exchange 2013
GetClientAccessToken 操作
Exchange 2013
InstallApp 操作
Exchange 2013
UninstallApp 操作
Exchange 2013

メール ヒントの操作

メール ヒント操作を使用すると、作成者がメッセージを作成しているときに、クライアントは受信者メールボックスに関する情報をサーバーに要求できます。 次の表に、メール ヒントの操作を示します。

操作名 導入バージョン
GetMailTips 操作
Exchange 2010

メッセージ追跡操作

メッセージ追跡操作を使用すると、クライアントは指定された条件を満たすメッセージを検索し、メッセージ追跡レポート内の各メッセージに関する詳細な追跡情報を取得できます。

次の表に、メッセージ追跡操作のリストを示します。

操作名 導入バージョン
FindMessageTrackingReport 操作
Exchange 2010
GetMessageTrackingReport 操作
Exchange 2010

通知の操作

通知操作は、指定されたメールボックスのアイテムとフォルダーに関連付けられているイベントをクライアント アプリケーションに通知します。 サブスクリプション モデルは、プッシュベース、プルベース、またはストリーミングベースにすることができます。

次の表に、通知操作のリストを示します。

操作名 導入バージョン
GetEvents 操作
Exchange 2007
GetStreamingEvents の操作
Exchange 2010 SP1
サブスクライブ操作
Exchange 2007
Unsubscribe 操作
Exchange 2007

ペルソナ操作

ペルソナ操作は、リンクされた連絡先に関する情報を検索して取得するためのインターフェイスを提供します。 次の表に、ペルソナ操作のリストを示します。

操作名 導入バージョン
FindPeople 操作
Exchange 2013
GetPersona 操作
Exchange 2013

アイテム保持ポリシーの操作

アイテム保持ポリシー操作は、ユーザーのアイテム保持ポリシーにリンクされているすべての保持タグの一覧を提供します。

次の表に、アイテム保持ポリシーの操作の一覧を示します。

操作名 導入バージョン
GetUserRetentionPolicyTags 操作
Exchange 2013

サービス構成操作

サービス構成操作を使用すると、クライアントはユニファイド メッセージング、保護ルール、ポリシー ヒント、およびメール ヒント サービスの構成情報を取得できます。

次の表に、サービス構成操作のリストを示します。

操作名 導入バージョン
GetServiceConfiguration 操作
Exchange 2010

共有操作

共有操作により、クライアントは予定表データと連絡先データを共有できます。

次の表に、共有操作のリストを示します。

操作名 導入バージョン
CreateItem (AcceptSharingInvitation)
Exchange 2010。 CreateItem 操作はすべてのバージョンの EWS に適用できますが、AcceptSharingInvitation 応答オブジェクトは、Exchange 2010 以降のバージョンの Exchange の EWS にのみ適用されます。
GetSharingFolder 操作
Exchange 2010
GetSharingMetadata 操作
Exchange 2010
RefreshSharingFolder 操作
Exchange 2010

同期操作

同期操作は、ユーザーのフォルダーとアイテムの一方向の同期された、キャッシュされたコピーを提供します。

次の表に同期操作のリストを示します。

操作名 導入バージョン
SyncFolderHierarchy 操作
Exchange 2007
SyncFolderItems 操作
Exchange 2007

タイム ゾーン操作

タイム ゾーン操作を使用すると、クライアントはサーバーでサポートされているタイム ゾーン定義のリストを取得できます。

次の表に、タイム ゾーン操作のリストを示します。

操作名 導入バージョン
GetServerTimeZones 操作
Exchange 2010

ユニファイド メッセージング オペレーター

ユニファイド メッセージング操作を使用すると、クライアントはユニファイド メッセージングのプロパティに関する情報を読み取り、電話でボイス メール メッセージを再生できます。

次の表に、ユニファイド メッセージング操作のリストを示します。

操作名 導入バージョン
DisconnectPhoneCall 操作
Exchange 2010
GetPhoneCallInformation 操作
Exchange 2010
PlayOnPhone 操作 (EWS)
Exchange 2010

GetServiceConfiguration 操作を使用して、メールボックスのユニファイド メッセージング構成情報を取得します。 Exchange 2007 を対象とするユニファイド メッセージング アプリケーションには、ユニファイド メッセージング Web サービスを使用します。 詳細については、「Exchange のユニファイド メッセージング Web サービス リファレンス」を参照してください。

ユニファイド連絡先ストアの操作

ユニファイド連絡先ストアは、Office 製品間で一貫性のある連絡先操作を提供し、同じ連絡先ストアを使用するサード パーティ製アプリケーションの統合ポイントとして動作する機能です。 これにより、ユーザーとアプリケーションは連絡先情報を保存、管理、およびアクセスし、Lync、Exchange 2013、Outlook、Outlook Web App、およびユニファイド連絡先ストアへのアクセスを実装するその他のアプリケーションの間でグローバルに利用できるようになります。 Exchange は、ユニファイド連絡先ストアを利用するための連絡先ストアです。

次の表に、ユニファイド連絡先ストアの操作のリストを示します。

操作名 導入バージョン
AddNewImContactToGroup 操作
Exchange 2013
AddImContactToGroup 操作
Exchange 2013
AddImGroup 操作
Exchange 2013
AddNewTelUriContactToGroup 操作
Exchange 2013
AddDistributionGroupToImList 操作
Exchange 2013
GetImItemList 操作
Exchange 2013
GetImItems 操作
Exchange 2013
RemoveContactFromImList 操作
Exchange 2013
RemoveImContactFromGroup 操作
Exchange 2013
RemoveDistributionGroupFromImList 操作
Exchange 2013
RemoveImGroup 操作
Exchange 2013
SetImGroup 操作
Exchange 2013

ユーザー構成操作

ユーザー構成操作を使用すると、クライアントはユーザー構成情報を作成、削除、取得、および更新できます。

次の表に、ユーザー構成操作のリストを示します。

操作名 導入バージョン
CreateUserConfiguration 操作
Exchange 2010
DeleteUserConfiguration 操作
Exchange 2010
GetUserConfiguration 操作
Exchange 2010
UpdateUserConfiguration 操作
Exchange 2010

関連項目