Get-AssociatedTeam不支持用户数组参数，批量处理用户关联团队需求解

先修正直接触发报错的问题 #

你的代码里有个明显的低级错误：foreach循环中调用Get-AssociatedTeam时，传入的是整个用户数组$userIds，而非当前循环的单个用户$userId，这就是报错的直接原因。修正后的基础循环代码如下：

# 导入模块并连接Teams
Connect-MicrosoftTeams 

# 用户ID列表
$userIds = "user1@domain.com", "user2@domain.com", "user3@domain.com"

# 用于存储最终结果的数组
$userTeamList = @()

# 修正后的循环逻辑
foreach ($userId in $userIds) {
    try {
        # 传入单个用户ID获取关联Teams
        $teams = Get-AssociatedTeam -User $userId -ErrorAction Stop
        
        # 获取用户部门信息（用于后续分组）
        $userInfo = Get-MgUser -UserId $userId -Property Department, DisplayName -ErrorAction Stop
        
        # 将用户与对应Team信息整理成统一对象
        foreach ($team in $teams) {
            $userTeamList += [PSCustomObject]@{
                UserId       = $userId
                UserName     = $userInfo.DisplayName
                Department   = $userInfo.Department
                TeamId       = $team.GroupId
                TeamName     = $team.DisplayName
                TeamNickname = $team.Nickname
            }
        }
    }
    catch {
        Write-Warning "处理用户 $userId 时出错：$($_.Exception.Message)"
    }
}

# 按部门分组输出结果
$userTeamList | Group-Object Department | ForEach-Object {
    Write-Host "`n=== 部门：$($_.Name) ==="
    $_.Group | Select-Object UserId, UserName, TeamName | Format-Table -AutoSize
}

提升300用户批量处理的效率 #

单个循环处理300个用户速度偏慢，推荐用PowerShell 7+的并行处理，通过ForEach-Object -Parallel同时处理多个用户，注意需要传递Teams连接上下文（并行会话是独立的）：

# 需使用PowerShell 7及以上版本
Connect-MicrosoftTeams 

$userIds = "user1@domain.com", "user2@domain.com", "user3@domain.com"

# 导出当前Teams连接上下文，供并行会话复用
$teamsContext = Get-TeamsContext

# 并行处理用户列表
$userTeamList = $userIds | ForEach-Object -Parallel {
    # 在并行会话中重新连接Teams
    $null = Connect-MicrosoftTeams -Context $using:teamsContext -ErrorAction Stop
    
    $userId = $_
    try {
        $teams = Get-AssociatedTeam -User $userId -ErrorAction Stop
        $userInfo = Get-MgUser -UserId $userId -Property Department, DisplayName -ErrorAction Stop
        
        foreach ($team in $teams) {
            [PSCustomObject]@{
                UserId       = $userId
                UserName     = $userInfo.DisplayName
                Department   = $userInfo.Department
                TeamId       = $team.GroupId
                TeamName     = $team.DisplayName
                TeamNickname = $team.Nickname
            }
        }
    }
    catch {
        Write-Warning "处理用户 $userId 时出错：$($_.Exception.Message)"
        return $null
    }
} -ThrottleLimit 10 # 控制并行数量，避免触发微软API请求限制

# 过滤错误结果并按部门分组输出
$userTeamList | Where-Object { $_ -ne $null } | Group-Object Department | ForEach-Object {
    Write-Host "`n=== 部门：$($_.Name) ==="
    $_.Group | Select-Object UserId, UserName, TeamName | Format-Table -AutoSize
}

关键注意事项 #

• 并行处理的ThrottleLimit建议设为5-15，过高容易触发Microsoft Graph的请求频率限制。
• 若仍使用PowerShell 5.1，无法使用-Parallel参数，可考虑用Start-Job实现批量处理，但管理成本更高，推荐升级到PowerShell 7。
• 需提前安装Microsoft.Graph.Users模块获取用户部门信息：Install-Module -Name Microsoft.Graph.Users -Force
• 确保账号拥有足够权限：Team Member.Read.All/Team.ReadBasic.All（获取关联Teams）、User.Read.All（获取用户部门信息）。

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