Iniciar configurações do Windows

Saiba como iniciar as Configurações do Windows. Este tópico descreve o esquema de ms-settings: URI. Use esse esquema de URI para iniciar as Configurações do Windows em páginas de configurações específicas.

Iniciar as Configurações é uma parte importante ao desenvolver um aplicativo consciente de privacidade. Se seu aplicativo não puder acessar um recurso confidencial, recomendamos fornecer ao usuário um link conveniente para as configurações de privacidade desse recurso. Para obter mais informações, consulte Segurança e identidade.

APIs importantes

As seguintes APIs do WinRT (Windows Runtime) são usadas neste tópico:

Observe que as APIs do WinRT usadas neste tópico podem ser usadas no WinUI e em outros aplicativos da área de trabalho. Para ler mais sobre como habilitar seu aplicativo da área de trabalho para trabalhar com APIs do WinRT, consulte Chamar APIs do Windows Runtime em aplicativos da área de trabalho.

Como iniciar configurações

Para iniciar Configurações, use o ms-settings: esquema de URI, conforme mostrado nos exemplos a seguir.

Neste exemplo, um controle XAML do Hiperlink é usado para iniciar a página de configurações de privacidade do microfone usando o 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>

Chamando LaunchUriAsync

Como alternativa, seu aplicativo pode chamar o método LaunchUriAsync para iniciar Configurações. Este exemplo mostra como iniciar a página de configurações de privacidade da câmera usando o 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"));

O código acima inicia a página de configurações de privacidade para a câmera:

Uma captura de tela das configurações de privacidade da câmera do Windows.

Para obter mais informações sobre como iniciar URIs, consulte Iniciar o aplicativo padrão para um URI.

ms-settings: referência de esquema de URI

As seções a seguir descrevem diferentes categorias de URIs ms-settings usadas para abrir várias páginas de Configurações:

A disponibilidade de algumas páginas de configurações varia de acordo com a versão e o SKU do Windows. Para algumas configurações, a coluna URI também captura algumas informações de uso e quaisquer requisitos adicionais que devem ser atendidos para que uma página esteja disponível.

Accounts

Página configurações URI
Acessar trabalho ou escola ms-settings:workplace
Contas de email e aplicativo ms-settings:emailandaccounts
Família e outras pessoas ms-settings:otherusers
Provisioning ms-settings:provisioning (disponível apenas no celular e se a empresa implantou um pacote de provisionamento)
ms-settings:workplace-provisioning (disponível somente se a empresa tiver implantado um pacote de provisionamento)
Reparar token ms-settings:workplace-repairtoken
Configurar um quiosque ms-settings:assignedaccess
Opções de login ms-settings:signinoptions
ms-settings:signinoptions-dynamiclock
Sincronizar suas configurações ms-settings:sync
ms-settings:backup (página de backup preterida no Windows 11)
Windows em todo lugar ms-settings:windowsanywhere (o dispositivo deve ser compatível com o Windows em qualquer lugar)
Configuração do Windows Hello ms-settings:signinoptions-launchfaceenrollment
ms-settings:signinoptions-launchfingerprintenrollment
Suas informações ms-settings:yourinfo

Apps

Página configurações URI
Aplicativos & Recursos ms-settings:appsfeatures
Recursos do aplicativo ms-settings:appsfeatures-app (Redefinir, gerenciar complementos e conteúdos baixáveis, etc. para o aplicativo)

Para acessar esta página com um URI, use o URI ms-settings:appsfeatures-app e passe um parâmetro opcional do nome da família de pacotes do aplicativo.

Exemplo: ms-settings:appsfeatures-app?<PFN>
Aplicativos para sites ms-settings:appsforwebsites
Aplicativos padrão ms-settings:defaultapps (Comportamento introduzido no Windows 11, versão 21H2 (com Atualização Cumulativa 2023-04) ou 22H2 (com Atualização Cumulativa 2023-04) ou posterior.)
Acrescente o parâmetro de sequência de consulta nos formatos apresentados a seguir ao usar o nome com escape de URI de um aplicativo para iniciar diretamente a página de configurações padrão para esse aplicativo:

