注意事項
本文所述的功能目前處於預覽階段,並非所有組織都能提供,且可能會有所變動。
Exchange Online 管理員 API 中的 OrganizationConfig 端點可取得與 MailTips 及其他幾項相關服務配置相關的組織整體設定。
Exchange Online 管理員 API 提供基於 REST 的方式來執行特定的 PowerShell 指令集,取代舊有的 Exchange Web Services (EWS) 情境。 欲了解更多資訊,請參閱 Exchange Online 管理員 API 概述。
端點網址
POST https://outlook.office365.com/adminapi/v2.0/<TenantID>/OrganizationConfig
提示
請依照 支援環境和基礎網址描述,使用你環境的基礎網址。
請求模型
標頭
Authorization: Bearer <auth token>
Content-Type: application/json
X-AnchorMailbox: <routing hint>
關於 X-AnchorMailbox 的值,請參見 X-AnchorMailbox 路由提示。
內文
{
"CmdletInput": {
"CmdletName": "Get-OrganizationConfig"
}
}
Pagination
分頁功能無法提供。 Get-OrganizationConfig 指令檔會回傳一個組織設定物件。
支援的指令集與參數
此端點支援的 cmdlet 是 Get-OrganizationConfig。 若該端點主體中有任何其他指令檔,則會導致錯誤。
透過 REST 端點, Get-OrganizationConfig 指令檔的參數無法取得。
回應概述
注意事項
在預覽階段,端點會將完整的 Get-OrganizationConfig 指令碼輸出納入 API 回應中。 在轉為公開釋放期間,回應將限於本節列出的核心物業 (符合EWS等效情境) 所需的物業。 我們建議您僅使用本節列出的物業。 我們會記錄任何可用物業的變更。
Get-OrganizationConfig 回應是一個代表組織層級設定的單一 JSON 物件。 會傳回下列屬性:
- 名稱: (組織) 中只有一個,組織設定物件的顯示名稱。
- 身份:Exchange (使用的標準身份通常與 名稱 值) 鏡像。
- ID:組織組態物件的服務識別碼。
- Guid:組織配置物件的穩定 GUID。
-
MailTipsAllTipsEnabled:顯示所有提示是否啟用郵件提示。 預設值為
True。 -
MailTipsExternalRecipientsTipsEnabled:顯示外部收件人是否會顯示郵件小費。 預設值為
False。 - MailTipsLargeAudienceThreshold:針對大型受眾設置的門檻,影響 MailTips 的行為。 預設值是 25。
範例
範例 1:
此範例會回傳組織整體的配置,包括 MailTips 設定與核心功能旗標。
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" } }