使用首次运行的“初始首选项”设置配置Microsoft Edge

使用本文中的信息在 Windows 设备上配置 Microsoft Edge 初始首选项设置。

在 Windows 上配置策略设置

从 Microsoft Edge 版本 93 开始，Microsoft 支持有限数量的“初始首选项” (以前称为“主首选项”) ，以帮助管理员为首次运行配置浏览器。 有关详细信息，请参阅以下首选项设置表中支持的 设置 。

部署后，“初始首选项”充当托管设备上的默认浏览器设置。 这些首选项是管理员首选的设置，用作首次运行的默认浏览器设置。

注意

用户可以更改初始首选项，并且对于某些设备不可用，因为它们未加入 Active Directory® 域。

初始首选项设置的一些示例包括默认主页或具有特定 URL 的选项卡的初始配置。

首选项仅从 initial_preferences 文件复制一次，在配置后不遵循对此文件所做的更改。 如果设置由 Microsoft Edge 策略 管理并在 initial_preferences 文件中配置，则策略始终优先。

首选项设置

下表显示了 Microsoft Edge 当前支持的设置。

首选项类别	设置
Bookmark_bar	show_apps_shortcut show_managed_bookmarks show_on_all_tabs
书签	editing_enabled
浏览器/clear_data	browsing_history browsing_history_basic” 缓存 cache_basic Cookie download_history form_data 密码
历史记录	browsing_history 缓存 Cookie download_history form_data hosted_apps_data 密码 site_settings
浏览器	first_run_tabs dark_theme show_toolbar_bookmarks_button show_toolbar_collections_button show_toolbar_downloads_button show_home_button show_prompt_before_closing_tabs show_toolbar_history_button
default_search_provider	[default_search_provider] 已启用
全屏	允许
主页	Homepage_url
homepage_is_newtabpage	homepage_is_newtabpage
会话	restore_on_startup startup_urls
扩展	扩展：设置

1：下载示例initial_preferences文件

若要开始，请从 Microsoft Edge Enterprise 登陆页下载“策略”文件。 提取下载中的文件，然后在示例文件夹中打开 initial_preferences 文件。 下一个屏幕截图显示可供下载的策略文件选项

2：自定义并验证initial_preferences文件

在下载的 initial_preferences 文件中自定义首选项设置，并验证更改以确保 JSON 代码中没有错误。 如果发现错误，检查initial_preferences文件的语法和结构，进行更正，然后再次检查。 Visual Studio Code中用于验证 JSON、联机 JSON 工具或 JSON 编辑的几个示例工具。

3：将首选项部署到用户的计算机

在部署 Microsoft Edge 的同时 将 initial_preferences 文件部署到用户的设备，并将该文件放在设备上的以下位置。

Windows (AMD64 和 ARM64)

频道	位置
Stable	"C:\Program Files (x86)\Microsoft\Edge\Application"
Beta	"C:\Program Files (x86)\Microsoft\Edge Beta\Application"
Canary	"%LOCALAPPDATA%\Microsoft\Edge SxS\Application"
Dev	"C:\Program Files (x86)\Microsoft\Edge Dev\Application"

注意

initial_preferences 文件需要 部署到与用户 Windows 计算机上的 msedge.exe 文件相同的文件夹。

macOS

频道	位置
Stable	"~/Library/Application Support/Microsoft Edge/Microsoft Edge Initial Preferences"
Beta	"~/Library/Application Support/Microsoft Edge Beta/Microsoft Edge Initial Preferences"
Canary	"~/Library/Application Support/Microsoft Edge Canary/Microsoft Edge Initial Preferences"
Dev	"~/Library/Application Support/Microsoft Edge Dev/Microsoft Edge Initial Preferences"

重要说明：MSI/PKG 部署和 initial_preferences 交互

初始首选项仅在最终用户首次运行浏览器之前部署 initial_preferences 文件后生效。

另请参阅

• 策略下载位置