启动 Windows 设置

了解如何启动 Windows 设置。 本主题介绍 ms-settings: URI 方案。 使用此 URI 方案将 Windows 设置启动到特定设置页。

启动进入设置是开发隐私友好型应用的重要组成部分。 如果应用无法访问敏感资源,我们建议为用户提供指向该资源的隐私设置的便捷链接。 有关详细信息,请参阅 安全和标识

重要 API

本主题使用了以下 Windows 运行时 (WinRT) API:

请注意,本主题中使用的 WinRT API 可用于 WinUI 和其他桌面应用。 若要详细了解如何使桌面应用能够使用 WinRT API,请参阅 在桌面应用中调用 Windows 运行时 API

如何启动设置

若要启动 设置,请使用 ms-settings: URI 方案,如以下示例所示。

在此示例中,超链接 XAML 控件用于使用 ms-settings:privacy-microphone URI 启动麦克风的隐私设置页。

<!--Set Visibility to Visible when access to the microphone is denied -->
<TextBlock x:Name="LocationDisabledMessage" FontStyle="Italic"
                 Visibility="Collapsed" Margin="0,15,0,0" TextWrapping="Wrap" >
          <Run Text="This app is not able to access the microphone. Go to " />
              <Hyperlink NavigateUri="ms-settings:privacy-microphone">
                  <Run Text="Settings" />
              </Hyperlink>
          <Run Text=" to check the microphone privacy settings."/>
</TextBlock>

调用 LaunchUriAsync

或者,你的应用可以调用 LaunchUriAsync 方法来启动 设置。 此示例演示如何使用 ms-settings:privacy-webcam URI 启动到相机的隐私设置页。

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:privacy-webcam"));
bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:privacy-webcam"));

上面的代码启动相机的隐私设置页:

Windows 相机隐私设置的屏幕截图。

有关启动 URI 的详细信息,请参阅 启动 URI 的默认应用

ms-settings: URI 方案参考资料

以下部分介绍用于打开各种设置页面的 ms-settings URI 的不同类别:

某些设置页面的可用性因 Windows 版本和 SKU 而异。 对于某些设置,URI 列还会捕获一些使用情况信息以及必须满足的任何其他要求才能使页面可用。

Accounts

