PowerShell脚本筛选AD禁用用户失败，请求故障排查

原脚本的核心问题 #

• 未关联CSV中的目标用户：循环内的Get-ADUser直接查询所有禁用状态的AD用户，完全没用到CSV里的$user.Username进行筛选，逻辑完全偏离需求
• Filter语法存在风险：使用脚本块{ Enabled -eq $false }作为Filter可能引发解析错误，PowerShell推荐对AD cmdlet使用字符串格式的Filter
• 未处理CSV列名匹配问题：如果你的CSV文件列名不是Username，$user.Username会返回空值，导致后续逻辑失效
• 数组追加效率低下：使用$results += $result会频繁重新创建数组，数据量大时性能很差
• 未处理多结果场景：如果Get-ADUser返回多个用户对象（比如重名），直接访问$adUser.SamAccountName会抛出属性访问错误

修正后的脚本 #

# 导入AD模块（先检查是否已加载）
if (-not (Get-Module -Name ActiveDirectory)) {
    Import-Module ActiveDirectory
}

# 指定CSV文件路径
$csvPath = "C:\UsersInDsable.csv"

# 读取CSV文件（确保CSV列名为Username，对应AD的SamAccountName）
$userList = Import-Csv -Path $csvPath

# 直接收集结果，替代低效的数组追加操作
$results = foreach ($user in $userList) {
    $username = $user.Username
    # 跳过CSV中的空用户名记录
    if (-not $username) {
        Write-Warning "CSV中存在空的用户名记录，已跳过"
        continue
    }

    # 使用字符串Filter精准查询指定用户，仅获取需要的属性
    $adUser = Get-ADUser -Filter "SamAccountName -eq '$username'" -Properties Enabled, DisplayName -ErrorAction SilentlyContinue

    if ($adUser) {
        # 输出自定义结果对象
        [PSCustomObject]@{
            SamAccountName = $adUser.SamAccountName
            DisplayName    = $adUser.DisplayName
            IsDisabled     = -not $adUser.Enabled
        }
    } else {
        Write-Warning "用户 '$username' 未在Active Directory中找到"
    }
}

# 在控制台输出结果（可选：导出到CSV文件）
$results | Format-Table -AutoSize
# $results | Export-Csv -Path "C:\DisabledUsers_Result.csv" -NoTypeInformation

关键修改说明 #

• 关联CSV目标用户：通过SamAccountName -eq '$username'精准查询CSV中的每个用户，确保只处理目标列表
• 安全的Filter格式：使用字符串Filter避免脚本块解析问题，同时注意单引号转义（若用户名含单引号，需额外处理为两个单引号）
• 空值检查：增加对CSV中空用户名的判断，避免无效查询
• 高效结果收集：直接在foreach中输出对象，PowerShell会自动收集为数组，比+=性能提升明显
• 容错处理：添加-ErrorAction SilentlyContinue避免单个用户查询失败导致脚本中断，同时用Write-Warning提示问题

额外注意事项 #

1. 确保CSV文件的列名是Username，且对应AD用户的SamAccountName；若CSV用其他列名（比如UserPrincipalName），需修改Filter为UserPrincipalName -eq '$username'
2. 运行脚本的账号需要具备AD读取权限
3. 若用户名包含单引号，需在查询前替换：$username = $username -replace "'", "''"

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