PowerShell从用户列表提取AD组并输出至文件的问题排查

原脚本存在的问题 #

1. 未显示用户名：$user是从文本读取的纯字符串，不是AD用户对象，$user.samaccountname无法获取有效值；且后续连续使用Select Name会丢弃之前的字段，完全丢失了用户标识信息。
2. 部分用户未处理：没有错误捕获机制，当遇到不存在的用户、无权限访问的AD对象时，脚本会直接抛出错误并终止，导致后续用户条目无法被处理。
3. 输出格式混乱：使用Format-Table(ft)生成的是面向控制台的格式化输出，多次追加到文件时会重复出现表头，且格式容易错位。

修正后的脚本 #

# 初始化结果数组
$results = @()
# 读取用户列表
$users = Get-Content C:\scripts\vendors.txt

foreach ($userName in $users) {
    try {
        # 获取AD用户对象，确保用户存在
        $adUser = Get-ADUser -Identity $userName -Properties samAccountName -ErrorAction Stop
        # 获取用户所属组
        $groups = Get-ADPrincipalGroupMembership $adUser | Sort-Object Name
        
        # 遍历组，为每个组条目添加用户名属性
        foreach ($group in $groups) {
            $results += [PSCustomObject]@{
                samAccountName = $adUser.samAccountName
                GroupName      = $group.Name
            }
        }
        
        # 记录当前用户的组信息到文本（带分隔符）
        Add-Content -Path C:\scripts\vendorlog.txt -Value "=== 用户 $($adUser.samAccountName) 的所属组 ==="
        $groups.Name | Add-Content -Path C:\scripts\vendorlog.txt
        Add-Content -Path C:\scripts\vendorlog.txt -Value ""
    }
    catch {
        # 记录无法查询的用户
        Add-Content -Path C:\scripts\vendorlog.txt -Value "⚠️ 无法查询用户：$userName，错误信息：$($_.Exception.Message)"
        Add-Content -Path C:\scripts\vendorlog.txt -Value ""
    }
}

# 输出为CSV文件，方便后续数据分析
$results | Export-Csv -Path C:\scripts\vendor_groups.csv -NoTypeInformation -Encoding UTF8

关键优化点 #

• 可靠获取用户信息：通过Get-ADUser验证用户存在性，并获取正式的AD用户对象，确保samAccountName准确无误。
• 错误处理机制：用try/catch捕获查询失败的情况，记录错误信息同时不中断后续用户的处理。
• 清晰的输出格式：
  • 文本文件输出：用分隔符区分不同用户的组信息，避免格式混乱。
  • CSV输出：生成结构化数据，方便用Excel或其他工具进一步分析。
• 完整处理所有用户：即使部分用户查询失败，脚本也会继续处理剩余条目。

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