People アプリを起動する

Important

Windows People アプリは 2024 年 12 月 31 日にサポートを終了し、Windows 11 バージョン 24H2 以降から削除されました。 このページに記載されている ms-people: URI スキームは、最新のWindows 11インストールでは機能しなくなりました。 アプリケーションの連絡先管理については、 新しい Outlook for Windows を参照してください。

このドキュメントは、以前のバージョンの Windows を使用する開発者向けの参照目的で管理されています。

このトピックでは、 ms-people: URI スキームについて説明します。 WinUI、UWP、およびその他の Windows デスクトップ アプリでは、この URI スキームを使用して、特定のアクションに対して People アプリを起動できます。

ms-people: URI スキーム リファレンス

結果	URI スキーム
他のアプリが People アプリのメイン ページを起動できるようにします。	ms-people:
他のアプリが People アプリの [設定] ページを起動できるようにします。	ms-people:設定
他のアプリが検索の結果ページで People アプリを起動する検索文字列を提供できるようにします。 パラメーターは大文字と小文字を区別します。 構文を正しく入力しない場合、または検索文字列の値がない場合、既定の動作では、フィルター処理なしで連絡先の完全な一覧が返されます。	ms-people:search?SearchString=<contactsearchinfo>
連絡先が見つかった場合は、既存の連絡先カードを起動します。 または、連絡先が見つからない場合は、一時的な連絡先カードを起動します。 入力パラメーターが指定されていない場合は、連絡先リストを含む People アプリを起動します。 パラメーターは大文字と小文字を区別します。 パラメーターの順序は関係ありません。 複数の連絡先に一致する場合は、最初の一致した連絡先を返します。	ms-people:viewcontact?ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber=<phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj>
連絡先アプリ内の [連絡先の保存] ページを起動し、指定した連絡先を指定した電話番号またはメール アドレスで保存します。 パラメーターは大文字と小文字を区別します。 パラメーターの順序は関係ありません。	ms-people:savetocontact?PhoneNumber=<phonenum>&Email=<email>&ContactName=<name>
People アプリ内の [新しい連絡先の追加] ページを起動して、指定された連絡先を保存します。 LaunchUriForResultsAsync を使用して、新しい連絡先の保存ページを開きます。 LaunchUriAsync を使用すると、People アプリのメイン ページのみが起動します。 パラメーターは大文字と小文字を区別します。 パラメーターの順序は関係ありません。 サポートされているパラメーターの任意の組み合わせを使用できます。	ms-people:savecontacttask?PhoneNumber=<phonenum>&Email=<email>&ContactName=<name>

ms-people:search: パラメーター リファレンス

パラメーター	説明	例
SearchString	このフィールドは省略可能です。 連絡先情報の検索文字列。 電話番号または連絡先名。	ms-people:search?SearchString=Smith

ms-people:viewcontact: パラメーターリファレンス

パラメーター	説明	例
連絡先 ID	このフィールドは省略可能です。 連絡先 ID。	ms-people:viewcontact?ContactId={ContactId}
電話番号	このフィールドは省略可能です。 連絡先の電話番号。	ms-people:viewcontact?PhoneNumber=%2014257069326
電子メール	このフィールドは省略可能です。 連絡先の電子メール。	ms-people:viewcontact?Email=johnsmith@contsco.com
ContactName	このフィールドは省略可能です。 連絡先の名前。	ms-people:viewcontact?ContactName=ジョン%20%20スミス
連絡先	このフィールドは省略可能です。 コンタクトオブジェクト。	ms-people:viewcontact?Contact={Serialized Contact}

ms-people:savetocontact: パラメーター参照

パラメーター	説明	例
電話番号	このフィールドは省略可能です。 連絡先の電話番号。	ms-people:savetocontact?PhoneNumber=%2014257069326
電子メール	このフィールドは省略可能です。 連絡先の電子メール。	ms-people:savetocontact?Email=johnsmith@contsco.com
ContactName	このフィールドは省略可能です。 連絡先の名前。	ms-people:savetocontact?Email=johnsmith@contsco.com>ContactName= John%20%Smith

ms-people:savecontacttask: パラメーターリファレンス

パラメーター	説明
会社	このフィールドは省略可能です。 連絡先の会社名。
FirstName	このフィールドは省略可能です。 連絡先の名前。
HomeAddressCity	このフィールドは省略可能です。 自宅の住所の市区町村。
HomeAddressCountry	このフィールドは省略可能です。 自宅の住所の国。
HomeAddressState	このフィールドは省略可能です。 自宅の住所の状態。
HomeAddressStreet	このフィールドは省略可能です。 自宅住所の通り。
HomeAddressZipCode	このフィールドは省略可能です。 自宅の住所の郵便番号。
HomePhone	このフィールドは省略可能です。 連絡先の自宅電話。
JobTitle	このフィールドは省略可能です。 連絡先の役職。
LastName	このフィールドは省略可能です。 連絡先の姓。
ミドルネーム	このフィールドは省略可能です。 連絡先のミドル ネーム。
携帯電話	このフィールドは省略可能です。 連絡先の携帯電話番号。
ニックネーム	このフィールドは省略可能です。 連絡先のニックネーム。
メモ	このフィールドは省略可能です。 連絡先に関するメモ。
その他のメール	このフィールドは省略可能です。 連絡先のその他の電子メール。
PersonalEmail	このフィールドは省略可能です。 連絡先の個人用電子メール。
Suffix	このフィールドは省略可能です。 連絡先のサフィックス。
タイトル	このフィールドは省略可能です。 連絡先のタイトル。
ウェブサイト	このフィールドは省略可能です。 連絡先の Web サイト。
職場の住所都市	このフィールドは省略可能です。 勤務先住所の市区町村。
WorkAddressCountry	このフィールドは省略可能です。 勤務先住所の国。
WorkAddressState	このフィールドは省略可能です。 作業アドレスの状態。
WorkAddressStreet	このフィールドは省略可能です。 勤務先住所の番地。
WorkAddressZipCode	このフィールドは省略可能です。 勤務先住所の郵便番号。
WorkEmail	このフィールドは省略可能です。 連絡先の職場の電子メール。
WorkPhone	このフィールドは省略可能です。 連絡先の勤務先電話番号。

関連するコンテンツ

URI を持つWindows appを起動します

URI の既定のアプリを起動する