PowerShell查询多台GC服务器AD用户报参数类型错误的解决方法

Get-ADUser cmdlet的-Server参数仅接受单个字符串格式的服务器地址，不支持直接传入数组类型的$ServerList变量，这就是触发“无法将'System.Object[]'转换为参数'Server'要求的'System.String'类型”报错的直接原因。需要增加遍历层级的思路是正确的，原命令只做了用户列表的单层遍历，没有对GC服务器列表做循环处理。

实现逻辑为两层循环：外层逐台遍历所有GC服务器，内层在当前GC服务器上检索匹配目标用户，同时额外追加字段标记命中用户的所属GC，方便后续溯源定位。

$checkResult = @()
# 外层遍历所有全局编录服务器
foreach ($gcServer in $ServerList) {
    # 内层遍历待核查的用户列表，在当前GC上执行查询
    $matchedUsers = $UserList | ForEach-Object {
        $targetUpn = $_
        Get-ADUser -Server $gcServer -Filter "UserPrincipalName -like '*$targetUpn*'" -Properties UserPrincipalName, Enabled |
        # 追加自定义字段，记录当前命中用户的GC服务器地址
        Select-Object UserPrincipalName, Enabled, SamAccountName, DistinguishedName, @{
            Name = "LocatedGCServer"
            Expression = { $gcServer }
        }
    }
    $checkResult += $matchedUsers
}
# 导出结果为CSV文件，指定UTF8编码避免中文乱码，去掉多余类型头
$checkResult | Export-Csv -Path .\AD_User_Status_Result.csv -NoTypeInformation -Encoding UTF8

• 如果$UserList中存储的是完整的用户UPN值，建议将模糊匹配条件UserPrincipalName -like '*$targetUpn*'替换为精确匹配UserPrincipalName -eq $targetUpn，可以大幅提升AD查询效率，模糊匹配会触发AD全表扫描，在用户规模较大的域中执行速度很慢。
• 正常部署的AD林环境中，所有GC服务器会保持多主复制，存储林内全量AD对象的通用属性副本，在复制状态正常的前提下，连接任意一台GC即可完成全量用户查询，不需要逐台遍历5台服务器；逐台遍历仅适用于GC复制异常、需要核对多台GC数据差异的场景。
• 如果需要去除同一用户在多台GC上重复命中的冗余记录，可以在导出前追加去重逻辑：

$checkResult | Group-Object UserPrincipalName | ForEach-Object { $_.Group | Select-Object -First 1 } | Export-Csv -Path .\AD_User_Status_Result.csv -NoTypeInformation -Encoding UTF8

内容的提问来源于stack exchange，提问作者Ozgur Bulent Koza