- registeredAppMachine=<nome do aplicativo com escape de URI por computador instalado>
- registeredAppUser=<nome do aplicativo com escape de URI por usuário instalado>
- registeredAUMID=<ID do modelo de usuário do aplicativo com escape de URI>

Para obter mais informações, consulte Iniciar a página de configurações de Aplicativos Padrão.
Configurações padrão do navegador ms-settings:defaultbrowsersettings (preterido no Windows 11)
Gerenciar recursos opcionais ms-settings:optionalfeatures
Mapas offline ms-settings:maps
ms-settings:maps-downloadmaps (Baixar mapas)
Aplicativos de inicialização ms-settings:startupapps
Reprodução de vídeo ms-settings:videoplayback

Central de Controle

Página configurações URI
Central de controle ms-configurações:centrodecontrole

Dispositivos

Página configurações URI
Reprodução automática ms-settings:autoplay
Bluetooth ms-settings:bluetooth
Dispositivos conectados ms-settings:connecteddevices
Câmera padrão ms-settings:camera (Comportamento preterido no Windows 10, versão 1809 e posterior)
Configurações da câmera ms-settings:camera (comportamento introduzido no Windows 11, build 22000 e em versões posteriores) Acrescente o parâmetro da sequência de consulta cameraId definido para o nome do link simbólico com escape de URI de um dispositivo de câmera para iniciar diretamente as configurações para essa câmera. Para obter mais informações, consulte Iniciar a página de configurações da câmera.
Mouse e touchpad ms-settings:mousetouchpad (configurações de touchpad disponíveis somente em dispositivos que têm um touchpad)
Caneta e Windows Ink ms-settings:pen
Botão de atalho da caneta ms-settings:pen-button
Impressoras e scanners ms-settings:printers
Tocar ms-settings:devices-touch
Touchpad ms-settings:devices-touchpad (disponível somente se o hardware do touchpad estiver presente)
Sugestões de texto ms-settings:devicestyping-hwkbtextsuggestions
Digitação ms-settings:typing
USB ms-settings:usb
Roda ms-settings:wheel (disponível somente se um dispositivo Surface Dial estiver emparelhado)
Seu telefone ms-settings:mobile-devices

Facilidade de acesso

Página configurações URI
Áudio ms-settings:facilidade-acesso-áudio
Legendas ocultas ms-settings:easeofaccess-closedcaptioning
Filtros de cores ms-settings:easeofaccess-colorfilter
ms-settings:easeofaccess-colorfilter-adaptivecolorlink
ms-settings:easeofaccess-colorfilter-bluelightlink
Display ms-settings:facilidade-de-acesso-exibição
Controle ocular ms-settings:easeofaccess-eyecontrol
Dispositivos de audição ms-settings:easeofaccess-hearingaids (adicionado no Windows 11, versão 24H2)
Alto contraste ms-settings:easeofaccess-highcontrast
Teclado ms-settings:easeofaccess-keyboard
Lupa ms-settings:easeofaccess-magnifier
Rato ms-settings:easeofaccess-mouse
Ponteiro do mouse e touch ms-settings:easeofaccess-mousepointer
Narrator ms-settings:easeofaccess-narrador
ms-settings:easeofaccess-narrador-isautostartenabled
Fala ms-settings:easeofaccess-speechrecognition
Cursor de texto ms-settings:easeofaccess-cursor
Efeitos visuais ms-settings:easeofaccess-visualeffects

Extras

Página configurações URI
Extras ms-settings:extras (disponível somente se aplicativos com essas configurações tiverem sido instalados, por exemplo, por terceiros)

Grupo familiar

Página configurações URI
Grupo familiar ms-settings:family-group

Jogos

