OrganizationConfig-Endpunkt in der 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.

Der OrganizationConfig-Endpunkt in der Exchange Online Admin-API ruft organization einstellungen im Zusammenhang mit MailTips und einigen anderen zugehörigen Dienstkonfigurationen ab.

Die Exchange Online Admin-API bietet eine REST-basierte Möglichkeit zum Ausführen bestimmter PowerShell-Cmdlets, die legacy-Szenarien für Exchange-Webdienste (EWS) ersetzen. Weitere Informationen finden Sie unter Übersicht über die Exchange Online Admin-API.

Endpunkt-URL

POST https://outlook.office365.com/adminapi/v2.0/<TenantID>/OrganizationConfig

Tipp

Verwenden Sie die Basis-URL für Ihre Umgebung, wie unter Unterstützte Umgebungen und Basis-URLs beschrieben.

Anforderungsmodell

Header

Authorization: Bearer <auth token>
Content-Type: application/json
X-AnchorMailbox: <routing hint>

Informationen zu X-AnchorMailbox-Werten finden Sie unter X-AnchorMailbox-Routinghinweis.

Body

{
  "CmdletInput": {
    "CmdletName": "Get-OrganizationConfig"
  }
}

Paginierung

Die Paginierung ist nicht verfügbar. Das Cmdlet Get-OrganizationConfig gibt ein einzelnes organization-Konfigurationsobjekt zurück.

Unterstützte Cmdlets und Parameter

Das unterstützte Cmdlet für diesen Endpunkt ist Get-OrganizationConfig. Jedes andere Cmdlet im Text dieses Endpunkts führt zu einem Fehler.

Über den REST-Endpunkt sind keine Parameter für das Cmdlet Get-OrganizationConfig verfügbar.

Antwortübersicht

Hinweis

Während der Vorschau enthält der Endpunkt die vollständige Ausgabe des Cmdlets Get-OrganizationConfig in der API-Antwort. Während des Übergangs zur öffentlichen Version ist die Antwort auf die in diesem Abschnitt aufgeführten Kerneigenschaften beschränkt (Eigenschaften, die für das EWS-äquivalente Szenario erforderlich sind). Es wird empfohlen, nur die in diesem Abschnitt aufgeführten Eigenschaften zu verwenden. Wir dokumentieren alle Änderungen an den verfügbaren Eigenschaften.

Die Get-OrganizationConfig-Antwort ist ein einzelnes JSON-Objekt, das die Einstellungen auf organization-Ebene darstellt. Die folgenden Eigenschaften werden zurückgegeben:

• Name: Exchange-Anzeigename für das organization-Konfigurationsobjekt (es gibt nur eines in einem organization).
• Identität: Kanonische Identität, die von Exchange verwendet wird (spiegelt häufig den Wert Name wieder).
• ID: Dienstbezeichner für das organization-Konfigurationsobjekt.
• Guid: Stabile GUID des organization Konfigurationsobjekts.
• MailTipsAllTipsEnabled: Gibt an, ob E-Mail-Infos für alle Tipps aktiviert sind. Der Standardwert ist True.
• MailTipsExternalRecipientsTipsEnabled: Gibt an, ob E-Mail-Infos für externe Empfänger angezeigt werden. Der Standardwert ist False.
• MailTipsLargeAudienceThreshold: Schwellenwert für große Zielgruppen, der sich auf das E-Mail-Info-Verhalten auswirkt. Der Standardwert ist 25.

Beispiele

• Beispiel 1:

  In diesem Beispiel wird die organization-weite Konfiguration zurückgegeben, einschließlich E-Mail-Info-Einstellungen und Hauptfunktionsflags.

  POST /adminapi/v2.0/<TenantID>/OrganizationConfig HTTP/1.1
  Host: outlook.office365.com
  Authorization: Bearer <auth token>
  Content-Type: application/json
  X-AnchorMailbox: <Routing Hint>
  
  {
    "CmdletInput": {
      "CmdletName": "Get-OrganizationConfig"
    }
  }