참고
이 문서에 설명된 기능은 현재 미리 보기로 제공되며, 모든 조직에서 사용할 수 없으며 변경될 수 있습니다.
Exchange Online 관리 API는 포커스가 있는 Exchange cmdlet 및 매개 변수 집합을 POST 전용 엔드포인트로 사용하도록 설정하는 REST 기반 관리 표면입니다. API를 사용하면 2026년 10월에 사용 중단될 예정인 EWS(Exchange Web Services)를 통해 이전에 사용할 수 있었던 몇 가지 주요 작업에 액세스할 수 있습니다. API는 이러한 특정 시나리오를 위해 빌드되었으며 Exchange Online PowerShell의 전체 Exchange 관리 화면을 대체하지 않습니다.
Exchange Online 관리 API는 다음과 같은 Exchange 관리 기능 하위 집합을 지원합니다.
- organization Exchange 구성 보기: 허용된 도메인, MailTips 구성 및 사서함 제한(예: MaxSendSize)과 같은 organization 설정을 검색합니다.
- 메일 그룹 및 동적 메일 그룹 멤버 자격을 봅니다.
- 사서함 폴더 권한 보기 및 관리: 사서함에 대한 폴더 사용 권한 읽기 및 수정(권한 보기, 추가, 설정 및 제거).
- 사서함에 대한 대신 보내기(위임)를 보고 업데이트합니다.
EWS에서 멀리 마이그레이션하는 조직은 최신 자동화 및 거버넌스 패턴과 통합하면서 관리 API를 사용하여 HTTP를 통해 비슷한 cmdlet 스타일 관리를 달성할 수 있습니다.
Exchange Online 관리 API에는 다음과 같은 기능이 있습니다.
- REST 기반 cmdlet 스타일 화면: 관리 API는 집중된 Exchange 관리 작업 집합을 HTTP 엔드포인트로 노출합니다. PowerShell cmdlet을 사용하는 Exchange 관리자에게 친숙하지만 HTTP를 통해 호출합니다.
- POST 전용 작업: 모든 작업은 HTTP POST 메서드를 사용합니다. 각 요청은 선택한 엔드포인트에서 해당 cmdlet에 대해 지원되는 cmdlet 및 매개 변수를 지정합니다.
- 범위가 지정된 cmdlet 및 매개 변수 집합: API는 모든 Exchange cmdlet 또는 매개 변수를 표시하지 않습니다. 각 엔드포인트는 cmdlet의 하위 집합만 노출하고 각 cmdlet은 매개 변수의 하위 집합을 지원합니다.
- 중요 scope: API는 제한된 시나리오 organization 설정 집합, 그룹 멤버 자격, 사서함 폴더 권한 및 사서함 위임을 다룹니다. Exchange Online PowerShell을 완전히 대체하는 것은 아닙니다. 대신 이러한 특정 작업에 대한 보완적이고 REST 우선적인 표면입니다.
- 페이징 및 속성 선택: 큰 결과 집합이 페이지에 반환됩니다. 클라이언트 쪽에서는 페이로드 크기를 줄이는 데 필요한 속성만 요청할 수 있습니다.
- 라우팅 힌트: 모든 작업의 경우 API는 X-AnchorMailbox 헤더를 사용하여 요청을 올바른 백 엔드 서버로 라우팅합니다. 자세한 내용은 Exchange Online API 시작을 참조하세요.
- 보안 액세스: 호출에는 OAuth 토큰과 적절한 Exchange RBAC 역할이 필요합니다. 자세한 내용은 Exchange Online 관리 API에 대한 인증 및 권한 부여를 참조하세요.
관리 API 및 Exchange Online PowerShell
관리 API는 EWS 사용 중단의 영향을 받는 시나리오를 다루는 REST 엔드포인트로 Exchange 관리 기능의 대상 하위 집합을 제공합니다. Exchange Online PowerShell은 완전한 Exchange 관리 화면을 계속 제공합니다.
- 관리 API: 이전에 설명한 시나리오(organization 구성, 그룹 멤버 자격, 폴더 권한 및 위임)에 대한 REST 우선 cmdlet과 동등한 표면이 필요한 경우에만 사용합니다.
- powerShell Exchange Online: Exchange cmdlet, 고급 작업 또는 기존 PowerShell 스크립트 및 Runbook의 전체 범위가 필요한 경우에 사용합니다.
Exchange Online 관리 API는 Exchange Online PowerShell을 대체하는 것이 아닙니다. API는 사용되지 않는 EWS 시나리오로 인한 집중된 관리 작업 집합에 대한 보완적인 REST 기반 표면입니다. 다른 모든 Exchange 관리 작업의 경우 계속해서 Exchange Online PowerShell을 사용합니다.
API 엔드포인트 Exchange Online 관리
각 관리 API 엔드포인트는 EWS를 통해 이전에 사용할 수 있었던 기능을 대체할 하나 이상의 cmdlet을 제공합니다. 다음 표에서는 각 엔드포인트 및 해당 EWS 대안에 대한 세부 정보를 제공합니다.
| 끝점 | 설명 | EWS 작업 |
|---|---|---|
| OrganizationConfig | MailTips 설정과 관련된 organization 수준 Exchange 구성을 검색합니다. | GetServiceConfiguration |
| AcceptedDomain | organization 대해 허용된 도메인 및 해당 구성을 봅니다. | GetServiceConfiguration |
| 메일함 | 사서함 속성을 봅니다. 예를 들어 표시 이름, 기본 SMTP 주소, 크기 제한 및 대리자 정보(보기 및 업데이트)가 있습니다. | AddDelegate 및 RemoveDelegate |
| MailboxFolderPermission | 사서함 폴더(사용 권한 추가, 설정 및 제거)에 대한 권한을 보고 관리합니다. | GetFolder, UpdateFolder 및 CreateFolder |
| DistributionGroupMember | 메일 그룹에 대한 멤버 자격 세부 정보를 검색합니다. | ExpandDL |
| DynamicDistributionGroupMember | 동적 메일 그룹에 대한 멤버 자격 세부 정보를 검색합니다. | ExpandDL |