PowerShell中Export-CSV导出AD外部用户数据异常问题求助

问题描述 #

需要编写PowerShell脚本实现以下功能：指定AD用户，查询其直接汇报的用户列表，筛选出UserPrincipalName以EXT.开头的外部用户，最终将这些用户的账号名与账号过期日期导出到CSV文件。但当前脚本导出结果异常，仅得到错误内容。原脚本如下：

$external_users_data = @{}

$if_ext_user = Get-AdUser -Identity xxxx.xxxx -Properties DirectReports | Select -ExpandProperty DirectReports 
ForEach ($user in $if_ext_user) 
    {
        $U = Get-AdUser -identity $user -Property *
            if ($U.UserPrincipalName -like 'EXT.*'){

                Write-Output $U.UserPrincipalName
                Write-Output $U.AccountExpirationDate
                <#$user_object = @{
                    AccountName = $U.UserPrincipalName
                    ExpirationDate = $U.AccountExpirationDate
                    }#>
                    $external_users_data.add($U.UserPrincipalName,$U.AccountExpirationDate)}}
                                                         
                
Write-Host $external_users_data
                   
[ExtAccount_expiration_dates]@{AccountName = $U.UserPrincipalName; ExpirationDate = $U.AccountExpirationDate} |Export-Csv -Append -Path 'C:xxxxxxxxx/csv'

问题根源 #

1. 导出逻辑错误：脚本最后试图使用不存在的自定义类型[ExtAccount_expiration_dates]创建对象，且仅处理了循环中最后一个符合条件的用户，未遍历所有收集到的数据。
2. 资源浪费：Get-AdUser -Property *会获取AD用户的所有属性，完全没必要，仅需指定UserPrincipalName和AccountExpirationDate两个属性即可。
3. 数据存储方式不当：用哈希表存储键值对，后续导出CSV时需要额外转换，不如直接收集自定义对象更便捷。
4. 路径格式错误：导出路径C:xxxxxxxxx/csv不符合Windows路径规范，需使用反斜杠\且指定具体文件名。

修正后的脚本 #

# 初始化数组存储结果
$externalUsers = @()

# 获取指定用户的直接汇报人列表
$directReports = Get-AdUser -Identity "xxxx.xxxx" -Properties DirectReports | Select-Object -ExpandProperty DirectReports

foreach ($userDN in $directReports) {
    # 仅获取需要的属性，降低AD查询负载
    $adUser = Get-AdUser -Identity $userDN -Properties UserPrincipalName, AccountExpirationDate
    
    # 筛选UserPrincipalName以EXT.开头的外部用户
    if ($adUser.UserPrincipalName -like 'EXT.*') {
        # 创建结构化自定义对象并添加到结果数组
        $externalUsers += [PSCustomObject]@{
            AccountName    = $adUser.UserPrincipalName
            ExpirationDate = $adUser.AccountExpirationDate
        }
    }
}

# 导出到CSV文件，注意路径格式需正确
$externalUsers | Export-Csv -Path "C:\xxxxxxxxx\external_users_expiration.csv" -NoTypeInformation -Encoding UTF8

关键优化说明 #

• 精准属性查询：仅请求必要的AD属性，提升脚本运行效率并减少资源占用。
• 结构化数据存储：用[PSCustomObject]创建符合CSV导出要求的结构化数据，直接导出即可生成带表头的正确格式。
• 规范导出配置：添加-NoTypeInformation避免CSV开头出现冗余类型信息，-Encoding UTF8保证文件编码兼容性。
• 路径修正：使用Windows标准路径格式，指定明确的CSV文件名。

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