PowerShell脚本未按CSV数据修改AD域用户密码设置排错

你的脚本主要存在3个会直接导致配置不生效的逻辑错误，还有1个易引发故障的隐患：

• AD查询过滤器变量不展开（核心故障原因）：Get-ADUser的-Filter参数使用单引号包裹查询条件，PowerShell中单引号字符串属于字面量字符串，不会自动解析替换其中的$LastName、$FirstName变量，实际执行时会直接把$LastName/$FirstName当字符串值去AD里匹配surname和givenName属性，根本查不到目标用户，后续的属性设置自然无法生效。
• 循环内变量重名+无空值校验：ForEach迭代的CSV行对象变量名为$User，循环内部又将AD查询结果赋值给同名的$User变量，一旦AD查询无结果返回$null，后续Set-ADUser会因为接收到空的身份参数直接报错终止；如果匹配到多个同名用户，还会因为传入对象类型不符合要求触发报错。
• 无匹配结果/重名场景的容错缺失：脚本默认First Name+Last Name的组合一定能唯一匹配到一个AD用户，但实际生产环境中大概率存在同名用户、CSV字段值为空、姓名拼写和AD录入不一致的情况，没有做分支判断的情况下，脚本要么静默失败要么误操作。
• 额外优化点：两次Set-ADUser调用可以合并为一次，减少和AD域控的交互次数，提升执行效率。

Import-Module ActiveDirectory -ErrorAction Stop

# 读取CSV前先校验文件路径
$csvPath = "C:\users-to-reset.csv"
if (-not (Test-Path -Path $csvPath)) {
    throw "CSV文件不存在，请检查路径配置：$csvPath"
}
$Users = Import-Csv -Path $csvPath

ForEach ($csvUser in $Users) {
    $LastName = $csvUser.LastName.Trim()
    $FirstName = $csvUser.FirstName.Trim()

    # 跳过CSV中空姓/空名的无效行
    if ([string]::IsNullOrWhiteSpace($LastName) -or [string]::IsNullOrWhiteSpace($FirstName)) {
        Write-Warning "跳过空姓名的CSV行"
        continue
    }

    # Filter使用双引号，属性值额外套单引号避免特殊字符解析问题
    $adUser = Get-ADUser -Filter "surname -eq '$LastName' -and givenName -eq '$FirstName'"
    # 校验查询结果合法性
    if (-not $adUser) {
        Write-Warning "未找到匹配的AD用户：姓$LastName 名$FirstName"
        continue
    }
    if ($adUser.Count -gt 1) {
        Write-Warning "匹配到多个同名AD用户，跳过配置：姓$LastName 名$FirstName"
        continue
    }

    # 单次调用完成所有密码属性配置
    Set-ADUser -Identity $adUser -PasswordNeverExpires:$false -CannotChangePassword:$false
    Write-Host "已成功配置用户密码属性：$($adUser.Name)"
}

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