启动 Windows 设置

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

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

重要 API

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

请注意,本主题中使用的 WinRT API 可用于 UWP 应用、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: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
Email 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

启动 URI 的默认应用

启动、恢复和后台任务