Página configurações URI
Barra de jogos ms-settings:gaming-gamebar
DVR do jogo ms-settings:gaming-gamedvr
Modo de Jogo ms-settings:gaming-gamemode
Jogando um jogo em tela inteira ms-settings:quietmomentsgame
TruePlay ms-settings:gaming-trueplay (a partir do Windows 10, versão 1809 (10.0; Build 17763), esse recurso é removido do Windows)
Página configurações URI
Áudio e fala ms-settings:holographic-audio
Ambiente ms-settings:privacy-holographic-environment
Exibição do headset ms-settings:holographic-headset
Uninstall ms-settings:holographic-management
Inicialização e área de trabalho ms-settings:holographic-startupandesktop

Rede e Internet

Página configurações URI
Rede & Internet ms-settings:network-status
Configurações avançadas ms-settings:network-advancedsettings
Modo avião ms-settings:network-airplanemode
ms-settings:proximity
Rede Celular e SIM ms-settings:network-cellular
Rede de conexão discada ms-settings:network-dialup
DirectAccess ms-settings:network-directaccess (disponível somente se o DirectAccess estiver habilitado)
Ethernet ms-settings:network-ethernet
Gerenciar redes conhecidas ms-settings:network-wifisettings
Hotspot móvel ms-settings:network-mobilehotspot
Proxy ms-settings:network-proxy
VPN ms-settings:network-vpn
Wi-Fi ms-settings:network-wifi (disponível somente se o dispositivo tiver um adaptador wi-fi)
provisionamento de Wi-Fi ms-settings:wifi-provisioning

Personalização

Página configurações URI
Contexto Configurações do sistema: personalização-plano de fundo
Escolher quais pastas aparecem em Iniciar ms-settings:personalization-start-places
Cores ms-settings:personalization-colors
ms-settings:colors
Personalizar a tecla Copilot no teclado ms-settings:personalization-textinput-copilot-hardwarekey
Iluminação dinâmica ms-settings:personalization-lighting
Fontes ms-settings:fonts
Glance ms-settings:personalization-glance (Obsoleto no Windows 10, versão 1809 e posterior)
Tela de bloqueio ms-settings:lockscreen
Barra de navegação ms-settings:personalization-navbar (obsoleto no Windows 10, versão 1809 e posterior)
Personalização (categoria) ms-settings:personalization
Start ms-settings:personalization-start
Taskbar ms-settings:taskbar
Entrada de texto ms-settings:personalization-textinput
Teclado touch ms-settings:personalization-touchkeyboard
Temas ms-settings:themes

Telefone

Página configurações URI
Link do telefone ms-settings:mobile-devices
ms-settings:mobile-devices-addphone
ms-settings:mobile-devices-addphone-direct (abre o aplicativo Link do Telefone)
Uso do dispositivo ms-settings:deviceusage

Privacidade

Página configurações URI
Aplicativos acessórios ms-settings:privacy-accessoryapps (preterido no Windows 10, versão 1809 e em versões posteriores)
Informações da conta ms-settings:privacy-accountinfo
Histórico de atividades ms-settings:privacy-activityhistory
ID de anúncio ms-settings:privacy-advertisingid (descontinuado no Windows 10, versão 1809 e versões posteriores)
Diagnóstico de aplicativo ms-settings:privacy-appdiagnostics
Downloads automáticos de arquivos ms-settings:privacy-automaticfiledownloads
Aplicativos em segundo plano ms-settings:privacy-backgroundapps (preterido no Windows 11, 21H2 e posteriores)

