如何通过EWS/Graph API对Exchange中已导入的联系人按姓氏排序

方案1：Microsoft Graph API（优先推荐，适用于Exchange Online、Exchange 2019及以上版本） #

• 前置权限配置：在Azure AD注册应用，授予应用级权限Contacts.ReadWrite、MailboxSettings.ReadWrite，完成管理员全域同意后即可访问所有用户邮箱数据
• 核心实现逻辑：
  1. 遍历租户内所有用户，调用GET /users/{user-id}/mailFolders/msgfolderroot/childFolders/contacts定位用户默认联系人文件夹
  2. 通过PATCH接口修改联系人文件夹的扩展属性PR_CONTAINER_CONTENTS_SORT_ORDER（属性ID：0x36020003），赋值为0x00000003即可将文件夹默认排序规则设置为按姓氏升序，用户打开联系人时无需额外操作就会按姓氏展示
  3. 若需要永久固化联系人排序顺序，可调用GET /users/{user-id}/contacts?$orderby=lastName asc拉取排序后的联系人列表，批量更新每个联系人的PR_SORT_KEY扩展属性强制固定排列顺序
• 效率优化：使用Graph $batch 接口单次处理最多20个请求，配合分页参数$top=100和$skipToken遍历全量数据，可大幅降低接口调用耗时
• PowerShell 示例代码片段：

# 连接Graph API（需提前安装Microsoft Graph模块）
Connect-MgGraph -Scopes "Contacts.ReadWrite.All","MailboxSettings.ReadWrite.All"
# 获取全量租户用户
$allUsers = Get-MgUser -All
foreach ($user in $allUsers) {
    # 修改默认联系人文件夹排序规则
    $patchUri = "https://graph.microsoft.com/v1.0/users/$($user.Id)/mailFolders/msgfolderroot/childFolders/contacts"
    $body = @{
        singleValueExtendedProperties = @(
            @{
                id = "Integer 0x36020003"
                value = "3"
            }
        )
    }
    Invoke-MgGraphRequest -Method PATCH -Uri $patchUri -Body $body -ContentType "application/json"
}

方案2：EWS API（适用于Exchange 2013/2016本地部署版本） #

• 前置权限配置：给操作账号配置全域邮箱模拟权限Impersonation，确保可访问所有用户邮箱
• 核心实现逻辑：
  1. 初始化EWS服务，绑定每个用户的默认联系人文件夹
  2. 修改文件夹的PR_CONTAINER_CONTENTS_SORT_ORDER扩展属性，设置排序条件为LastName升序，保存修改后客户端刷新即可生效
  3. 若存在多个自定义联系人文件夹，遍历所有联系人文件夹批量修改即可

注意事项 #

• 操作前先选择2-3个测试邮箱验证规则生效后，再执行全域批量操作
• 批量执行时建议控制并发数在10-20之间，避免触发Exchange服务限流规则
• 若有用户使用自定义联系人视图，需要告知用户切换回默认视图即可看到按姓氏排序的效果

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