如何检索并批量更新Microsoft 365联系人卡片中的手机号码？

问题根源 #

Outlook联系人卡片显示的信息不一定完全来自Entra ID的用户属性，部分号码可能仅存储在Exchange Online的用户邮箱联系人属性中，这部分数据不会自动同步到Entra的mobilePhone或businessPhones字段，导致你调用Entra用户API时返回空值。

可行解决方案 #

1. 检索Exchange侧的电话数据 #

使用Graph API的用户profile phones端点，获取Outlook联系人卡片显示的所有电话信息，包括未同步到Entra的号码：

GET https://graph.microsoft.com/v1.0/users/<User ID>/profile/phones

返回结果会包含电话类型（mobile、business等）和对应号码，可直接对应Outlook联系人卡片显示的内容。

2. 批量更新流程 #

同步Exchange号码到Entra

若需要统一将Outlook显示的号码同步到Entra，调用Entra用户更新API：

PATCH https://graph.microsoft.com/v1.0/users/<User ID>
Content-Type: application/json

{
  "mobilePhone": "13xxxxxxxxx",
  "businessPhones": ["010-xxxxxxx"]
}

直接更新Outlook联系人卡片

若只需修改Outlook显示的信息（无需同步到Entra），直接更新Exchange侧的profile字段：

PATCH https://graph.microsoft.com/v1.0/users/<User ID>/profile/phones/<Phone ID>
Content-Type: application/json

{
  "number": "更新后的号码",
  "type": "mobile" // 可选类型：home, business, mobile, other, assistant等
}

3. 排查同步异常 #

• 混合部署场景：检查Azure AD Connect的同步规则，确认未过滤电话字段，同时查看同步日志是否有错误。
• 纯云场景：确认用户是否手动在Outlook中修改过联系人卡片，这类手动修改的数据默认不会同步回Entra，需手动触发同步或通过API统一更新。

内容的提问来源于stack exchange，提问作者robhogg