适用场景 #
企业使用 Azure AD Connect 将本地 Active Directory 用户同步到 Microsoft 365 时,可能出现同一人员在云端已有账号、本地账号又新建的情况,导致重复用户或同步冲突。此时可手动将本地 AD 用户匹配到已有 Office 365 用户,使两者通过 immutableId 建立对应关系。
该操作适用于已部署 Azure AD Connect、且云端目标用户尚未被其他本地对象占用的场景。若目标用户已绑定其他本地对象,需先解除绑定,否则匹配会失败。
准备与风险 #
- 确认本地 AD 用户与云端目标用户确为同一人员,避免误匹配。
- 在测试环境先行验证完整流程,确认无误后再在生产环境执行。
- 操作前备份本地 AD 对象属性、Azure AD Connect 配置及云端用户信息。
- 记录云端用户的 ObjectId、UserPrincipalName 等关键属性,便于回退。
- 暂停同步期间,本地目录变更不会同步到云端,需评估业务影响。
- 删除云端用户会进入回收站,需确认可恢复或已保留必要数据。
- 具体命令参数与支持范围请查阅对应版本的官方文档。
处理步骤 #
1. 暂停同步服务 #
在 Azure AD Connect 服务器上停止同步服务,避免操作过程中同步任务覆盖变更。
2. 计算本地用户 immutableId #
在本地域控制器的 PowerShell 中执行,将 [本地用户名] 替换为实际账号:
$user = "[本地用户名]"
$guid = [guid]((Get-ADUser -Identity $user).objectGuid)
$immutableId = [System.Convert]::ToBase64String($guid.ToByteArray())
Write-Host $immutableId
记录输出的 immutableId,后续步骤需要使用。
3. 删除云端重复用户 #
在 Microsoft 365 管理中心删除云端重复用户,并从“已删除用户”中执行永久删除,释放该用户占用的属性。执行前请确认已备份必要数据。
4. 连接云端并获取目标用户 ObjectId #
在 PowerShell 中连接云端服务,查询目标用户:
Connect-AzureAD
Get-AzureADUser -ObjectId "[云端用户登录名]"
记录返回的 ObjectId。
5. 设置 immutableId #
将第 2 步得到的 immutableId 写入云端目标用户:
Set-AzureADUser -ObjectId "[云端用户ObjectId]" -ImmutableId "[immutableId]"
6. 恢复同步 #
在 Azure AD Connect 服务器上启动同步服务,并手动触发一次增量同步。具体命令请参考对应版本官方文档。
验证方法 #
- 在 Microsoft 365 管理中心查看该用户状态,确认已与本地对象关联。
- 在 Azure AD Connect 中查看同步状态,确认无冲突或错误提示。
- 检查用户属性是否与本地 AD 一致,例如显示名、登录名等。
- 使用测试账号登录,确认可正常访问已授权资源。
回退建议 #
- 若匹配错误,可清除云端用户的 immutableId,再重新执行匹配流程。
- 若云端用户被误删,可在回收站保留期内尝试恢复;超过保留期需从备份重建。
- 回退前再次暂停同步服务,避免变更被同步覆盖。
- 保留操作记录与备份,便于追溯和恢复。
常见问题 #
- 匹配失败:目标用户可能已绑定其他本地对象,需先解除绑定。
- 同步冲突:本地与云端属性不一致,需核对并统一关键属性。
- immutableId 计算错误:确认使用 objectGuid 并正确转换为 Base64。
- 权限不足:执行命令的账号需具备相应目录管理权限。
- 版本差异:不同版本 Azure AD Connect 的命令与界面可能不同,请查阅对应版本官方文档。
提示:本文仅提供通用操作思路,实际执行前请在测试环境验证,并确认符合企业安全与合规要求。
