了解如何启动 Windows 设置。 本主题介绍 ms-settings: URI 方案。 使用此 URI 方案将 Windows 设置启动到特定设置页。
启动进入设置是开发隐私友好型应用的重要组成部分。 如果应用无法访问敏感资源,我们建议为用户提供指向该资源的隐私设置的便捷链接。 有关详细信息,请参阅 安全和标识。
重要 API
本主题使用了以下 Windows 运行时 (WinRT) API:
请注意,本主题中使用的 WinRT API 可用于 UWP 应用、WinUI 应用和其他桌面应用。 若要详细了解如何使桌面应用能够使用 WinRT API,请参阅 在桌面应用中调用 Windows 运行时 API。
如何启动设置
若要启动 设置,请使用 ms-settings: URI 方案,如以下示例所示。
XAML 超链接控件
在此示例中,超链接 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"));
上面的代码启动相机的隐私设置页:
有关启动 URI 的详细信息,请参阅 启动 URI 的默认应用。
ms-settings:URI 方案引用
以下部分介绍用于打开各种设置页面的 ms-settings URI 的不同类别:
- 帐户
- 应用
- 控制中心
- 小娜
- Devices
- 轻松访问
- 附加功能
- 家庭组
- 游戏
- 混合现实
- 网络和 Internet
- 个性化
- 电话
- 隐私
- 搜索
- 声音
- Surface Hub
- System
- 时间和语言
- 更新和安全性
注释
某些设置页面的可用性因 Windows 版本和 SKU 而异。 对于某些设置,URI 列还会捕获一些使用情况信息以及必须满足的任何其他要求才能使页面可用。
Accounts
| “设置”页 | URI |
|---|---|
| 访问工作系统或学校系统 | ms-settings:workplace |
| 电子邮件和应用帐户 | ms-settings:emailandaccounts |
| 家庭和其他人 | ms-settings:其他用户 |
| Provisioning | ms-settings:provisioning(仅在移动设备上可用;如果企业已部署预配包) ms-settings:workplace-provisioning (仅当企业部署了预配包时才可用) |
| 修复令牌 | ms-settings:workplace-repairtoken |
| 设置展台 | ms-settings:assignedaccess |
| 登录选项 | ms-settings:登录选项 ms-settings:signinoptions-dynamiclock |
| 同步设置 | ms-settings:sync ms-settings:backup (Windows 11 中弃用的备份页) |
| Windows Anywhere | ms-settings:windowsanywhere (设备必须支持 Windows Anywhere) |
| Windows Hello 设置 | ms-settings:signinoptions-launchfaceenrollment ms-settings-登录选项-启动指纹注册 |
| 你的信息 | ms-settings:yourinfo |
Apps
| “设置”页 | URI |
|---|---|
| 应用和功能 | ms-settings:appsfeatures |
| 应用功能 | 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:optionalfeatures |
| 离线地图 | ms-settings:maps ms-settings:maps-downloadmaps (下载地图) |
| 启动应用 | ms-settings:startupapps |
| 视频播放 | ms-settings:videoplayback |
控制中心
| “设置”页 | URI |
|---|---|
| 控制中心 | ms-settings:控制中心 |
Cortana
| “设置”页 | URI |
|---|---|
| 我的设备上的 Cortana | ms-settings:cortana-notifications |
| 更多详细信息 | ms-settings:cortana-moredetails |
| 权限和历史记录 | ms-settings:cortana-permissions |
| 在 Windows 中搜索 | ms-settings:cortana-windowssearch |
| 与 Cortana 交谈 | ms-settings:cortana-language ms-settings:cortana ms-settings:cortana-talktocortana |
重要
Cortana 语音助手在 Windows 中作为独立应用在 2023 年春季停用。 有关详细信息,请参阅 Cortana 的支持结束。
注释
当电脑设置为 Cortana 当前不可用或已禁用 Cortana 的地区时,桌面上的“设置”部分会显示为“搜索”。 在本例中,不会列出特定于 Cortana 的页面(我的设备中的 Cortana 和与 Cortana 通信)。
设备
| “设置”页 | URI |
|---|---|
| 自动播放 | ms-settings:autoplay |
| 蓝牙 | ms-settings:bluetooth |
| 连接的设备 | ms-settings:connecteddevices |
| 默认相机 | ms-settings:camera (Windows 10 版本 1809 及更高版本中弃用的行为) |
| 相机设置 | ms-settings:camera(Windows 11 中引入的行为,版本 22000 及更高版本)将查询字符串参数 cameraId 追加到相机设备的 Uri 转义的符号链接名称,以直接启动该相机的设置。 有关详细信息,请参阅 “启动相机设置”页。 |
| 鼠标和触摸板 | ms-settings:mousetouchpad(仅在具有触摸板的设备上可用的触摸板设置) |
| 笔和 Windows 墨迹 | ms-settings:pen |
| 打印机和扫描仪 | ms-settings:打印机 |
| 触控 | ms-settings:devices-touch |
| Touchpad | ms-settings:devices-touchpad(仅当触摸板硬件存在时才可用) |
| 文本建议 | ms-settings:devicestyping-hwkbtextsuggestions |
| 打字 | ms-settings:输入 |
| USB | ms-settings:usb |
| 方向盘 | ms-settings:wheel (仅当 Surface Dial 设备配对时可用) |
| 手机 | ms-settings:mobile-devices |
易于访问
| “设置”页 | URI |
|---|---|
| 音频 | ms-settings:easeofaccess-audio |
| 隐藏式字幕 | ms-settings:easeofaccess-closedcaptioning |
| 颜色筛选器 | ms-settings:easeofaccess-colorfilter ms-settings:easeofaccess-colorfilter-adaptivecolorlink ms-settings:easeofaccess-colorfilter-bluelightlink |
| Display | ms-settings:easeofaccess-display |
| 眼部控制 | ms-settings:轻松使用-眼动控制 |
| 听力设备 | ms-settings:easeofaccess-hearingaids (已在 Windows 11 版本 24H2 中添加) |
| 高对比度 | ms-settings:easeofaccess-highcontrast |
| 键盘 | ms-settings:轻松访问键盘 |
| 放大镜 | ms-settings:easeofaccess-magnifier |
| 鼠标 | ms-settings:easeofaccess-鼠标 |
| 鼠标指针和触摸 | ms-settings:轻松访问-鼠标指针 |
| 讲述人 | ms-settings:easeofaccess-narrator ms-settings:easeofaccess-narrator-isautostartenabled |
| 语音 | ms-settings:easeofaccess-speechrecognition |
| 文本游标 | ms-settings:easeofaccess-cursor |
| 视觉效果 | ms-settings:easeofaccess-visualeffects |
附加组件
| “设置”页 | URI |
|---|---|
| 附加 | ms-settings:extras(仅当安装了包含这些设置的应用程序时可用,例如由第三方安装) |
家庭组
| “设置”页 | URI |
|---|---|
| 家庭组 | ms-settings:family-group |
游戏
| “设置”页 | URI |
|---|---|
| 游戏栏 | ms-settings:gaming-gamebar |
| 游戏 DVR | ms-settings;游戏-gamedvr |
| 游戏模式 | ms-settings:gaming-gamemode |
| 全屏玩游戏 | ms-settings:quietmomentsgame |
| TruePlay | ms-settings:gaming-trueplay (从 Windows 10 版本 1809(10.0 开始)内部版本 17763),此功能已从 Windows 中删除) |
混合现实
注释
仅当安装了 混合现实门户 应用时,这些设置才可用。
重要
Windows 11 版本 24H2 及更新版不支持 Windows Mixed Reality 设备。
Windows Mixed Reality 支持仅限于 Windows 10 版本 20H2 到 Windows 11 版本 23H2。
| “设置”页 | URI |
|---|---|
| 音频和语音 | ms-settings:holographic-audio |
| 环境 | ms-settings:privacy-holographic-environment |
| 头戴显示设备 | ms-settings:全息头戴设备 |
| 卸载 | ms-settings:holographic-management |
| 启动和桌面 | ms-settings:全息启动和桌面 |
网络和互联网
| “设置”页 | URI |
|---|---|
| 网络和互联网 | ms-settings:network-status |
| 高级设置 | ms-settings:网络高级设置 |
| 飞行模式 | ms-settings:网络飞行模式 ms-settings:邻近 |
| 手机网络和 SIM 卡 | ms-settings:network-cellular |
| 拨号上网 | ms-settings:network-dialup |
| DirectAccess | ms-settings:network-directaccess (仅在启用 DirectAccess 时才可用) |
| 以太网 | ms-settings:network-ethernet |
| 管理已知网络 | ms-settings:network-wifisettings |
| 移动热点 | ms-settings:network-mobilehotspot |
| 代理 | ms-settings: network-proxy |
| VPN | ms-settings:network-vpn |
| WLAN | ms-settings:network-wifi (仅当设备具有 wifi 适配器时才可用) |
| Wi-Fi 预配 | ms-settings:wifi-provisioning |
个性化
| “设置”页 | URI |
|---|---|
| 背景 | ms-settings:个性化-背景 |
| 选择“开始”屏幕上显示的文件夹 | ms-settings:personalization-start-places |
| 颜色 | ms-settings:个性化-颜色 ms-settings:colors |
| 自定义键盘上的 Copilot 键 | ms-settings:personalization-textinput-copilot-hardwarekey |
| 动态照明 | ms-settings:personalization-lighting |
| 字体 | ms-settings:fonts |
| 概览 | ms-settings:personalization-glance(在 Windows 10 版本 1809 及更高版本中弃用) |
| 锁屏 | ms-settings:lockscreen |
| 导航栏 | ms-settings:personalization-navbar (在 Windows 10 版本 1809 及更高版本中弃用) |
| 个性化(类别) | ms-settings:personalization |
| Start | ms-settings:personalization-start |
| Taskbar | ms-settings:taskbar |
| 文本输入 | ms-settings:个性化-文本输入 |
| 触摸键盘 | ms-settings:personalization-touchkeyboard |
| 主题 | ms-settings:themes |
电话
| “设置”页 | URI |
|---|---|
| 手机 | ms-settings:移动设备 ms-settings:mobile-devices-addphone ms-settings:mobile-devices-addphone-direct (打开 你的手机 应用) |
| 设备使用情况 | ms-settings:deviceusage |
隐私
| “设置”页 | URI |
|---|---|
| 附属应用 | ms-settings:privacy-accessoryapps (在 Windows 10 版本 1809 及更高版本中弃用) |
| 帐户信息 | ms-settings:privacy-accountinfo |
| 活动历史记录 | ms-settings:privacy-activityhistory |
| 广告 ID | ms-settings:privacy-advertisingid (在 Windows 10 版本 1809 及更高版本中弃用) |
| 应用诊断 | ms-settings:privacy-appdiagnostics |
| 自动文件下载 | ms-settings:privacy-automaticfiledownloads |
| 后台应用 | ms-settings:privacy-backgroundapps (在 Windows 11、21H2 及更高版本中弃用) 注意: 在 Windows 11 中,将单独访问后台应用权限。 若要查看权限,请转到“应用已安装的应用>”,然后在新式应用上选择“...”,然后选择“高级”选项。 新式应用中会提供高级页面,并且除非设置了组策略或设置了用户的全局开关值(这是 Windows 10 中曾使用但已弃用的设置),否则“后台应用权限”部分将会显示。 若要使用 URI 访问此页面,请使用 ms-settings:appsfeatures-app URI 并传递应用的 包系列名称 的可选参数。 |
| 背景空间感知 | ms-settings:privacy-backgroundspatialperception |
| Calendar | ms-settings:privacy-calendar |
| 呼叫历史记录 | ms-settings:隐私-通话记录 |
| Camera | ms-settings:privacy-webcam |
| 联系人 | ms-settings:privacy-contacts |
| 文档 | ms-settings:privacy-documents |
| 下载文件夹 | ms-settings:privacy-downloadsfolder |
| ms-settings:privacy-email | |
| 眼动跟踪器 | ms-settings:privacy-eyetracker (需要眼动追踪硬件) |
| 反馈和诊断 | ms-settings:privacy-feedback |
| 文件系统 | ms-settings:privacy-broadfilesystemaccess |
| 概况 | ms-settings:privacy 或 ms-settings:privacy-general |
| 图形 | ms-settings:privacy-graphicscaptureprogrammatic ms-settings:privacy-graphicscapturewithoutborder |
| 墨迹书写和键入 | 微软设置:隐私-语音输入 |
| 位置 | ms-settings:privacy-location |
| Messaging | ms-settings:privacy-messaging |
| 麦克风 | ms-settings:privacy-microphone |
| Motion | ms-settings:privacy-motion |
| 音乐库 | ms-settings:privacy-musiclibrary |
| Notifications | ms-settings:privacy-notifications |
| 其他设备 | ms-settings:privacy-customdevices |
| 电话联络 | ms-settings:privacy-phonecalls |
| 图片 | ms-settings: 隐私图片 |
| 收音机 | ms-settings:privacy-radios |
| 语音 | ms-settings:privacy-speech |
| Tasks | ms-settings:privacy-tasks |
| Videos | ms-settings:privacy-videos |
| 语音激活 | ms-settings:privacy-voiceactivation |
搜寻
| “设置”页 | URI |
|---|---|
| 搜寻 | ms-settings:search |
| 搜索更多详细信息 | ms-settings:search-moredetails |
| 搜索权限 | ms-settings:search-permissions |
Sound
| “设置”页 | URI |
|---|---|
| 音量混音器 | ms-settings:apps-volume |
| Sound | ms-settings:sound |
| 声音设备 | ms-settings:sound-devices |
| 默认麦克风 | ms-settings:sound-defaultinputproperties |
| 默认音频输出 | ms-settings:sound-defaultoutputproperties |
| 音频设备属性 (特定设备) |
ms-settings:sound-properties?endpointId={0.0.0.00000000}。{aaaaaaaa-0000-1111-2222-bbbbbbbbbb} 注意: URI 的用户必须知道 endpointId 要使用的字符串。 |
| 音频设备属性 (特定设备) |
ms-settings:sound-properties?interfaceId=\\?\SWD#MMDEVAPI#{3.0.0.00000003}.{bbbbbbbb-1111-2222-3333-cccccccccccc}#{cccccccc-2222-3333-4444-dddddddddddd} 注意: URI 的用户必须知道要使用的字符串,并且在发送之前必须正确转义该字符串。 |
Surface Hub
| “设置”页 | URI |
|---|---|
| Accounts | ms-settings:surfacehub-accounts |
| 会话清理 | ms-settings:surfacehub-sessioncleanup |
| 团队会议 | ms-settings:surfacehub-calling |
| 团队设备管理 | ms-settings:surfacehub设备管理 |
| 欢迎屏幕 | ms-settings:surfacehub-welcome |
System
| “设置”页 | URI |
|---|---|
| About | ms-settings:关于 |
| 高级显示设置 | ms-settings:display-advanced(仅适用于支持高级显示选项的设备) |
| 电池省电模式 | ms-settings:batterysaver(仅适用于具有电池的设备,例如平板电脑) |
| 节电模式设置 | ms-settings:batterysaver-settings(仅适用于具有电池的设备,如平板电脑) |
| 电池使用 | ms-settings:batterysaver-usagedetails(仅适用于具有电池的设备,如平板电脑) |
| 剪贴板 | ms-settings:clipboard |
| 默认保存位置 | ms-settings:savelocations |
| Display | ms-settings:display ms-settings:screenrotation |
| 复制我的屏幕 | ms-settings:quietmomentspresentation |
| 在这些小时内 | ms-settings:静默时间安排 |
| Encryption | ms-settings:deviceencryption |
| 能源建议 | ms-settings:energyrecommendations (适用于 Windows 11 版本 22H2,版本 22624 或更高版本的二月时刻更新) |
| 焦点助手 | ms-settings:勿扰时段 |
| 图形设置 | ms-settings:display-advancedgraphics (仅适用于支持高级图形选项的设备) |
| 图形默认设置 | ms-settings:display-advancedgraphics-default |
| 多任务处理 | ms-settings:multitasking ms-settings:multitasking-sgupdate |
| 夜灯设置 | ms-settings:nightlight |
| 投影到此电脑 | ms-settings:project |
| 共享体验 | ms-settings:crossdevice |
| 平板电脑模式 | ms-settings:tabletmode (在 Windows 11 中删除) |
| Taskbar | ms-settings:taskbar |
| 通知和操作 | ms-settings:notifications |
| 远程桌面 | ms-settings:remotedesktop |
| 电话 | ms-settings:phone (在 Windows 10 版本 1809 及更高版本中弃用) |
| 电源和睡眠 | ms-settings:powersleep |
| 存在感知 | ms-settings:presence(已添加到 Windows 11 版本 22H2 版本 22624 的 5 月更新中) |
| 存储 | ms-settings:storagesense |
| 存储感知 | ms-settings:storagepolicies |
| 存储建议 | ms-settings:存储建议 |
| 磁盘和卷 | ms-settings:disksandvolumes |
时间和语言
| “设置”页 | URI |
|---|---|
| 日期和时间 | ms-settings:dateandtime |
| 日本 IME 设置 | ms-settings:regionlanguage-jpnime (如果安装了 Microsoft Japan 输入法编辑器,则可用) |
| 区域 | ms-settings:regionformatting |
| 语言 | ms-settings:keyboard ms-settings:keyboard-advanced ms-settings:regionlanguage 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:speech |
| Wubi IME 设置 | ms-settings:regionlanguage-chsime-wubi (如果安装了 Microsoft Wubi 输入法编辑器,则可用) |
更新和安全性
| “设置”页 | URI |
|---|---|
| 激活 | ms-settings:activation |
| 备份 | ms-settings:backup(Windows 11 中删除的页面;打开同步) |
| 传递优化 | ms-settings:delivery-optimization ms-settings:delivery-optimization-activity ms-settings:delivery-optimization-advanced |
| 查找我的设备 | ms-settings:查找我的设备 |
| 面向开发人员 | ms-settings:developers |
| 恢复 | ms-settings:recovery |
| 启动安全密钥注册 | ms-settings:signinoptions-launchsecuritykeyenrollment(用于启动安全密钥注册的设置路径) |
| Troubleshoot | ms-settings:疑难解答 |
| Windows 安全 | ms-settings:windowsdefender |
| Windows 预览体验计划 | ms-settings:windowsinsider(仅当用户注册 Windows Insider Program 时才存在) ms-settings:windowsinsider-optin |
| Windows 更新 | ms-settings:windowsupdate ms-settings:windowsupdate-action |
| Windows 更新 - 活跃时间 | ms-settings:windowsupdate-activehours |
| Windows 更新-高级选项 | ms-settings:windows更新-选项 |
| Windows Update-可选更新 | ms-settings:windowsupdate-optionalupdates |
| Windows 更新-重启选项 | ms-settings:windowsupdate-restartoptions |
| 按需 Windows 更新查找器 | ms-settings:windowsupdate-seekerondemand |
| Windows 更新-查看更新历史记录 | ms-settings:windowsupdate-history |