设置页 URI
访问工作单位或学校 ms-settings:工作场所
电子邮件和应用帐户 ms-settings:电子邮件和账户
家庭和其他人 ms-settings:其他用户
Provisioning ms-settings:预配(仅在移动设备上可用,且仅当企业已部署预配包时)
ms-settings:工作区预配(仅当企业已部署预配包时可用)
修复令牌 ms-settings:工作场所-修复令牌
设置展台 ms-settings:分配访问权限
登录选项 ms-settings:登录选项
ms-settings:登录选项-动态锁
同步设置 ms-settings:同步
ms-settings:备份 (Windows 11 中弃用的备份页
Windows随处 ms-settings:Windows Anywhere(设备必须支持 Windows Anywhere)
Windows Hello 设置 ms-settings:登录选项-启动面部录入
ms-settings:登录选项-启动指纹录入
你的信息 ms-settings:yourinfo

Apps

设置页 URI
应用和功能 ms-settings:应用功能
应用功能 ms-settings:appsfeatures-app(重置、管理该应用的加载项和可下载内容等)

若要使用 URI 访问此页面,请使用 ms-settings:appsfeatures-app URI 并传递应用的 包系列名称 的可选参数。

示例: ms-settings:appsfeatures-app?<PFN>
网站应用 ms-settings:appsforwebsites
默认应用 ms-settings:defaultapps (Windows 11 版本 21H2(含 2023-04 累积更新)或 22H2(含 2023-04 累积更新)或更高版本中引入的行为。
使用应用的 URI 转义名称以下列格式追加查询字符串参数,以直接启动该应用的默认设置页:

- registeredAppMachine=<应用的 URI 转义的每台计算机安装名>
- registeredAppUser=<应用的 URI 转义的每个用户安装名>
- registeredAUMID=<URI 转义的应用程序用户模型 ID>

有关详细信息,请参阅 “启动默认应用设置”页
默认浏览器设置 ms-settings:defaultbrowsersettings (在 Windows 11 中弃用
管理可选功能 ms-settings:可选功能
离线地图 ms-settings:地图
ms-settings:maps-downloadmaps (下载地图)
启动应用 ms-settings:startupapps
视频播放 ms-settings:videoplayback

控制中心

设置页 URI
控制中心 ms-settings:controlcenter

设备

设置页 URI
自动播放 ms-settings:自动播放
蓝牙 ms-settings:蓝牙
连接的设备 ms-settings:已连接设备
默认相机 ms-settings:camera (Windows 10 版本 1809 及更高版本中弃用的行为
相机设置 ms-settings:相机(此行为在 Windows 11(内部版本 22000 及更高版本)中引入)追加查询字符串参数 cameraId,并将其设置为相机设备经过 URI 转义的符号链接名称,以直接打开该相机的设置页面。 有关详细信息,请参阅 “启动相机设置”页
鼠标和触摸板 ms-settings:鼠标触摸板(触摸板设置仅在具有触摸板的设备上可用)
笔和 Windows 墨迹 ms-settings:笔
笔快捷按钮 ms-settings:笔按钮
打印机和扫描仪 ms-settings:打印机
触控 ms-settings:触控设备
Touchpad ms-settings:devices-touchpad(仅在存在触摸板硬件时可用)
文本建议 ms-settings:设备键入硬件键盘文本建议
打字 ms-settings:打字
USB ms-settings:usb
方向盘 ms-settings:转盘(仅当已配对 Surface Dial 设备时才可用)
手机 ms-settings:移动设备

易于访问

设置页 URI
音频 ms-settings:easeofaccess-audio
隐藏式字幕 ms-settings:轻松使用-隐藏式字幕
颜色筛选器 ms-settings:轻松访问-颜色筛选器
ms-settings:轻松访问-颜色筛选器-自适应颜色链接
ms-settings:轻松访问-颜色筛选器-蓝光链接
Display ms-settings:轻松访问-显示
眼部控制 ms-settings:轻松使用-眼动控制
听力设备 ms-settings:easeofaccess-hearingaids(在 Windows 11 版本 24H2 中新增
高对比度 ms-settings:轻松使用-高对比度
键盘 ms-settings:轻松使用-键盘
放大镜 ms-settings:轻松使用-放大镜
鼠标 ms-settings:轻松使用-鼠标
鼠标指针和触摸 ms-settings:轻松使用-鼠标指针
讲述人 ms-settings:轻松使用-讲述人
ms-settings:轻松使用-讲述人-是否已启用自动启动
语音 ms-settings:辅助功能-语音识别
文本游标 ms-settings:轻松使用-光标
视觉效果 ms-settings:轻松使用-视觉效果

附加组件

设置页 URI
附加组件 ms-settings:extras (仅当安装了具有这些设置的应用(例如由第三方安装)时可用)

家庭组

设置页 URI
家庭组 ms-settings:家庭组

游戏

设置页 URI
游戏栏 ms-settings:游戏-游戏栏
游戏数字视频录制 (DVR) ms-settings:游戏-GameDVR
游戏模式 ms-settings:游戏-游戏模式
全屏玩游戏 ms-settings:quietmomentsgame
TruePlay ms-settings:gaming-trueplay(自 Windows 10 版本 1809(10.0;内部版本 17763)起,此功能已从 Windows 中移除
设置页 URI
音频和语音 ms-settings:全息音频
环境 ms-settings:隐私全息环境
头戴显示设备 ms-settings:全息头显
卸载 ms-settings:全息管理
启动和桌面 ms-settings:holographic-startupandesktop

网络和互联网

设置页 URI
网络和互联网 ms-settings:网络状态
高级设置 ms-settings:网络-高级设置
飞行模式 ms-settings:网络-飞行模式
ms-settings:邻近
手机网络和 SIM 卡 ms-settings:蜂窝网络
拨号上网 ms-settings:网络拨号
DirectAccess ms-settings:network-directaccess (仅在启用 DirectAccess 时才可用)
以太网 ms-settings:网络-以太网
管理已知网络 ms-settings:网络-Wi‑Fi设置
移动热点 ms-settings:网络-移动热点
代理 ms-settings:网络代理
VPN ms-settings:网络-VPN
WLAN ms-settings:network-wifi (仅当设备具有 wifi 适配器时才可用)
Wi-Fi 预配 ms-settings:Wi‑Fi 配网

个性化

设置页 URI
背景 ms-settings:个性化背景
选择“开始”屏幕上显示的文件夹 ms-settings:个性化起始位置
颜色 ms-settings:个性化-颜色
ms-settings:颜色
自定义键盘上的 Copilot 键 ms-settings:个性化-文本输入-Copilot-硬件键
动态照明 ms-settings:个性化照明
字体 ms-settings:字体
概览 ms-settings:个性化概览(在 Windows 10 版本 1809 及更高版本中已弃用
锁屏 ms-settings:锁屏界面
导航栏 ms-settings:个性化-导航栏(Windows 10版本 1809 及更高版本中已弃用
个性化(类别) ms-settings:个性化
Start ms-settings:personalization-start
Taskbar ms-settings:任务栏
文本输入 ms-settings:个性化-文本输入
触摸键盘 ms-settings:个性化-触摸键盘
主题 ms-settings:主题

电话

设置页 URI
电话链接 ms-settings:移动设备
ms-settings:移动设备-添加手机
ms-settings:mobile-devices-addphone-direct (打开 手机链接 应用)
设备使用情况 ms-settings:设备使用情况

隐私

设置页 URI
附属应用 ms-settings:privacy-accessoryapps (在 Windows 10 版本 1809 及更高版本中弃用
帐户信息 ms-settings:隐私-账户信息
活动历史记录 ms-settings:隐私-活动历史记录
广告识别码 ms-settings:privacy-advertisingid (在 Windows 10 版本 1809 及更高版本中弃用
应用诊断 ms-settings:隐私-应用诊断
自动文件下载 ms-settings:隐私-自动文件下载
后台应用 ms-settings:privacy-backgroundapps (在 Windows 11、21H2 及更高版本中弃用

注意: 在 Windows 11 中,将单独访问后台应用权限。 若要查看权限,请转到“应用已安装的应用>”,然后在新式应用上选择“...”,然后选择“高级”选项。 新式应用中会提供高级页面,并且除非设置了组策略或设置了用户的全局开关值(这是 Windows 10 中曾使用但已弃用的设置),否则“后台应用权限”部分将会显示。 若要使用 URI 访问此页面,请使用 ms-settings:appsfeatures-app URI 并传递应用的 包系列名称 的可选参数。
背景空间感知 ms-settings:隐私-背景空间感知
日历 ms-settings:隐私-日历
呼叫历史记录 ms-settings:隐私-通话记录
Camera ms-settings:privacy-webcam
联系人 ms-settings:隐私联系人
文档 ms-settings:隐私文档
下载文件夹 ms-settings:隐私-下载文件夹
Email ms-settings:隐私邮箱
眼动跟踪器 ms-settings:privacy-eyetracker(需要眼动追踪器硬件)
反馈和诊断 ms-settings:隐私反馈
文件系统 ms-settings:隐私 - 广泛文件系统访问
概况 ms-settings:隐私或 ms-settings:隐私常规
图形 ms-settings:隐私-以编程方式捕获图形
ms-settings:隐私-无边框图形捕获
墨迹书写和键入 ms-settings:隐私-语音输入
位置 ms-settings:隐私-位置
Messaging ms-settings:隐私消息
麦克风 ms-settings:隐私麦克风
Motion ms-settings:隐私动态
音乐库 ms-settings:隐私-音乐资料库
Notifications ms-settings:隐私通知
其他设备 ms-settings:隐私-自定义设备
电话联络 ms-settings:隐私-通话
图片 ms-settings:隐私图片
收音机 ms-settings:隐私单选按钮
语音 ms-settings:隐私语音
Tasks ms-settings:隐私任务
Videos ms-settings:隐私-视频
语音激活 ms-settings:隐私-语音激活
设置页 URI
搜寻 ms-settings:搜索
搜索更多详细信息 ms-settings:搜索-更多详细信息
搜索权限 ms-settings:搜索-权限

Sound

设置页 URI
音量混音器 ms-settings:apps-volume
Sound ms-settings:声音
声音设备 ms-settings:音频设备
默认麦克风 ms-settings:声音-默认输入属性
默认音频输出 ms-settings:声音-默认输出属性
音频设备属性
(特定设备)
ms-settings:sound-properties?endpointId={0.0.0.00000000}.{aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb}

注意: URI 的用户必须知道 endpointId 要使用的字符串。
音频设备属性
(特定设备)
ms-settings:sound-properties?interfaceId=\\?\SWD#MMDEVAPI#{3.0.0.00000003}.{bbbbbbbb-1111-2222-3333-cccccccccccc}#{cccccccc-2222-3333-4444-dddddddddddd}

注意:URI 用户必须知道要使用的 interfaceId 字符串,且该字符串在发送前必须正确转义。

System

设置页 URI
About ms-settings:关于
高级显示设置 ms-settings:显示-高级

注意:在Windows 11,此 URI 将打开“系统>显示设置”页;“高级显示”视图是“显示”的子部分,没有专用 URI。
电池省电模式 ms-settings:batterysaver (仅适用于具有电池的设备,如平板电脑)
节电模式设置 ms-settings:省电模式设置(仅适用于带电池的设备,如平板电脑)
电池使用 ms-settings:batterysaver-usagedetails (仅适用于具有电池的设备,如平板电脑)
剪贴板 ms-settings:剪贴板
默认保存位置 ms-settings:保存位置
Display ms-settings:显示
ms-settings:屏幕旋转
复制我的屏幕 ms-settings:quietmomentspresentation
在这些小时内 ms-settings:已安排静默时段
Encryption ms-settings:设备加密
能源建议 ms-settings:能源建议 (在 2 月的 Windows 11 版本 22H2 Moment 更新(内部版本 22624 或更高版本)中提供)
专注助手 ms-settings:免打扰时段
图形设置 ms-settings:display-advancedgraphics (仅适用于支持高级图形选项的设备)
图形默认设置 ms-settings:显示-高级图形-默认
多任务处理 ms-settings:多任务处理
ms-settings:multitasking-sgupdate
夜灯设置 ms-settings:夜灯
投影到此电脑 ms-settings:项目
共享体验 ms-settings:crossdevice
平板电脑模式 ms-settings:tabletmode (在 Windows 11 中删除
Taskbar ms-settings:任务栏
通知和操作 ms-settings:通知
远程桌面 ms-settings:远程桌面
电话 ms-settings:电话 (在 Windows 10 版本 1809 及更高版本中已弃用)
电源和睡眠 ms-settings:高效睡眠
存在感知 ms-settings:存在感知(在 Windows 11 版本 22H2、内部版本 22624 的 5 月 Moment 更新中添加
存储 ms-settings:storagesense
存储感知 ms-settings:存储策略
存储建议 ms-settings:存储建议
磁盘和卷 ms-settings:磁盘和卷

时间和语言

设置页 URI
日期和时间 ms-settings:日期和时间
日本 IME 设置 ms-settings:regionlanguage-jpnime (如果安装了 Microsoft Japan 输入法编辑器,则可用)
区域 ms-settings:区域格式
语言 ms-settings:键盘
ms-settings:键盘-高级
ms-settings:区域语言
ms-settings:regionlanguage-bpmfime
ms-settings:regionlanguage-cangjieime
ms-settings:regionlanguage-chsime-wubi-udp
ms-settings:regionlanguage-quickime
ms-settings:regionlanguage-korime
Pinyin IME 设置 ms-settings:regionlanguage-chsime-pinyin(仅当已安装 Microsoft Pinyin 输入法编辑器时可用)
ms-settings:regionlanguage-chsime-pinyin-domainlexicon
ms-settings:regionlanguage-chsime-pinyin-keyconfig
ms-settings:regionlanguage-chsime-pinyin-udp
语音 ms-settings:语音
Wubi IME 设置 ms-settings:regionlanguage-chsime-wubi (如果安装了 Microsoft Wubi 输入法编辑器可用)

更新和安全性

设置页 URI
激活 ms-settings:激活
备份 ms-settings:备份(Windows 11中删除的页面;打开同步)
交付优化 ms-settings:delivery-optimization
ms-settings:delivery-optimization-activity
ms-settings:delivery-optimization-advanced
查找我的设备 ms-settings:查找我的设备
面向开发人员 ms-settings:开发人员
恢复 ms-settings:恢复
启动安全密钥注册 ms-settings:登录选项-启动安全密钥注册
Troubleshoot ms-settings:排查故障
Windows 安全 ms-settings:windowsdefender
Windows 预览体验计划 ms-settings:Windows Insider(仅当用户已加入 WIP 时才会显示)
ms-settings:windowsinsider-optin
Windows 更新 ms-settings:windowsupdate
ms-settings:windowsupdate-action
Windows 更新 - 活跃时间 ms-settings:Windows 更新 - 活动时间
Windows 更新-高级选项 ms-settings:Windows 更新选项
Windows 更新-可选更新 ms-settings:Windows 更新-可选更新
Windows 更新-重启选项 ms-settings:Windows 更新-重启选项
按需 Windows 更新查找器 ms-settings:windowsupdate-seekerondemand
Windows 更新-查看更新历史记录 ms-settings:Windows 更新历史记录

启动 URI 的默认应用

启动、恢复和后台任务