如何在Microsoft Teams中将用户添加至所有团队的所有频道（含私有频道）

原脚本仅实现了将用户添加到团队级别，无法覆盖频道（尤其是私有频道）——因为Teams的团队与频道是分层结构，私有频道还关联独立的Microsoft 365组，必须单独处理频道级别的添加操作。

修正后的PowerShell脚本 #

# 连接Microsoft Teams服务
Connect-MicrosoftTeams

# 替换为目标用户的邮箱地址
$targetUser = "USER-EMAIL"

# 获取租户内所有Teams团队
$allTeams = Get-Team

foreach ($team in $allTeams) {
    Write-Host "正在处理团队: $($team.DisplayName)"

    # 可选：将用户添加至团队级别（若需要赋予团队成员基础权限）
    try {
        Add-TeamUser -GroupId $team.GroupId -User $targetUser -Role Owner -ErrorAction Stop
        Write-Host "已将用户添加至团队 $($team.DisplayName)"
    }
    catch {
        Write-Warning "添加用户到团队 $($team.DisplayName) 失败: $_"
    }

    # 获取当前团队下的所有频道（包含私有频道）
    $allChannels = Get-TeamChannel -GroupId $team.GroupId

    foreach ($channel in $allChannels) {
        Write-Host "  正在处理频道: $($channel.DisplayName)"

        # 将用户添加至目标频道
        try {
            # 私有频道与公开频道均适用该命令
            Add-TeamChannelUser -TeamId $team.GroupId -ChannelId $channel.Id -User $targetUser -Role Member -ErrorAction Stop
            Write-Host "  已将用户添加至频道 $($channel.DisplayName)"
        }
        catch {
            Write-Warning "  添加用户到频道 $($channel.DisplayName) 失败: $_"
        }

        # 控制请求频率，避免触发API限制
        Start-Sleep -Seconds 1
    }

    Start-Sleep -Seconds 2
}

核心说明 #

• 分层权限处理：Add-TeamUser仅负责团队成员身份，频道级别的权限需要通过Add-TeamChannelUser单独配置
• 私有频道兼容：Get-TeamChannel默认会返回团队下的所有频道类型，无需额外参数即可覆盖私有频道
• 异常容错：加入try/catch块捕获操作异常，避免单个团队/频道的添加失败导致整个脚本终止
• 请求限流：通过Start-Sleep控制请求间隔，防止触发Teams API的调用频率限制

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