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 |