C#操作AD时DirectoryEntry.Properties["mail"]与UserPrincipal.EmailAddress的区别

二者的本质差异是封装层级和映射的AD原生属性不同：

• UserPrincipal.EmailAddress 是.NET 封装的 System.DirectoryServices.AccountManagement 抽象层提供的属性，它底层默认映射的是AD用户的 proxyAddresses 属性中前缀为SMTP:（大写代表主邮箱）的地址值，并非直接读取AD的mail原生字段。
• DirectoryEntry.Properties["mail"] 是直接访问AD用户对象的原生mail属性，对应AD用户属性面板中「电子邮件」字段的原始填写值，没有经过上层封装的逻辑过滤。

大部分场景下二者返回值是相同的，出现差异的常见原因：

1. AD环境未部署Exchange服务：proxyAddresses是Exchange扩展AD架构后才会自动维护的属性，纯AD环境中管理员只会手动填写mail字段，不会维护proxyAddresses，此时UserPrincipal.EmailAddress就会返回null，但mail属性有值。
2. 数据同步异常：如果有Exchange服务，手动修改mail字段后没有同步更新proxyAddresses属性，也会导致二者取值不一致。
3. 权限/属性加载问题：UserPrincipal默认查询时未加载对应扩展属性、或者查询账号没有读取proxyAddresses的权限，也会出现返回null的情况。

可以直接用PowerShell脚本实现单用户/批量用户的取值对比，示例脚本如下：

# 加载所需程序集
Add-Type -AssemblyName System.DirectoryServices.AccountManagement
# 绑定当前域上下文
$domainContext = [System.DirectoryServices.AccountManagement.ContextType]::Domain
$principalContext = New-Object System.DirectoryServices.AccountManagement.PrincipalContext($domainContext)

# 替换为目标用户的SamAccountName/用户PrincipalName
$targetUser = [System.DirectoryServices.AccountManagement.UserPrincipal]::FindByIdentity($principalContext, "你要查询的用户名")

if ($targetUser) {
    # 读取UserPrincipal的邮箱值
    $upEmail = $targetUser.EmailAddress
    # 读取原生mail属性值
    $directoryEntry = $targetUser.GetUnderlyingObject() -as [System.DirectoryServices.DirectoryEntry]
    $rawMail = $directoryEntry.Properties["mail"].Value?.ToString()

    # 输出对比结果
    Write-Host "=== 取值对比结果 ==="
    Write-Host "UserPrincipal.EmailAddress：$upEmail"
    Write-Host "AD原生mail属性：$rawMail"
    Write-Host "二者是否相等：$($upEmail -eq $rawMail)"
} else {
    Write-Host "未找到指定用户"
}

如果需要批量对比，只需要加遍历逻辑获取所有用户再逐个输出即可。

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