使用首次运行的“初始首选项”设置配置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 文件后生效。