Windows 설정을 시작하는 방법을 알아봅니다. 이 항목에서는 URI 체계에 대해 ms-settings: 설명합니다. 이 URI 스키마를 사용하여 특정 설정 페이지로 Windows 설정을 시작합니다.
설정 시작은 개인 정보 인식 앱을 작성하는 데 중요한 부분입니다. 앱이 중요한 리소스에 액세스할 수 없는 경우 사용자에게 해당 리소스의 개인 정보 설정에 대한 편리한 링크를 제공하는 것이 좋습니다. 자세한 내용은 보안 및 ID를 참조하세요.
중요 API
이 항목에서는 다음 WinRT(Windows 런타임) API가 사용됩니다.
이 항목에 사용된 WinRT API는 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 메서드를 호출하여 설정을 시작할 수 있습니다. 이 예제에서는 URI를 사용하여 ms-settings:privacy-webcam 카메라의 개인 정보 설정 페이지로 시작하는 방법을 보여줍니다.
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에 대해 설명합니다.
일부 설정 페이지의 가용성은 Windows 버전 및 SKU에 따라 다릅니다. 일부 설정의 경우 URI 열에는 일부 사용량 정보 및 페이지를 사용할 수 있도록 충족해야 하는 추가 요구 사항도 캡처됩니다.
Accounts
| 설정 페이지 | URI |
|---|---|
| 회사 또는 학교에 액세스하기 | ms-settings:직장 |
| 전자 메일 및 앱 계정 | ms-settings:이메일 및 계정 |
| 가족 및 기타 사용자 | ms-settings:다른 사용자들 |
| Provisioning |
ms-settings:프로비저닝(모바일에서만 사용할 수 있으며 엔터프라이즈에서 프로비저닝 패키지를 배포한 경우에만) ms-settings:작업 공간 프로비저닝(엔터프라이즈에서 프로비저닝 패키지를 배포한 경우에만 사용 가능) |
| 토큰 복구 | ms-settings:작업 공간 복구 토큰 |
| 키오스크 설정 | ms-settings:assignedaccess |
| 로그인 옵션 |
ms-settings:로그인 옵션 ms-settings:로그인 옵션 - 동적 잠금 |
| 설정 동기화 |
ms-settings:동기화 ms-settings:백업(백업 페이지는 Windows 11 사용되지 않음) |
| 어디서나 Windows | ms-settings:windowsanywhere(디바이스는 Windows Anywhere 지원이어야 함) |
| Windows Hello 설정 |
ms-settings:로그인 옵션 - 얼굴 등록 시작 ms-settings:로그인 옵션 - 지문 등록 시작 |
| 사용자 정보 | ms-settings:yourinfo |
Apps
| 설정 페이지 | URI |
|---|---|
| 앱 및 기능 | ms-settings:앱 기능 |
| 앱 기능 |
ms-settings:appsfeatures-app(앱에 대한 다시 설정, 추가 기능 관리 및 다운로드 가능한 콘텐츠 등) URI를 사용하여 이 페이지에 액세스하려면 appsfeatures-app URI를 사용하고 ms-settings:앱의 패키지 패밀리 이름의 선택적 매개 변수를 전달합니다. 예: 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:지도 ms-settings:maps-downloadmaps(맵 다운로드) |
| 시작 프로그램 | ms-settings:startupapps |
| 비디오 재생 | ms-settings:videoplayback |
제어 센터
| 설정 페이지 | URI |
|---|---|
| 제어 센터 | ms-settings:controlcenter |
Devices
| 설정 페이지 | URI |
|---|---|
| 자동 실행 | ms-settings:자동 실행 |
| Bluetooth | ms-settings:블루투스 |
| 연결된 디바이스 | ms-settings:연결된 장치 |
| 기본 카메라 | ms-settings:카메라(Windows 10 버전 1809 이상에서 사용되지 않는 동작) |
| 카메라 설정 |
ms-settings:카메라(Windows 11, 빌드 22000 이상에서 도입된 동작) 카메라 장치의 URI 이스케이프된 기호 링크 이름으로 설정된 쿼리 문자열 매개 변수 cameraId를 추가하면 해당 카메라의 설정을 직접 열 수 있습니다. 자세한 내용은 카메라 설정 시작 페이지를 참조하세요. |
| 마우스 및 터치 패드 | ms-settings:mousetouchpad(터치 패드 설정은 터치 패드가 있는 디바이스에서만 사용 가능) |
| 펜 및 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:easeofaccess-colorfilter ms-settings:easeofaccess-colorfilter-adaptivecolorlink ms-settings:easeofaccess-colorfilter-bluelightlink |
| Display | ms-settings:easeofaccess-display |
| 눈 제어 | ms-settings:easeofaccess-eyecontrol |
| 청각 장치 | ms-settings:easeofaccess-hearingaids(Windows 11 버전 24H2에 추가됨) |
| 높은 대비 | ms-settings:접근성-고대비 |
| Keyboard | ms-settings:접근성-키보드 |
| 돋보기 | ms-settings:easeofaccess-magnifier |
| Mouse | ms-settings:easeofaccess-mouse |
| 마우스 포인터 및 터치 | ms-settings:접근성-마우스 포인터 |
| 내레이터 |
ms-settings:easeofaccess-narrator ms-settings:easeofaccess-narrator-isautostartenabled |
| Speech | ms-settings:easeofaccess-speechrecognition |
| 텍스트 커서 | ms-settings:easeofaccess-cursor |
| 시각 효과 | ms-settings:접근성-시각 효과 |
엑스트라
| 설정 페이지 | URI |
|---|---|
| 엑스트라 | ms-settings:추가 기능(이러한 설정이 있는 앱이 설치된 경우에만 사용 가능하며, 예를 들어 타사를 통해 설치된 경우) |
가족 그룹
| 설정 페이지 | URI |
|---|---|
| 가족 그룹 | ms-settings:가족 그룹 |
게임
| 설정 페이지 | URI |
|---|---|
| 게임 바 | ms-settings:gaming-gamebar |
| 게임 DVR | ms-settings:gaming-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:홀로그램 헤드셋 |
| Uninstall | ms-settings:홀로그램 관리 |
| 시작 및 데스크톱 | ms-settings:홀로그래픽 시작 및 데스크톱 |
네트워크 및 인터넷
| 설정 페이지 | URI |
|---|---|
| 네트워크 및 인터넷 | ms-settings:네트워크 상태 |
| 고급 설정 | ms-settings:네트워크-고급 설정 |
| 비행기 모드 |
ms-settings:네트워크-비행기 모드 ms-settings:근접성 |
| 셀룰러 및 SIM | ms-settings:모바일 네트워크 |
| 전화 접속 | ms-settings:네트워크 전화 접속 |
| DirectAccess | ms-settings:network-directaccess(DirectAccess를 사용하는 경우에만 사용 가능) |
| 이더넷 | ms-settings:네트워크-이더넷 |
| 알려진 네트워크 관리 | ms-settings:네트워크-와이파이설정 |
| 모바일 핫스팟 | ms-settings:네트워크-모바일 핫스팟 |
| Proxy | ms-settings:네트워크 프록시 |
| VPN | ms-settings:네트워크-VPN |
| Wi-Fi | ms-settings:네트워크 와이파이(디바이스에 wifi 어댑터가 있는 경우에만 사용 가능) |
| Wi-Fi 프로비전 | ms-settings:Wi‑Fi 프로비저닝 |
Personalization
| 설정 페이지 | URI |
|---|---|
| 배경 | ms-settings:개인 설정 배경 |
| 시작 화면에 표시되는 폴더 선택 | ms-settings:personalization-start-places |
| 색상들 |
ms-settings:개인 설정 색 ms-settings:색상 |
| 키보드에서 Copilot 키 사용자 지정 | ms-settings:개인 설정-텍스트 입력-Copilot-하드웨어 키 |
| 동적 조명 | ms-settings:개인 설정 조명 |
| 글꼴 | ms-settings:글꼴 |
| 간략 보기 | ms-settings:개인 설정 한눈에 보기(Windows 10 버전 1809 이상에서 사용되지 않음) |
| 잠금 화면 | ms-settings:잠금 화면 |
| 탐색 모음 | ms-settings:personalization-navbar(Windows 10 버전 1809 이상에서 사용되지 않음) |
| 개인 설정(범주) | ms-settings:개인화 |
| Start | ms-settings:personalization-start |
| Taskbar | ms-settings:작업 표시줄 |
| 텍스트 입력 | ms-settings:personalization-textinput |
| 터치 키보드 | ms-settings:개인 설정-터치 키보드 |
| 테마 | ms-settings:테마 |
Phone
| 설정 페이지 | URI |
|---|---|
| 전화 링크 |
ms-settings:모바일 기기 ms-settings:mobile-devices-addphone ms-settings:mobile-devices-addphone-direct (전화 링크 앱 열기) |
| 디바이스 사용량 | ms-settings:장치 사용 |
개인 정보 보호
| 설정 페이지 | URI |
|---|---|
| 액세서리 앱 | ms-settings:privacy-accessoryapps(Windows 10 버전 1809 이상에서 사용되지 않음) |
| 계정 정보 | ms-settings:개인정보-계정정보 |
| 활동 기록 | ms-settings:개인정보-활동 기록 |
| 광고 ID | ms-settings:privacy-advertisingid(Windows 10 버전 1809 이상에서 사용되지 않음) |
| 앱 진단 | ms-settings:개인정보-앱진단 |
| 자동 파일 다운로드 | ms-settings:개인정보-자동 파일 다운로드 |
| 백그라운드 앱 |
ms-settings:privacy-backgroundapps(Windows 11, 21H2 이상에서 사용되지 않음) 메모: Windows 11에서는 백그라운드 앱 권한에 개별적으로 액세스합니다. 사용 권한을 보려면 앱 설치 앱으로> 이동한 다음, 최신 앱에서 "..." 를 선택하고 고급 옵션을 선택합니다. 최신 앱에 대한 고급 페이지가 있으며 그룹 정책이 설정되었거나 사용자의 전역 토글 값(Windows 10에서 사용되지 않는 설정)이 설정되지 않은 한 백그라운드 앱 사용 권한 섹션이 표시됩니다. URI를 사용하여 이 페이지에 액세스하려면 URI를 ms-settings:appsfeatures-app 사용하고 앱의 패키지 패밀리 이름의 선택적 매개 변수를 전달합니다. |
| 배경 공간 인식 | ms-settings:개인정보보호배경공간지각 |
| Calendar | ms-settings:privacy-calendar |
| 통화 기록 | ms-settings:개인정보-통화기록 |
| Camera | ms-settings:개인정보 보호 웹캠 |
| 연락처 | ms-settings:개인 정보 보호 연락처 |
| 문서 | ms-settings:개인 정보-문서 |
| 다운로드 폴더 | ms-settings:개인정보 다운로드 폴더 |
| 전자 메일 | ms-settings:privacy-email |
| 아이 트래커 | ms-settings:privacy-eyetracker(아이트래커 하드웨어 필요) |
| 피드백 및 진단 | ms-settings:개인 정보 피드백 |
| 파일 시스템 | ms-settings:개인 정보-광범위한 파일 시스템 액세스 |
| General | ms-settings:개인 정보 또는 ms-settings:개인 정보 보호 일반 |
| 그래픽 |
ms-settings:privacy-graphicscaptureprogrammatic ms-settings:privacy-graphicscapturewithoutborder |
| 디지털 잉크와 타이핑 | ms-settings:개인정보-음성입력 |
| 위치 | ms-settings:개인 정보 보호 위치 |
| Messaging | ms-settings:개인 정보 보호 메시징 |
| 마이크 | ms-settings:개인정보 보호 마이크 |
| Motion | ms-settings:개인정보 보호 모션 |
| 음악 라이브러리 | ms-settings:개인정보-음악 라이브러리 |
| Notifications | ms-settings:개인 정보 알림 |
| 기타 디바이스 | ms-settings:개인 정보-사용자 지정 장치 |
| 전화 통화 | ms-settings:개인 정보-전화 통화 |
| Pictures | ms-settings:개인 정보 보호 사진 |
| 라디오 | ms-settings:개인정보-라디오 |
| Speech | ms-settings:개인정보-음성 |
| 업무 | ms-settings:개인 정보 보호 작업 |
| Videos | ms-settings:개인 정보 보호 비디오 |
| 음성 활성화 | ms-settings:개인정보-음성 활성화 |
Search
| 설정 페이지 | URI |
|---|---|
| Search | ms-settings:검색 |
| 자세한 내용 검색 | ms-settings:검색-자세한 정보 |
| 검색 권한 | ms-settings:search-permissions |
Sound
| 설정 페이지 | URI |
|---|---|
| 볼륨 믹서 | ms-settings:apps-volume |
| Sound | ms-settings:사운드 |
| 소리 장치 | ms-settings:사운드 디바이스 |
| 기본 마이크 | ms-settings:sound-defaultinputproperties |
| 기본 오디오 출력 | ms-settings:sound-defaultoutputproperties |
| 오디오 디바이스 속성 (특정 디바이스) |
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 알고 있어야 하며 보내기 전에 문자열을 올바르게 이스케이프해야 합니다. |
시스템
| 설정 페이지 | URI |
|---|---|
| 소개 | ms-settings:소개 |
| 고급 디스플레이 설정 | ms-settings:디스플레이 고급(고급 디스플레이 옵션을 지원하는 디바이스에서만 사용 가능) |
| 배터리 절약 모드 | ms-settings:batterysaver(태블릿과 같은 배터리가 있는 디바이스에서만 사용 가능) |
| 배터리 절약 모드 설정 | ms-settings:batterysaver-settings(태블릿과 같은 배터리가 있는 디바이스에서만 사용 가능) |
| 배터리 사용 | ms-settings:batterysaver-usagedetails(태블릿과 같은 배터리가 있는 디바이스에서만 사용 가능) |
| 클립보드 | ms-settings:클립보드 |
| 기본 저장 위치 | ms-settings:저장 위치 |
| Display |
ms-settings:표시 ms-settings:화면 회전 |
| 내 디스플레이를 복제하기 | ms-settings:조용한 순간 프레젠테이션 |
| 이 시간 동안 | ms-settings:조용한 시간 예약됨 |
| Encryption | ms-settings:장치 암호화 |
| 에너지 권장 사항 | ms-settings:energyrecommendations(Windows 11 버전 22H2, 빌드 22624 이상에 대한 2월 모멘트 업데이트 사용 가능) |
| 포커스 지원 | ms-settings:방해 금지 시간 |
| 그래픽 설정 | ms-settings:디스플레이-고급 그래픽(고급 그래픽 옵션을 지원하는 디바이스에서만 사용 가능) |
| 그래픽 기본 설정 | ms-settings:display-advancedgraphics-default |
| 멀티태스킹 |
ms-settings:멀티태스킹 ms-settings:멀티태스킹-sgupdate |
| 야간 조명 설정 | ms-settings:취침등 |
| 이 PC로 투영 | ms-settings:프로젝트 |
| 공유 환경 | ms-settings:크로스 디바이스 |
| 태블릿 모드 | ms-settings:tabletmode(Windows 11 제거됨) |
| Taskbar | ms-settings:작업 표시줄 |
| 알림 및 작업 | ms-settings:알림 |
| 원격 데스크톱 | ms-settings:원격 데스크톱 |
| Phone | ms-settings:휴대폰(Windows 10 버전 1809 이상에서 사용되지 않음) |
| 전원 및 절전 모드 | ms-settings:파워슬립 |
| 존재 감지 | ms-settings:현재 상태(Windows 11 버전 22H2, 빌드 22624에 대한 5월 모멘트 업데이트에 추가됨) |
| Storage | ms-settings:storagesense |
| 스토리지 센스 | ms-settings:스토리지 정책 |
| 스토리지 권장 사항 | ms-settings:스토리지 권장 사항 |
| 디스크 및 볼륨 | ms-settings:디스크 및 볼륨 |
시간 및 언어
| 설정 페이지 | URI |
|---|---|
| 날짜 & 시간 | ms-settings:날짜 및 시간 |
| 일본 IME 설정 | ms-settings:regionlanguage-jpnime(Microsoft 일본 입력 메서드 편집기가 설치된 경우 사용 가능) |
| 지역 | ms-settings:지역 서식 |
| Language |
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 |
| Speech | ms-settings:음성 |
| Wubi IME 설정 | ms-settings:regionlanguage-chsime-wubi(Microsoft Wubi 입력 메서드 편집기가 설치된 경우 사용 가능) |
업데이트 및 보안
| 설정 페이지 | URI |
|---|---|
| Activation | ms-settings:활성화 |
| 백업 | ms-settings:백업(Windows 11 페이지에서 제거됨, 동기화 열기) |
| 배달 최적화 |
ms-settings:배달 최적화 ms-settings:배달 최적화-최적화-활동 ms-settings:배달-최적화-고급 |
| 내 디바이스 찾기 | ms-settings:내 디바이스 찾기 |
| 개발자용 | ms-settings:개발자 |
| Recovery | ms-settings:복구 |
| 보안 키 등록 시작 | ms-settings:로그인 옵션 - 보안 키 등록 실행 |
| Troubleshoot | ms-settings:문제 해결 |
| Windows 보안 | ms-settings:windowsdefender |
| Windows 참가자 프로그램 |
ms-settings:windowsinsider(WIP에 사용자가 등록된 경우에만 해당) ms-settings:windowsinsider-optin |
| Windows 업데이트 |
ms-settings:Windows Update ms-settings:windowsupdate-action |
| Windows 업데이트-작동 시간 | ms-settings:Windows Update-사용 시간 |
| Windows 업데이트 - 고급 옵션들 | ms-settings:windowsupdate-options |
| Windows 업데이트-선택적 업데이트 | ms-settings:Windows 업데이트-선택적 업데이트 |
| Windows 업데이트 다시 시작 옵션 | ms-settings:windowsupdate-restartoptions |
| 요청 시 Windows 업데이트-Seeker | ms-settings:windowsupdate-seekerondemand |
| Windows 업데이트-View 업데이트 기록 | ms-settings:windowsupdate-history |
관련 콘텐츠
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
Windows developer