使用 ExtensionSettings 政策設定擴充功能的詳細指南

Microsoft Edge 提供多種管理擴充功能的方法。 一般的方法就是使用 JSON 字串在 Windows 群組原則編輯器或 Windows 登錄中，在單一位置使用 ExtensionSettings 原則設定多個策原則。

開始之前

決定你要在 ExtensionSettings 政策中設定所有擴充管理，或是透過其他政策來設定這些控制項。

ExtensionSettings 原則可以覆寫您設定在群組原則中其他位置的其他原則，包括下列原則：

• ExtensionAllowedTypes
• ExtensionInstallBlocklist
• ExtensionInstallForcelist
• ExtensionInstallSources
• ExtensionInstallAllowlist

ExtensionSettings 原則欄位

此政策可控制如更新網址（Update URL）、擴充功能初次安裝下載來源，以及封鎖權限等設定。 你也可以用這個政策來辨識哪些權限不允許執行。 下表說明可用的原則欄位。

以下鍵可在全域範圍 (*) ：

• blocked_permissions
• installation_mode - 只有 "blocked"、 "allowed"、 是 "removed" 此範圍內的有效值。
• runtime_blocked_hosts
• blocked_install_message
• allowed_types
• runtime_allowed_hosts
• install_sources

以下按鍵可在個別擴充範圍中使用：

• blocked_permissions
• minimum_version_required
• blocked_install_message
• installation_mode - "blocked"、 "allowed"、 "removed"、 、 "force_installed"是 "normal_installed" 可能的值。
• runtime_allowed_hosts
• update_url
• override_update_url
• runtime_blocked_hosts
• toolbar_state
• sidebar_auto_open_blocked

在更新網址範圍內允許以下金鑰：

• blocked_permissions
• installation_mode - 只有 "blocked"、 "allowed"、 是 "removed" 此範圍內的有效值。

在 Windows 群組原則編輯器中使用 JSON 字串進行設定

使用 GPO 使用擴充功能設定原則的步驟假設您已針對 Microsoft Edge 原則匯入 ADM/ADMX。

1. 打開群組政策編輯器，然後到 Microsoft Edge > 擴充功能 > 設定 設定政策。
2. 啟用該政策，並在文字框中輸入其簡潔的 JavaScript 物件符號 (JSON) 資料，以單行無換行方式呈現。
3. 若要驗證該原則，並精簡成單行，請使用 JSON 壓縮工具。

正確設定 JSON 擴充功能設定原則的格式

你需要了解這項政策的兩個部分——預設範圍與個別範圍。 預設範圍是包含所有的擴充功能，而沒有自己的範圍。 個別範圍只會套用該擴充功能。

預設範圍是由星號 (*) 識別。 下一個範例會定義預設範圍和個別擴充功能範圍。

{ 
   "*": {}, 
   "nckgahadagoaajjgafhacjanaoiihapd": {} 
} 

擴充功能只會從一個範圍取得其設定。 如果有針對該擴充的獨立範圍，這些設定就會適用於該擴充。 如果沒有個別的擴充範圍，則擴充功能會使用預設範圍。

下一個 JSON 範例會封鎖任何擴充功能在 .example.com 上執行，並封鎖任何需要 「USB」權限的擴充功能。

{ 
  "*": { 
    "runtime_blocked_hosts": ["*://*.example.com"], 
    "blocked_permissions": ["usb"] 
  } 
} 

精簡 JSON

{"*":{"runtime_blocked_hosts":["*://*.example.com"],"blocked_permissions":["usb"]}} 

其他一些 JSON 擴充功能設定的範例

使用 installation_mode 屬性來允許和封鎖擴充功能

• 使用者可以安裝所有擴充功能——這是預設設定

  { "*": {"installation_mode": "allowed" }}

• 使用者無法安裝任何擴充功能。

  { "*": {"installation_mode": "blocked" }}

• 指定在安裝被封鎖時要顯示的自訂訊息。

  {"*": {"blocked_install_message": ["Call IT(408 - 555 - 1234) for an exception"]}}

使用 installation_mode 屬性強制安裝擴充功能

當使用 installation_mode 做為「force_installed」時，系統會自動安裝擴充功能，而不需要使用者互動。 使用者無法停用或移除該擴充功能。 如果已安裝「標準」或「強制」擴充功能，，update_url 欄位也必須定義。 此欄位指向可安裝擴充功能的位置。 針對 update_url 欄位，請使用下列位置：

• 如果你下載的擴充功能是託管在 Microsoft Edge Add-ons 商店，請使用以下 JSON 範例中的位置：

  {"nckgahadaanghapdoaajjgafhacjaoii": {"installation_mode": "force_installed","update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}

• 如果你下載的擴充功能是托管在 Chrome 網路商店，請使用以下 JSON 範例中的位置：

  {"nckgiihapdoaajjgafhacjgahadaanao": {"installation_mode": "force_installed","update_url": "https://clients2.google.com/service/update2/crx"}}

• 如果你是在自己的伺服器上架設擴充功能，請使用 Edge 可以下載打包擴充功能 (.crx 檔案) 的網址Microsoft。 JSON 範例：

  {"nckgahadagoaajjgafhacjanaoiihapd": {"installation_mode": "force_installed","update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}

在前面的例子中，如果你用「normal_installed」代替「force_installed」，那麼擴充功能會自動安裝，使用者不會介入，但他們可以停用該擴充功能。

使用 Windows 登錄進行設定

ExtensionSettings 原則應寫入此機碼下的登錄：

HKLM\Software\Policies\Microsoft\Edge\

針對 Microsoft Edge，所有設定都會在此機碼下開始：

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\

下一個你會建立的鍵是針對個別範圍的擴充 ID，或是預設範圍的星號 (*) 。 例如，你可以在登錄檔中使用以下位置來設定適用於 Google Hangouts 的設定：

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\nckgahadagoaajjgafhacjanaoiihapd

對於適用於預設範圍 (星號) 的設定，請在登錄檔中使用以下位置：

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\*

不同設定需要不同的格式，取決於它們是字串還是字串陣列。 陣列值需要 [＂value＂]。 字串值可以以目前格式輸入。 下列清單顯示哪些設定是陣列或字串：

• Installation_mode = 字串
• update_url = 字串
• blocked_permissions = 字串陣列
• allowed_permissions = 字串陣列
• minimum_version_required = 字串
• runtime_blocked_hosts = 字串陣列
• runtime_allowed_hosts = 字串陣列
• blocked_install_message = 字串

另請參閱

• 管理企業中的 Microsoft Edge 擴充功能
• 使用群組原則以管理 Microsoft Edge 擴充功能
• Microsoft Edge 擴充功能常見問題集
• Microsoft Edge 企業登陸頁面