PowerShell脚本问题：AD用户匹配CSV邮箱仅输出最后一条，需导出CSV

我来帮你搞定这个问题，你的脚本有几个关键问题导致只返回最后一条结果，而且导出格式不符合需求，咱们一步步修改：

原脚本的核心问题 #

1. Out-File覆盖模式：默认情况下Out-File会覆盖文件内容，每次循环写入一条数据时都会清空之前的内容，最后只剩最后一条匹配项。
2. 匹配逻辑错误：$CATOemail -in $ademail的用法不对，-in是检查左侧值是否存在于右侧的集合中，但$ademail是单个用户的邮箱字符串，应该直接用相等判断（-eq，大小写敏感；或-ieq，大小写不敏感）。
3. 嵌套循环效率低：遍历CSV的同时再遍历所有AD用户，当数据量较大时会很慢，我们可以用哈希表优化查找速度。
4. 导出格式不符合需求：你需要的是CSV文件而非TXT，且要指定明确的列名。

修改后的PowerShell脚本 #

# 导入CSV文件
$CATO = Import-Csv -Path "C:\test\testimport.csv"

# 获取所有AD用户的信息，并构建邮箱到用户对象的哈希表（优化查找效率）
$adUserHash = @{}
Get-ADUser -Filter * -Properties Name, Office, UserPrincipalName | ForEach-Object {
    $adUserHash[$_.UserPrincipalName] = $_
}

# 初始化数组存储匹配结果
$matchingUsers = @()

# 遍历CSV中的每一项
foreach($CATOitem in $CATO){
    $CATOemail = $CATOitem.Email
    # 检查当前CSV中的邮箱是否存在于AD用户哈希表中
    if($adUserHash.ContainsKey($CATOemail)){
        # 提取需要的属性，构建自定义对象（指定列名）
        $matchedUser = [PSCustomObject]@{
            "NAME" = $adUserHash[$CATOemail].Name
            "OFFICE" = $adUserHash[$CATOemail].Office
            "EMAIL" = $adUserHash[$CATOemail].UserPrincipalName # 可选，如果你需要保留邮箱列
        }
        # 将匹配的用户添加到结果数组
        $matchingUsers += $matchedUser
    }
}

# 将结果导出为CSV文件（-NoTypeInformation避免导出类型信息）
$matchingUsers | Export-Csv -Path "C:\test\testresult.csv" -NoTypeInformation -Encoding UTF8

关键改进说明 #

• 哈希表优化：通过$adUserHash把AD用户的邮箱作为键，用户对象作为值，这样查找匹配邮箱的时间复杂度从O(n)降到O(1)，处理500条数据会快很多。
• 结果数组收集：先把所有匹配结果存入数组，最后一次性导出，避免了频繁写入文件的开销，也不会出现覆盖问题。
• 自定义对象指定列名：用[PSCustomObject]构建包含你需要的NAME、OFFICE（可选添加EMAIL）列的对象，导出CSV时会自动使用这些列名。
• Export-Csv替代Out-File：专门用于导出CSV格式，-NoTypeInformation参数可以去掉文件开头的类型注释，-Encoding UTF8确保中文等特殊字符显示正常。

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