使用首次运行的“初始首选项”设置配置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 文件。 下一个屏幕截图显示可供下载的策略文件选项

Microsoft可供下载的 Edge 策略文件。

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 文件后生效。

另请参阅