注:
この記事で説明する機能は現在プレビュー段階であり、すべての組織で利用できるわけではなく、変更される可能性があります。
Exchange Online 管理 API は REST ベースの管理サーフェイスであり、集中した一連の Exchange コマンドレットとパラメーターを POST 専用エンドポイントとして有効にします。 この API を使用すると、 2026 年 10 月に廃止が予定されている Exchange Web サービス (EWS) を通じて以前は利用可能だったいくつかの主要なタスクにアクセスできるようになります。 この API は、これらの特定のシナリオ用に構築されており、Exchange Online PowerShell の完全な Exchange 管理画面に取って代わるものではありません。
Exchange Online 管理 API は、Exchange 管理関数の次のサブセットをサポートします。
- organization Exchange 構成の表示: 承認済みドメイン、メール ヒント構成、メールボックスの制限 (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 と Exchange Online PowerShell
管理 API は、EWS の廃止の影響を受けるシナリオをカバーするため、対象となる Exchange 管理機能のサブセットを REST エンドポイントとして提供します。 Exchange Online PowerShell は引き続き完全な Exchange 管理画面を提供します。
- 管理 API: 前述のシナリオ (organization 構成、グループ メンバーシップ、フォルダーのアクセス許可、および委任) にのみ、REST 優先のコマンドレットと同等のサーフェスが必要な場合に使用します。
- Exchange Online PowerShell: Exchange コマンドレット、高度な操作、または既存の PowerShell スクリプトと Runbook のすべてが必要な場合に使用します。
Exchange Online 管理 API は、Exchange Online PowerShell の代わりではありません。 この API は、非推奨の EWS シナリオによって発生した一連の集中的な管理タスクを補完する REST ベースのサーフェスです。 他のすべての Exchange 管理タスクについては、引き続き Exchange Online PowerShell を使用します。
Exchange Online 管理 API エンドポイント
各管理 API エンドポイントには、EWS を介して以前に使用可能だった機能を置き換える 1 つ以上のコマンドレットが用意されています。 次の表に、各エンドポイントと対応する EWS の代替手段の詳細を示します。
| エンドポイント | 説明 | EWS 操作 |
|---|---|---|
| OrganizationConfig | メール ヒントの設定に関連する、organization レベルの Exchange 構成を取得します。 | GetServiceConfiguration |
| AcceptedDomain | View Accepted Domains and their configuration for the organization. | GetServiceConfiguration |
| Mailbox | メールボックスのプロパティを表示します。 例: 表示名、プライマリ SMTP アドレス、サイズ制限、代理人情報 (表示と更新)。 | AddDelegate および RemoveDelegate |
| MailboxFolderPermission | メールボックス フォルダーのアクセス許可の表示と管理 (アクセス許可の追加、設定、削除) | GetFolder、UpdateFolder、および CreateFolder |
| DistributionGroupMember | 配布グループのメンバーシップの詳細を取得します。 | ExpandDL |
| DynamicDistributionGroupMember | 動的配布グループのメンバーシップの詳細を取得します。 | ExpandDL |