Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 REINE POST-Endpunkte ermöglicht. Die API ermöglicht den Zugriff auf einige wichtige Aufgaben, die zuvor über Exchange-Webdienste (EWS) verfügbar waren, die im Oktober 2026 eingestellt werden sollen. Die API ist für diese spezifischen Szenarien entwickelt 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 organization Exchange-Konfiguration: Rufen Sie organization Einstellungen wie akzeptierte Domänen, E-Mail-Info-Konfiguration und Postfachgrenzwerte (z. B. MaxSendSize) ab.
- Anzeigen der Mitgliedschaft in Verteilergruppen und dynamischen Verteilergruppen.
- Anzeigen und Verwalten von Postfachordnerberechtigungen: Lesen und Ändern von Ordnerberechtigungen für Postfächer (Anzeigen, Hinzufügen, Festlegen und Entfernen von Berechtigungen).
- Anzeigen und Aktualisieren von Senden im Auftrag (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. Es sollte Exchange-Administratoren vertraut sein, die PowerShell-Cmdlets verwenden, aber Sie rufen es über HTTP auf.
- Nur POST-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 alle Exchange-Cmdlets oder -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 einen begrenzten Satz von Szenarios organization Einstellungen, Gruppenmitgliedschaft, Postfachordnerberechtigungen und Postfachdelegierung ab. Es ist kein vollständiger Ersatz für Exchange Online PowerShell. Stattdessen handelt es sich um eine ergänzende REST-First-Oberfläche für diese spezifischen Aufgaben.
- Paging und Eigenschaftenauswahl: Große Resultsets werden auf Seiten zurückgegeben. Auf der Clientseite können Sie nur die Eigenschaften anfordern, die Sie zum Reduzieren der Nutzlastgröße benötigen.
- Routinghinweise: Für alle Vorgänge verwendet die API den X-AnchorMailbox-Header , um Ihre Anforderung an den richtigen Back-End-Server weiterzuleiten. Weitere Informationen finden Sie unter Erste Schritte mit der Exchange Online-API.
- Sicherer Zugriff: Für Aufrufe sind OAuth-Token und die entsprechenden Exchange RBAC-Rollen erforderlich. 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 der Exchange-Verwaltungsfunktionen als REST-Endpunkte, um Szenarien abzudecken, die von der Veraltung von EWS betroffen sind. Exchange Online PowerShell stellt weiterhin die gesamte Exchange-Verwaltungsoberfläche bereit.
- Admin-API: Verwenden Sie nur, wenn Sie eine REST-First-, Cmdlet-äquivalente Oberfläche für die zuvor beschriebenen Szenarien (organization Konfiguration, Gruppenmitgliedschaft, Ordnerberechtigungen und Delegierung) benötigen.
- Exchange Online PowerShell: Verwenden Sie diese Option, wenn Sie die gesamte Bandbreite von Exchange-Cmdlets, erweiterten Vorgängen oder vorhandenen PowerShell-Skripts 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 administrativen Aufgaben, 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 organization Exchange-Konfiguration im Zusammenhang mit E-Mail-Info-Einstellungen ab. | GetServiceConfiguration |
| Accepteddomain | Zeigen Sie akzeptierte Domänen und deren Konfigurationen für die organization an. | GetServiceConfiguration |
| Postfach | Anzeigen von Postfacheigenschaften. 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 |