PowerShell Foreach循环获取API返回Agent ID时返回NULL问题

核心问题分析 #

1. 文本文件导入错误：你用Import-CSV读取纯文本文件AgentList.txt，这会把每行内容解析为CSV对象（而非字符串），导致后续$_.name -eq $agent的匹配完全失效——因为左边是字符串，右边是对象，永远不相等，自然返回NULL。
2. 变量命名冲突：循环内部重复使用$agentID变量，虽然不报错，但会降低代码可读性，容易引发逻辑混乱。
3. 潜在匹配问题：默认的-eq是区分大小写的，若API返回的agent名称和本地列表大小写不一致，也会导致匹配失败。

修复后的代码 #

# 读取纯文本列表，每行作为一个字符串
$agentList = Get-Content -Path 'O:\Test\AgentList.txt'

$Params = @{
    "Uri"     = "https://10.245.55.88:8834/agents"
    "Method"  = "GET"
    "Headers" = @{
        "X-ApiKeys" = "accessKey=$($AccessKey); secretKey=$($SecretKey)"
    }
    # 若站点证书不可信，添加此参数跳过验证（仅测试环境使用）
    # "SkipCertificateCheck" = $true
}

$agentsNotInSC = Invoke-Restmethod @Params

# 循环匹配，使用不区分大小写的匹配规则
$agentID = foreach ($agentName in $agentList) {
    # 跳过空行
    if ([string]::IsNullOrWhiteSpace($agentName)) { continue }
    $matchedAgent = $agentsNotInSC.agents | Where-Object { $_.name -eq $agentName }
    # 若匹配到则输出ID
    if ($matchedAgent) { $matchedAgent.id }
}

# 导出结果到CSV
$agentID | Export-Csv -Path "O:\Test\IDAgent.CSV" -NoTypeInformation

额外优化建议 #

• 若需要更宽松的匹配（比如允许部分字符串匹配），可以把-eq换成-like "*$agentName*"或-match $agentName。
• 可以添加日志输出，方便排查哪些agent没匹配到：

  $agentID = foreach ($agentName in $agentList) {
      if ([string]::IsNullOrWhiteSpace($agentName)) { continue }
      $matchedAgent = $agentsNotInSC.agents | Where-Object { $_.name -eq $agentName }
      if ($matchedAgent) { 
          $matchedAgent.id 
      } else {
          Write-Warning "未找到匹配的Agent: $agentName"
      }
  }
  

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