피플 앱 시작

중요합니다

Windows 피플 앱은 2024년 12월 31일에 지원을 종료했으며 Windows 11 버전 24H2 이상에서 제거되었습니다. 이 페이지에 설명된 ms-people: URI 체계는 최신 Windows 11 설치에서 더 이상 작동하지 않습니다. 애플리케이션의 연락처 관리는 새 Windows용 Outlook을 참조하세요.

이 설명서는 이전 Windows 버전으로 작업하는 개발자를 위해 참조용으로 유지 관리됩니다.

이 항목에서는 ms-people: URI 체계에 대해 설명합니다. WinUI, UWP 및 기타 Windows 데스크톱 앱은 이 URI 체계를 사용하여 특정 작업에 대한 피플 앱을 시작할 수 있습니다.

ms-people: URI 체계 참조

결과	URI 체계
다른 앱에서 피플 앱 기본 페이지를 시작할 수 있습니다.	ms-people:
다른 앱에서 피플 앱 설정 페이지를 시작할 수 있습니다.	ms-people:설정
다른 앱에서 검색 결과 페이지와 함께 피플 앱을 시작할 검색 문자열을 제공할 수 있습니다. 매개 변수는 대/소문자를 구분합니다. 구문을 올바르게 입력하지 않거나 검색 문자열 값이 누락된 경우 기본 동작은 필터링 없이 연락처의 전체 목록을 반환하는 것입니다.	ms-people:search?SearchString=<contactsearchinfo>
연락처가 발견되면 기존 연락처 카드로 이동합니다. 또는 연락처를 찾을 수 없는 경우 임시 연락처 카드로 시작합니다. 입력 매개 변수가 제공되지 않으면 연락처 목록을 사용하여 피플 앱을 시작합니다. 매개 변수는 대/소문자를 구분합니다. 매개 변수의 순서는 중요하지 않습니다. 둘 이상의 일치 항목이 있는 경우 연락처의 첫 번째 일치 항목을 반환합니다.	ms-people:viewcontact? ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj>
피플 앱 내의 연락처 저장 페이지로 이동하여 제공된 전화 번호 또는 전자 메일 주소로 지정된 연락처를 저장합니다. 매개 변수는 대/소문자를 구분합니다. 매개 변수의 순서는 중요하지 않습니다.	ms-people:savetocontact? PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>
피플 앱 내에서 새 연락처 추가 페이지를 시작하여 지정된 연락처를 저장합니다. LaunchUriForResultsAsync를 사용하여 새 연락처 저장 페이지를 엽니다. LaunchUriAsync를 사용하면 피플 앱 기본 페이지만 시작됩니다. 매개 변수는 대/소문자를 구분합니다. 매개 변수의 순서는 중요하지 않습니다. 지원되는 매개 변수의 조합을 사용할 수 있습니다.	ms-people:savecontacttask?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>

ms-people:search: 매개 변수 참조

매개 변수	설명	예시
SearchString	Optional. 연락처 검색 정보에 대한 검색 문자열입니다. 전화 번호 또는 연락처 이름입니다.	ms-people:search?SearchString=Smith

ms-people:viewcontact: 매개 변수 참조

매개 변수	설명	예시
연락처 ID	Optional. 연락처의 연락처 ID입니다.	ms-people:viewcontact?ContactId={ContactId}
PhoneNumber	Optional. 연락처의 전화 번호입니다.	ms-people:viewcontact?PhoneNumber=%2014257069326
메일 주소	Optional. 연락처의 전자 메일입니다.	ms-people:viewcontact? 전자 메일=johnsmith@contsco.com
ContactName	Optional. 연락처의 이름입니다.	ms-people:viewcontact?ContactName=John%20%Smith
연락처	Optional. 연락처 개체입니다.	ms-people:viewcontact?Contact={Serialized Contact}

ms-people:savetocontact: 매개 변수 참조

매개 변수	설명	예시
PhoneNumber	Optional. 연락처의 전화 번호입니다.	ms-people:savetocontact?PhoneNumber=%2014257069326
메일 주소	Optional. 연락처의 전자 메일입니다.	ms-people:savetocontact? 전자 메일=johnsmith@contsco.com
ContactName	Optional. 연락처의 이름입니다.	ms-people:savetocontact? Email=johnsmith@contsco.com&ContactName= John%20%Smith

ms-people:savecontacttask: 매개 변수 참조

매개 변수	설명
회사	Optional. 연락처의 회사 이름입니다.
FirstName	Optional. 연락처의 이름 중 첫 번째 이름입니다.
집주소도시	Optional. 집 주소의 도시입니다.
HomeAddressCountry	Optional. 집 주소의 국가입니다.
HomeAddressState	Optional. 집 주소 상태
HomeAddressStreet	Optional. 집 주소의 거리입니다.
HomeAddressZipCode	Optional. 집 주소의 우편 번호입니다.
HomePhone	Optional. 연락처의 집 전화.
JobTitle	Optional. 연락처의 직호입니다.
LastName	Optional. 연락처의 성씨입니다.
중간 이름	Optional. 연락처의 중간 이름입니다.
휴대폰	Optional. 연락처의 휴대폰 번호입니다.
별명	Optional. 연락처의 별명입니다.
Notes	Optional. 연락처에 대한 참고 사항입니다.
다른이메일	Optional. 연락처의 기타 전자 메일입니다.
PersonalEmail	Optional. 연락처의 개인 전자 메일입니다.
접미사	Optional. 연락처의 접미사입니다.
Title	Optional. 연락처의 제목입니다.
웹 사이트	Optional. 연락처의 웹 사이트입니다.
업무주소도시	Optional. 작업 주소의 도시입니다.
WorkAddressCountry	Optional. 회사 주소의 국가입니다.
WorkAddressState	Optional. 작업 주소의 상태입니다.
WorkAddressStreet	Optional. 작업 주소 거리
직장주소우편번호	Optional. 회사 주소의 우편 번호입니다.
WorkEmail	Optional. 연락처의 회사 전자 메일입니다.
WorkPhone	Optional. 연락처의 회사 전화 번호입니다.

관련 콘텐츠

URI를 사용하여 Windows app 실행합니다

URI에 대한 기본 앱을 실행합니다