注:
この記事で説明されている機能は現在プレビュー段階であり、すべての組織で利用できるわけではありません。変更される可能性があります。
Exchange Online 管理 API は、EXCHANGE コマンドレットとパラメーターの集中セットを POST 専用エンドポイントとして有効にする REST ベースの管理サーフェイスです。 この API を使用すると、 2026 年 10 月に廃止予定の Exchange Web Services (EWS) を通じて以前に利用できたいくつかの重要なタスクにアクセスできます。 API はこれらの特定のシナリオ用に構築されており、PowerShell の Exchange 管理画面全体Exchange Online置き換えるわけではありません。
Exchange Online 管理 API では、Exchange 管理機能の次のサブセットがサポートされています。
- Exchange 構成organization表示する: 承認済みドメイン、メール ヒントの構成、メールボックスの制限 (MaxSendSize など) などのorganization設定を取得します。
- 配布グループと動的配布グループのメンバーシップを表示します。
- メールボックス フォルダーのアクセス許可の表示と管理: メールボックスのフォルダーのアクセス許可の読み取りと変更 (アクセス許可の表示、追加、設定、削除)。
- メールボックスの代理送信 (委任) を表示して更新します。
EWS から移行する組織は、管理 API を使用して、最新の自動化とガバナンス パターンと統合しながら、HTTP に対する同等のコマンドレット スタイルの管理を実現できます。
Exchange Online 管理 API には、次の機能があります。
- REST ベースのコマンドレット スタイルの画面: 管理 API は、Exchange 管理タスクの集中セットを HTTP エンドポイントとして公開します。 PowerShell コマンドレットを使用する Exchange 管理者にはなじみがありますが、HTTP 経由で呼び出す必要があります。
- POST のみの操作: すべての操作で HTTP POST メソッドが使用されます。 各要求では、コマンドレットと、選択したエンドポイントでそのコマンドレットでサポートされているパラメーターを指定します。
- スコープ付きコマンドレットとパラメーターのセット: API では、すべての Exchange コマンドレットまたはパラメーターが表示されるわけではありません。 各エンドポイントはコマンドレットのサブセットのみを公開し、各コマンドレットはパラメーターのサブセットをサポートします。
- 対象範囲: API では、シナリオの制限されたセット (organization設定、グループ メンバーシップ、メールボックス フォルダーのアクセス許可、メールボックスの委任) について説明します。 Exchange Online PowerShell の完全な置き換えではありません。 代わりに、これらの特定のタスクの補完的な REST 優先サーフェスです。
- ページングとプロパティの選択: 大きな結果セットがページで返されます。 クライアント側では、ペイロード サイズを小さくするために必要なプロパティのみを要求できます。
- ルーティング ヒント: すべての操作で、API は X-AnchorMailbox ヘッダーを使用して、要求を正しいバックエンド サーバーにルーティングします。 詳細については、「Exchange Online API の概要」を参照してください。
- セキュリティで保護されたアクセス: 呼び出しには、OAuth トークンと適切な Exchange RBAC ロールが必要です。 詳細については、「Exchange Online 管理 API の認証と承認」を参照してください。
管理 API と PowerShell Exchange Online
管理 API は、EWS 非推奨の影響を受けるシナリオに対応するために、EXCHANGE 管理機能の対象となるサブセットを REST エンドポイントとして提供します。 Exchange Online PowerShell は引き続き完全な Exchange 管理画面を提供します。
- 管理 API: 前に説明したシナリオ (構成、グループ メンバーシップ、フォルダーのアクセス許可、委任organization) に対してのみ、REST 優先のコマンドレットと同等のサーフェスが必要な場合に使用します。
- PowerShell のExchange Online: Exchange コマンドレット、高度な操作、または既存の PowerShell スクリプトと Runbook の完全な幅を必要とする場合に使用します。
Exchange Online 管理 API は、Exchange Online PowerShell の代わりではありません。 API は、非推奨の EWS シナリオによって引き起こされる一連の管理タスクに焦点を当てた REST ベースの補完的なサーフェスです。 その他のすべての Exchange 管理タスクについては、引き続き powerShell Exchange Online使用してください。
EXCHANGE ONLINE 管理 API エンドポイント
各管理 API エンドポイントには、EWS で以前に使用できる機能を置き換えるコマンドレットが 1 つ以上用意されています。 次の表に、各エンドポイントと対応する EWS の代替方法の詳細を示します。
| エンドポイント | 説明 | EWS 操作 |
|---|---|---|
| OrganizationConfig | メール ヒント設定に関連organizationレベルの Exchange 構成を取得します。 | GetServiceConfiguration |
| AcceptedDomain | organizationの承認済みドメインとその構成を表示します。 | GetServiceConfiguration |
| Mailbox | メールボックスのプロパティを表示します。 たとえば、表示名、プライマリ SMTP アドレス、サイズ制限、デリゲート情報 (ビューと更新)。 | AddDelegate と RemoveDelegate |
| MailboxFolderPermission | メールボックス フォルダーに対するアクセス許可の表示と管理 (アクセス許可の追加、設定、削除)。 | GetFolder、UpdateFolder、CreateFolder |
| DistributionGroupMember | 配布グループのメンバーシップの詳細を取得します。 | ExpandDL |
| DynamicDistributionGroupMember | 動的配布グループのメンバーシップの詳細を取得します。 | ExpandDL |