Nota: No Windows 11, as permissões do aplicativo em segundo plano são acessadas individualmente. Para exibir as permissões, vá para Aplicativos - Aplicativos instalados> e selecione "..." em um aplicativo moderno e escolha Opções avançadas. A página avançada está presente para aplicativos modernos e a seção permissões de aplicativos em segundo plano estará presente, a menos que uma política de grupo tenha sido definida ou o valor de alternância global do usuário (a configuração preterida do Windows 10) esteja definida. Para acessar esta página com um URI, use o ms-settings:appsfeatures-app URI e passe um parâmetro opcional do nome da família de pacotes do aplicativo.
Percepção espacial em segundo plano ms-settings:privacy-backgroundspatialperception
Calendário ms-settings:privacy-calendar
Histórico de chamadas ms-settings:privacy-callhistory
Camera ms-settings:privacy-webcam
Contatos ms-settings:privacy-contacts
Documentos ms-settings:privacy-documents
Baixa a pasta ms-settings:privacy-downloadsfolder
Email ms-settings:privacy-email
Rastreador de olhos ms-settings:privacy-eyetracker (requer hardware de rastreador ocular)
Comentários e diagnósticos ms-settings:privacy-feedback
Sistema de arquivos ms-settings:privacy-broadfilesystemaccess
Geral ms-settings:privacy ou ms-settings:privacy-general
Graphics ms-settings:privacy-graphicscaptureprogrammatic
ms-settings:privacy-graphicscapturewithoutborder
Anotação a tinta e digitação ms-settings:privacy-speechtyping
Localização ms-settings:privacy-location
Messaging ms-settings:privacy-messaging
Microfone ms-settings:privacy-microphone
Motion ms-settings:privacy-motion
Biblioteca de músicas ms-settings:privacy-musiclibrary
Notifications ms-settings:privacy-notifications (ms-configurações:notificações-de-privacidade)
Outros dispositivos ms-settings:privacy-customdevices
Telefonemas ms-settings:privacy-phonecalls
Fotos ms-settings:privacidade-imagens
Rádios ms-settings:privacy-radios
Fala ms-settings:privacy-speech
Tasks ms-settings:privacy-tasks
Videos ms-settings:privacy-videos
Ativação de voz ms-settings:privacy-voiceactivation
Página configurações URI
Pesquisa ms-settings:search
Pesquisar mais detalhes ms-settings:pesquisar-maisdetalhes
Permissões de pesquisa ms-settings:search-permissions

Sound

Página configurações URI
Mixer de volume ms-settings:apps-volume
Sound ms-settings:sound
Dispositivos de som ms-settings:sound-devices
Microfone padrão ms-settings:sound-defaultinputproperties
Saída de áudio padrão ms-settings:sound-defaultoutputproperties
Propriedades do dispositivo de áudio
(dispositivo específico)
ms-settings:sound-properties?endpointId={0.0.0.00000000}.{aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb}

Nota: O usuário do URI deve saber a endpointId cadeia de caracteres a ser usada.
Propriedades do dispositivo de áudio
(dispositivo específico)
ms-settings:sound-properties?interfaceId=\\?\SWD#MMDEVAPI#{3.0.0.00000003}.{bbbbbbbb-1111-2222-3333-cccccccccccc}#{cccccccc-2222-3333-4444-dddddddddddd}

Nota: o usuário do URI deve saber a cadeia de caracteres interfaceId a ser usada e a cadeia de caracteres deve ser escapada corretamente antes de enviar.

System

