Azure自动化账户中PowerShell脚本查询错误及数组失效问题

针对你已修复Graph API查询过滤条件引号问题，但$Datos数组仍无法正常填充的情况，可从以下方向排查解决：

1. 验证查询结果有效性 #

先确认修改过滤条件后的用户查询确实返回数据：

$users = Get-MgUser -Filter "userPrincipalName eq 'target-user@domain.com'"
Write-Output "查询到用户数: $($users.Count)"
# 输出完整用户对象结构，确认数据存在
Write-Output "用户详情: $($users | ConvertTo-Json -Depth 3)"

如果输出用户数为0，说明过滤逻辑仍有问题，需检查userPrincipalName的格式、拼写是否完全匹配，或调整过滤规则（比如用contains替代eq，注意Graph API支持的运算符限制）。

2. 规范数组初始化与赋值逻辑 #

• 确保$Datos正确初始化为空数组：

  $Datos = @()
  

• 若直接将查询结果赋值给$Datos，单条结果会被识别为单个对象而非数组，可强制转换：

  $Datos = @(Get-MgUser -Filter "userPrincipalName eq 'target-user@domain.com'")
  

• 若需自定义数组元素（仅提取特定属性），用循环遍历添加：

  $users = Get-MgUser -Filter "userPrincipalName eq 'target-user@domain.com'"
  $Datos = @()
  foreach ($user in $users) {
      $Datos += [PSCustomObject]@{
          UPN = $user.UserPrincipalName
          姓名 = $user.DisplayName
          邮箱 = $user.Mail
          # 根据需求添加其他属性
      }
  }
  

3. 检查自动化账户权限 #

确认Azure自动化账户的运行身份（托管身份）已配置足够的Graph API权限：

• 需至少拥有User.Read.All或Directory.Read.All权限（根据脚本操作范围选择）
• 在Azure门户进入自动化账户→身份→权限，添加对应Graph API权限并完成管理员同意

4. 处理Graph API分页 #

若查询结果超过Graph API默认分页限制（100条），需启用全量获取：

• 使用-All参数（适用于新版Microsoft Graph PowerShell模块）：

  $Datos = @(Get-MgUser -Filter "userPrincipalName contains '@domain.com'" -All)
  

• 手动处理分页（兼容旧版本模块）：

  $Datos = @()
  $nextLink = $null
  do {
      $users = Get-MgUser -Filter "userPrincipalName contains '@domain.com'" -SkipToken $nextLink
      $Datos += $users
      $nextLink = $users.AdditionalProperties['@odata.nextLink']
  } while ($nextLink)
  

内容的提问来源于stack exchange，提问作者Iván Montero