Übersicht über die Exchange Online Admin API

Hinweis

Die in diesem Artikel beschriebenen Features befinden sich derzeit in der Vorschauphase, sind nicht in allen Organisationen verfügbar und können sich ändern.

Die Exchange Online Admin-API ist eine REST-basierte Verwaltungsoberfläche, die einen fokussierten Satz von Exchange-Cmdlets und -Parametern als POST-Only-Endpunkte ermöglicht. Die API ermöglicht den Zugriff auf einige wichtige Aufgaben, die zuvor über Exchange Web Services (EWS) verfügbar waren, deren Einstellung für Oktober 2026 geplant ist. Die API ist für diese speziellen Szenarien konzipiert und ersetzt nicht die vollständige Exchange-Verwaltungsoberfläche in Exchange Online PowerShell.

Die Exchange Online Admin API unterstützt die folgende Teilmenge der Exchange-Verwaltungsfunktionen:

  • Anzeigen der Exchange-Konfiguration der organization: Rufen Sie die Einstellungen der organization ab, z. B. akzeptierte Domänen, E-Mail-Info-Konfiguration und Postfachlimits (z. B. MaxSendSize).
  • Anzeigen der Mitgliedschaft in Verteilergruppen und dynamischen Verteilergruppen.
  • Anzeigen und Verwalten von Postfachordnerberechtigungen: Lesen und ändern Sie Ordnerberechtigungen für Postfächer (Anzeigen, Hinzufügen, Festlegen und Entfernen von Berechtigungen).
  • Anzeigen und Aktualisieren von "Senden im Auftrag von" (Delegierung) für Postfächer.

Organisationen, die von EWS migrieren, können die Admin-API verwenden, um eine vergleichbare Verwaltung im Cmdlet-Stil über HTTP zu erreichen und gleichzeitig moderne Automatisierungs- und Governancemuster zu integrieren.

Die Exchange Online Admin API verfügt über die folgenden Features:

  • REST-basierte Oberfläche im Cmdlet-Stil: Die Admin-API macht einen fokussierten Satz von Exchange-Verwaltungsaufgaben als HTTP-Endpunkte verfügbar. Exchange-Administratoren, die PowerShell-Cmdlets verwenden, sollten vertraut vorkommen, aber Sie nennen es über HTTP.
  • POST-Only-Vorgänge: Jeder Vorgang verwendet die HTTP POST-Methode. Jede Anforderung gibt ein Cmdlet und die Parameter an, die für dieses Cmdlet im ausgewählten Endpunkt unterstützt werden.
  • Bereichsbezogener Satz von Cmdlets und Parametern: Die API zeigt nicht jedes Exchange-Cmdlet oder jeden Exchange-Parameter an. Jeder Endpunkt macht nur eine Teilmenge von Cmdlets verfügbar, und jedes Cmdlet unterstützt eine Teilmenge von Parametern.
  • Fokussierter Bereich: Die API deckt eine begrenzte Anzahl von Szenarien ab: Einstellungen für die organization, Gruppenmitgliedschaft, Berechtigungen für Postfachordner und Postfachdelegierung. Es ist kein vollständiger Ersatz für Exchange Online PowerShell. Stattdessen ist es eine ergänzende, REST-orientierte Oberfläche für diese spezifischen Aufgaben.
  • Paging und Eigenschaftsauswahl: Große Resultsets werden in Seiten zurückgegeben. Auf der Clientseite können Sie nur die Eigenschaften anfordern, die Sie benötigen, um die Nutzlastgröße zu reduzieren.
  • Routinghinweise: Für alle Vorgänge verwendet die API den X-AnchorMailbox-Header , um Ihre Anfrage an den richtigen Back-End-Server weiterzuleiten. Weitere Informationen finden Sie unter Erste Schritte mit der Exchange Online-API.
  • Sicherer Zugriff: Anrufe erfordern OAuth-Token und entsprechende Exchange RBAC-Rollen. Weitere Informationen finden Sie unter Authentifizierung und Autorisierung für die Exchange Online Admin-API.

Admin-API im Vergleich zu Exchange Online PowerShell

Die Admin-API bietet eine gezielte Teilmenge von Exchange-Verwaltungsfunktionen als REST-Endpunkte, um Szenarien abzudecken, die von der Abschaffung von EWS betroffen sind. Exchange Online PowerShell bietet weiterhin die vollständige Exchange-Verwaltungsoberfläche.

  • Admin-API: Verwenden Sie diese Option, wenn Sie eine REST-First-Cmdlet-äquivalente Oberfläche nur für die zuvor beschriebenen Szenarien (organization config, group membership, folder permissions and delegation) benötigen.
  • Exchange Online PowerShell: Verwenden Sie es, wenn Sie die gesamte Bandbreite von Exchange-Cmdlets, erweiterte Vorgänge oder vorhandene PowerShell-Skripte und Runbooks benötigen.

Die Exchange Online Admin-API ist kein Ersatz für Exchange Online PowerShell. Die API ist eine ergänzende, REST-basierte Oberfläche für eine Reihe von Verwaltungsaufgaben, die durch die veralteten EWS-Szenarien verursacht werden. Verwenden Sie für alle anderen Exchange-Verwaltungsaufgaben weiterhin Exchange Online PowerShell.

Exchange Online Admin API-Endpunkte

Jeder Admin-API-Endpunkt stellt mindestens ein Cmdlet bereit, um Funktionen zu ersetzen, die zuvor über EWS verfügbar waren. Die folgende Tabelle enthält Details zu jedem Endpunkt und der entsprechenden EWS-Alternative.

Endpunkt Beschreibung EWS-Vorgang
OrganizationConfig Rufen Sie die Exchange-Konfiguration auf organization-Ebene ab, die sich auf E-Mail-Info-Einstellungen bezieht. GetServiceConfiguration
Accepteddomain Zeigen Sie akzeptierte Domänen und deren Konfigurationen für die organization an. GetServiceConfiguration
Postfach Postfacheigenschaften anzeigen. Beispiel: Anzeigename, primäre SMTP-Adresse, Größenbeschränkungen und Stellvertretungsinformationen (Anzeigen und Aktualisieren). AddDelegate und RemoveDelegate
MailboxFolderPermission Anzeigen und Verwalten von Berechtigungen für Postfachordner (Hinzufügen, Festlegen und Entfernen von Berechtigungen). GetFolder, UpdateFolder und CreateFolder
DistributionGroupMember Abrufen von Mitgliedschaftsdetails für Verteilergruppen. ExpandDL
DynamicDistributionGroupMember Abrufen von Mitgliedschaftsdetails für dynamische Verteilergruppen. ExpandDL

Nächste Schritte

  • Zuletzt aktualisiert um