---
title: 手动将本地 AD 用户匹配到已有 Office 365 用户
description: 介绍在 Azure AD Connect 同步环境中，将本地 Active Directory 用户手动匹配到已存在的 Office 365 用户的操作方法。内容涵盖适用场景、准备与风险、处理步骤、验证方法、回退建议及常见问题，重点说明 immutableId 的计算与设置，并强调备份、测试环境与回退的重要性。
url: "https://www.lanever.com/docs/%e6%89%8b%e5%8a%a8%e5%b0%86%e6%9c%ac%e5%9c%b0-ad-%e7%94%a8%e6%88%b7%e5%8c%b9%e9%85%8d%e5%88%b0%e5%b7%b2%e6%9c%89-office-365-%e7%94%a8%e6%88%b7/"
updated: "2026-10-12"
category: Office365
---

# 手动将本地 AD 用户匹配到已有 Office 365 用户

## 适用场景

企业使用 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 的命令与界面可能不同，请查阅对应版本官方文档。

> 提示：本文仅提供通用操作思路，实际执行前请在测试环境验证，并确认符合企业安全与合规要求。
