通过文本文件中的DisplayName查询AD用户并导出CSV时文件为空的问题排查求助

我来帮你一步步排查并解决这个问题，先说说为什么你的CSV文件会是空的，再给你修正后的代码：

可能的问题根源 #

• 错误使用格式化工具导出数据：你用了Format-Table配合Out-File，但Format-Table是用来给人看的控制台格式化输出，它会把AD用户对象转换成纯文本表格，而不是保留结构化数据。而且每次循环里的Out-File默认是覆盖模式，如果最后一次查询没有匹配到用户，之前的内容就会被清空，最终文件就是空的。
• Filter语法的坑：在Get-ADUser里用脚本块{}写Filter时，变量$DN的解析有时候会不符合预期，尤其是带通配符的场景，容易导致查询不到结果。
• 输入数据或查询范围问题：你的displaynames.txt可能有空行、多余空格，或者SearchBase路径不对，导致根本找不到匹配的AD用户；也有可能当前账号没有AD查询权限，或者没加载AD模块。

先做基础排查（避免踩低级坑） #

• 先确认ActiveDirectory模块已加载：运行Import-Module ActiveDirectory，如果报错，先安装RSAT工具（Windows功能里的“Active Directory模块 for Windows PowerShell”）。
• 手动测试单个DisplayName：比如Get-ADUser -Filter "displayName -like '*张三*'" -SearchBase "DC=DOMAIN,DC=NET"，看有没有结果，验证Filter和SearchBase是否正确。
• 清理输入文件：用Get-Content c:\displaynames.txt | Where-Object { $_ -match '\S' } | ForEach-Object { $_.Trim() }检查一下，去掉空行和前后空格，避免无效的DisplayName。

修正后的代码（两种方案） #

方案1：先收集所有结果再一次性导出（推荐，内存占用小且逻辑清晰） #

# 加载AD模块
Import-Module ActiveDirectory

# 读取并清理DisplayName列表，过滤空行、去掉前后空格
$displayNames = Get-Content -Path c:\displaynames.txt | 
                Where-Object { $_ -match '\S' } | 
                ForEach-Object { $_.Trim() }

# 初始化数组存储所有查询结果
$allADUsers = @()

foreach ($dn in $displayNames) {
    # 用字符串格式的Filter，避免脚本块的变量解析问题
    $matchedUsers = Get-ADUser -Filter "displayName -like '*$dn*'" `
                               -SearchBase "DC=DOMAIN,DC=NET" `
                               -Properties Surname, GivenName, SamAccountName, UserPrincipalName
    
    if ($matchedUsers) {
        # 只保留需要的属性，添加到结果数组
        $allADUsers += $matchedUsers | Select-Object Surname, GivenName, SamAccountName, UserPrincipalName
    }
}

# 导出到CSV，-NoTypeInformation去掉多余的类型头，-Force覆盖现有文件
$allADUsers | Export-Csv -Path C:\UserAD.csv -NoTypeInformation -Force

方案2：循环中追加到CSV（适合超大批量数据，减少内存占用） #

Import-Module ActiveDirectory

$displayNames = Get-Content -Path c:\displaynames.txt | 
                Where-Object { $_ -match '\S' } | 
                ForEach-Object { $_.Trim() }

# 先删除旧的CSV文件（如果存在）
if (Test-Path C:\UserAD.csv) {
    Remove-Item C:\UserAD.csv -Force
}

foreach ($dn in $displayNames) {
    $matchedUsers = Get-ADUser -Filter "displayName -like '*$dn*'" `
                               -SearchBase "DC=DOMAIN,DC=NET" `
                               -Properties Surname, GivenName, SamAccountName, UserPrincipalName
    
    if ($matchedUsers) {
        # 第一次导出时添加表头，之后只追加内容
        if (-not (Test-Path C:\UserAD.csv)) {
            $matchedUsers | Select-Object Surname, GivenName, SamAccountName, UserPrincipalName | 
                            Export-Csv -Path C:\UserAD.csv -NoTypeInformation
        } else {
            $matchedUsers | Select-Object Surname, GivenName, SamAccountName, UserPrincipalName | 
                            Export-Csv -Path C:\UserAD.csv -Append
        }
    }
}

关键注意点 #

• 用Select-Object代替Format-Table：Select-Object会保留AD用户对象的结构化数据，这样Export-Csv才能生成正确的CSV格式，而不是纯文本表格。
• Filter用字符串格式：字符串格式的"displayName -like '*$dn*'"比脚本块更可靠，避免变量解析错误。
• 权限验证：尽量用有AD读取权限的账号运行PowerShell，最好以管理员身份启动。

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