Página configurações URI
Sobre ms-settings:about
Configurações de exibição avançadas ms-settings:display-advanced (disponível somente em dispositivos que dão suporte a opções de exibição avançadas)
Economia de bateria ms-settings:batterysaver (disponível somente em dispositivos que têm uma bateria, como um tablet)
Configurações de Economia de Bateria ms-settings:batterysaver-settings (disponível somente em dispositivos que têm uma bateria, como um tablet)
Uso de bateria ms-settings:batterysaver-usagedetails (disponível apenas em dispositivos que têm uma bateria, como um tablet)
Área de transferência ms-settings:clipboard
Localizações de salvamento padrão ms-settings:savelocations
Display ms-settings:display
ms-settings:screenrotation
Duplicando minha exibição ms-settings:quietmomentspresentation
Durante essas horas ms-settings:quietmomentsscheduled
Encryption ms-settings:deviceencryption
Recomendações de energia ms-settings:energyrecommendations (disponível nas atualizações de momento de fevereiro para o Windows 11, versão 22H2, build 22624 ou posterior)
Assistência de foco ms-settings:quiethours
Configurações gráficas ms-settings:display-advancedgraphics (disponível apenas em dispositivos que dão suporte a opções de elementos gráficos avançados)
Configurações padrão de gráficos ms-settings:display-advancedgraphics-default
Multitarefa ms-settings:multitasking
ms-settings:multitasking-sgupdate
Configurações de luz noturna ms-settings:nightlight
Projeção para este PC ms-settings:project
Experiências compartilhadas ms-settings:crossdevice
Modo tablet ms-settings:tabletmode (Removido no Windows 11)
Taskbar ms-settings:taskbar
Notificações e ações ms-settings:notificações
Área de Trabalho Remota ms-settings:remotedesktop
Telefone ms-settings:phone (preterido no Windows 10, versão 1809 e posterior)
Energia e repouso ms-settings:powersleep
Detecção de presença ms-settings:presence (adicionado na atualização do Momento de Maio para o Windows 11, versão 22H2, Build 22624)
Armazenamento ms-settings:storagesense
Sensor de armazenamento ms-settings:storagepolicies
Recomendações de armazenamento ms-settings:storagerecommendations
Discos e volumes ms-settings:disksandvolumes

Tempo e idioma

Página configurações URI
Data e hora ms-configurações:dataehora
Configurações do IME do Japão ms-settings:regionlanguage-jpnime (disponível se o editor de método de entrada do Microsoft Japan estiver instalado)
Região ms-settings:regionformatting
Linguagem ms-settings:keyboard
ms-configurações:teclado-avançado
ms-configurações:regiãoidioma
ms-settings:regionlanguage-bpmfime
ms-settings:regionlanguage-cangjieime
ms-settings:regionlanguage-chsime-wubi-udp
ms-settings:regionlanguage-quickime
ms-settings:regionlanguage-korime
Configurações de IME de Pinyin ms-settings:regionlanguage-chsime-pinyin (disponível se o editor de método de entrada do Microsoft Pinyin estiver instalado)
ms-settings:regionlanguage-chsime-pinyin-domainlexicon
ms-settings:regionlanguage-chsime-pinyin-keyconfig
ms-settings:regionlanguage-chsime-pinyin-udp
Fala ms-settings:speech
Configurações do IME do Wubi ms-settings:regionlanguage-chsime-wubi (disponível se o editor de método de entrada do Microsoft Wubi estiver instalado)

Atualização e segurança

Página configurações URI
Activation ms-settings:activation
Backup ms-settings:backup (página removida no Windows 11; abre Sincronização)
Otimização de Entrega ms-settings:delivery-optimization
ms-settings:delivery-optimization-activity
ms-settings:delivery-optimization-advanced
Localizar Meu Dispositivo ms-settings:findmydevice
Para desenvolvedores ms-settings:developers
Recuperação ms-settings:recovery
Iniciar registro de chave de segurança ms-settings:signinoptions-launchsecuritykeyenrollment
Troubleshoot ms-settings:troubleshoot
Segurança do Windows ms-settings:windowsdefender
Programa Windows Insider ms-settings:windowsinsider (presente somente se o usuário estiver inscrito no Windows Insider Program)
ms-settings:windowsinsider-optin
Atualização do Windows ms-settings:windowsupdate
ms-settings:windowsupdate-action
Horas ativas do Windows Update ms-settings:windowsupdate-activehours
Opções Avançadas de Atualização do Windows ms-settings:windowsupdate-options
Atualizações opcionais do Windows Update ms-settings:windowsupdate-optionalupdates
Opções de Update-Restart do Windows ms-settings:windowsupdate-restartoptions
Buscador de Atualizações do Windows sob demanda ms-settings:windowsupdate-seekerondemand
Histórico de atualizações do Windows Update-View ms-settings:windowsupdate-history

Iniciar o aplicativo padrão para um URI

Iniciando, retomando e tarefas em segundo plano