Exchange で EWS を使用してアイテムを削除する
Exchange で EWS マネージ API または EWS を使用して、アイテムを削除済みアイテム フォルダーまたはごみ箱に移動して削除する方法について説明します。
アイテムを削除済みアイテム フォルダーに移動することと、ごみ箱に移動することにどんな違いがあるか考えたことがおありですか。 削除されたアイテムを処理する別のオプションや、アプリケーションでそれらのオプションを実装する方法について興味を持たれるかもしれません。 Exchange Web サービス (EWS) には、削除されたアイテムを処理する 3 つのオプションが含まれています。 この記事を読むことによって、それらの違いについての混乱をすべて解決できることでしょう。
アイテムを削除する場合のオプション
アイテムを削除する際の全体的な概要を理解する前に、次の違いを認識することが重要です。
削除済みアイテム フォルダー - メールボックスでアイテムを削除すると、アイテムはここに移動されます。
ごみ箱 (回復可能なアイテム フォルダー) - メールボックスからアイテムを削除すると、アイテムはここに移動されます。
図 1 と図 2 は、メールボックスのアイテムとフォルダーの削除処理がどのようなものかを示しています。
図 1. メールボックスからアイテムを削除するためのプロセス
図 2. メールボックスからフォルダーを削除するためのプロセス
![削除されたフォルダーが [削除済みアイテム] フォルダーに移動された後、メールボックスから完全に削除される仕組みを示す図。](media/ex_.png)
削除の「永続性」に応じて、アイテムとフォルダーは 3 つの方法で削除できます。
表 1. EWS を使用してアイテムを削除する場合のオプション
| オプション | 結果 |
|---|---|
| 削除済みアイテム フォルダーに移動する |
これは、アイテムを削除する方法のなかで最も永続性が低いものです。 これは、自分の席の横にあるごみ箱に紙を捨てることに似ています。 必要であれば、もう一度簡単に取り出すことができます。 この操作を実行するには、削除済みアイテム フォルダーに移動するオプションを実装する任意の削除操作を使用できます。 また、MoveItem 操作 (Item.Move()) または MoveFolder 操作 (Folder.Move()) を使用して、アイテムまたはフォルダーを削除済みアイテム フォルダーに移動することもできます。 |
| 論理的な削除 |
アイテムはごみ箱の削除フォルダーに移動されます。 これは、ごみ箱の中身を収集用のコンテナーに移して空にするのと同様です。 必要であれば、少し面倒ではありますが、そのアイテムにアクセスすることはまだ可能です。 ごみ箱 (回復可能なアイテム フォルダーとも呼ばれる) および電子情報開示や訴訟ホールドなどのシナリオの詳細については、TechNet の「回復可能なアイテム フォルダー」を参照してください。 Exchange 2007 を対象とするアプリケーションの場合、論理的な削除はお勧めしません。 Exchange 2007 で論理的な削除を処理するには、アイテムで、そのアイテムが不特定の時間にごみ箱に移動されることを示すビットを設定します。 論理的な削除の走査、つまり FindItem Operation によって削除済みアイテム フォルダーに移動されたアイテムの検索は、Exchange Online、Office 365 の一部としての Exchange Online、Exchange 2010 以降のバージョンの Exchange ではサポートされていません。 注: フォルダーを論理的に削除することはできません。 |
| 物理的な削除 |
アイテムまたはフォルダーが完全に削除されます。 物理的に削除されたアイテムはごみ箱の Purges フォルダーに配置されます。 これは、ごみ収集車が収集用のコンテナーを空にするのと同じです。 Outlook または Outlook Web App のような電子メール クライアントからはこれらのアイテムにアクセスできず、メールボックスに保持設定がない限り、アイテムは一定期間後に完全に削除されます。 アイテムの保存期間については、TechNet の「削除済みアイテムの保存期間と回復可能なアイテムのクォータを構成する」の記事を参照してください。 注: フォルダーは、ハード削除された場合、Purges フォルダーに配置されません。 物理的に削除されたフォルダーは、メールボックスから削除されます。 |
削除済みアイテム フォルダーへの移動および物理的な削除のオプションはトランザクションです。これは、Web サービス呼び出しが完了するまでに、アイテムが削除済みアイテム フォルダーまたはごみ箱に移動されていることを意味します。
削除済みアイテムの格納に使用されるフォルダーのエコシステムについて理解するために、次の図は、削除済みアイテムを含めることができるフォルダーの階層を示しています。 フォルダー名は、DistinguishedFolderIdNameType スキーマの種類、または EWS マネージ API の WellKnownFolderName 列挙体の場合と同じように表示されています。
図 3. 削除済みアイテムを含むフォルダーの階層
表 2. 削除済みアイテムを格納するフォルダー
| フォルダー名 | 導入バージョン | 説明 |
|---|---|---|
| deleteditems |
Exchange 2007 |
既定の削除済みアイテム フォルダー。 アイテムは、論理的な削除によって削除されるか、物理的に削除されるまで、または保存期間が超えるまでこのフォルダーに残ります。 次に、このアイテムはごみ箱内のフォルダーに移動されます。 削除済みフォルダーは、削除済みアイテム フォルダーに配置されており、論理的な削除によって削除されるか、物理的に削除されるときに、メールボックスから完全に削除され、回復できなくなります。 |
| recoverableitemsroot |
Exchange 2010 |
ごみ箱、つまり回復可能なアイテム フォルダーのルート。 Exchange 2010 の EWS では、ごみ箱へのアクセスが実装されています。 このフォルダーの表示名は、「回復可能なアイテム」です。 |
| recoverableitemsdeletions |
Exchange 2010 |
メールボックスのメインごみ箱フォルダー。 アイテム保持ポリシーによって、論理的な削除によって削除されたアイテムおよび削除済みアイテム フォルダーから移動されたアイテムは、このフォルダーに配置されます。 このフォルダーの表示名は、「削除」です。 |
| recoverableitemsversions |
Exchange 2010 |
以前のバージョンのアイテムが格納されます。 以前のバージョンのアイテムは、アイテムが更新されたときに作成されます。 下書きバージョンのアイテムはこのフォルダーに保存されません。 このフォルダーの表示名は、「バージョン」です。 |
| recoverableitemspurges |
Exchange 2010 |
削除フォルダーから削除されるアイテムが格納されます。 記憶域で物理的に削除されたすべてのアイテムは、このフォルダーに移動されます。 このフォルダーの表示名は、「Purges」です。 |
| archiveddeletedtitems |
Exchange 2010 |
アーカイブ メールボックスの既定の削除済みアイテム フォルダー。 |
| archiverecoverablesitemsroot |
Exchange 2010 |
アーカイブ メールボックスのルートごみ箱フォルダー。 論理的な削除によって削除されたアーカイブ アイテムは、このフォルダーのサブフォルダーに移動されます。 |
| archiverecoverableitemsdeletions |
Exchange 2010 |
アーカイブ メールボックスのメインごみ箱フォルダー。 ごみ箱に移動されたアーカイブ アイテムはここに配置されます。 |
| archiverecoverableitemsversions |
Exchange 2010 |
以前のバージョンのアーカイブ アイテムが格納されます。 |
| archiverecoverableitemspurges |
Exchange 2010 |
ごみ箱のアーカイブ削除フォルダーにある物理的に削除されたアイテムが格納されます。 記憶域で物理的に削除されたすべてのアーカイブ アイテムは、このフォルダーに移動されます。 |
アイテムを削除する方法
次のいずれかを使用して、削除済みアイテム フォルダーにアイテムを移動するか、論理的な削除または物理的な削除を実行するかどうかを指定します。
DisposalType の単純型 (EWS を使用して Exchange にアクセスする場合)。
DeleteMode 列挙型 (EWS マネージ API を使用する場合)。
複数の異なる EWS 操作または EWS マネージ API メソッドを使用して、メールボックスからアイテムやフォルダーを削除できます。
表 3. アイテムを削除するための EWS 操作と EWS マネージ API メソッド
| EWS 操作 | EWS マネージ API メソッド | 導入バージョン | 機能 |
|---|---|---|---|
| DeleteFolder 操作 |
Folder.Delete メソッド |
Exchange 2007 |
メールボックスからフォルダーを削除します。 EWS では、フォルダーをバッチ削除できます。 EWS マネージ API では、呼び出しごとに 1 つのフォルダーのみを削除できます。 |
| DeleteItem 操作 |
Item.Delete メソッド ExchangeService.DeleteItems メソッド |
Exchange 2007 |
メールボックスからアイテムを削除します。 |
| EmptyFolder 操作 |
Folder.Empty メソッド |
Exchange 2010 |
フォルダー内のすべての項目を削除します。必要に応じて、フォルダー内のすべてのサブフォルダーも削除します。 |
| ApplyConversationAction 操作 |
Conversation.EnableAlwaysDeleteItems メソッド Conversation.DeleteItems メソッド |
Exchange 2010 |
会話の電子メール メッセージに対して削除処理アクションを設定し、それらが削除されるようにします。 |
| DeleteUserConfiguration 操作 |
UserConfiguration.Delete メソッド |
Exchange 2010 |
アイテムに関連付けられているフォルダーを削除し、ごみ箱に移動します。 |
| CreateItem 操作 |
Appointment.Accept メソッド Appointment.AcceptTentatively メソッド Appointment.CancelMeeting メソッド Appointment.Decline MeetingRequest.Accept メソッド MeetingRequest.AcceptTentatively メソッド MeetingRequest.Decline メソッド |
Exchange 2007 |
会議出席依頼への応答が送信されるか、応答が予定に設定されるたびに、アイテムを削除済みアイテム フォルダーに間接的に移動します。 削除の種類は、この操作では設定されません。 応答オブジェクトがサービスによって正常に処理されると、会議のメッセージは削除済みアイテム フォルダーに移動されます。 |
受信トレイ ルールを使用して、削除済みアイテム フォルダーにアイテムを移動することもできます。 たとえば、削除アクションを含むルールを作成することができます。
アイテムを削除する場合の注意点:
定期的な発生アイテムを削除しても、削除済みアイテム フォルダーまたはごみ箱への移動は行われません。 これにより、定期的なアイテムの定期的マスター アイテムが更新されます。
既定のフォルダーはメールボックスから削除できません。
会議または会議のメッセージ (会議出席依頼または会議の更新など) は削除しないでください。 代わりに、応答オブジェクトを使用してこれらのアイテムに対応します。 これで、関連付けられている予定表アイテムが更新され、レスポンダーまたは開催者のアクションが反映されます。
アイテムが削除済みアイテムまたは削除フォルダーに移動されている場合、アイテムのキーの変更は更新されません。
アイテムの物理的な削除を実行してから、SyncFolderHierarchy 操作や SyncFolderHierarchy EWS マネージ API メソッド、または SyncFolderItems 操作や SyncFolderItems メソッドを呼び出すと、Delete 変更エントリが返されます。 アイテムを削除済みアイテム フォルダーに移動すると、Update 変更エントリが返されます。 これは、アイテムまたはフォルダーが新しい ParentFolderId プロパティ値を持つためです。 削除済みアイテムの同期がシナリオの一部になっている場合は、同期について参照してください。
アイテムの削除についての詳細
関連項目
- Exchange の EWS のフォルダーとアイテム
- Exchange の Web サービス クライアントを開発する
- 回復可能なアイテム フォルダー
- Exchange Server 2010 での単一アイテムの回復
- Exchange 2013: Exchange サーバーからプログラムを使用して定期的なアイテムを削除する
- Exchange 2013: プログラムを使用して Exchange サーバー上のアカウントからタスクを削除する
- Exchange 2013: プログラムを使用して Exchange サーバー上のフォルダーを空にする
- Exchange 2013: Exchange サーバーからプログラムを使用してフォルダーを削除する
- Exchange 2013: Exchange サーバーからプログラムを使用して多くのアイテムを削除する
- Exchange 2013: Exchange サーバーからプログラムを使用して連絡先を削除する
- Exchange の EWS を使用して、予定を削除し、会議をキャンセルする
- Exchange で EWS を使用して永続的なアプリケーションの設定を管理する
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示