如何按Teams名称批量移除成员？求助PowerShell代码报错问题

你的错误根源是Select-Object user返回的是包含User属性的对象，而Remove-TeamUser的-User参数需要的是用户的UPN（用户主体名称）或Azure AD对象ID字符串，直接传入对象会导致系统无法识别资源。

修正后的代码 #

单Teams名称版本 #

Connect-MicrosoftTeams

# 获取指定名称的Team对象
$targetTeam = Get-Team -DisplayName "test"

# 获取该Team下所有成员，直接提取User属性的字符串值（UPN或ID）
$teamMembers = Get-TeamUser -GroupId $targetTeam.GroupId -Role Member | Select-Object -ExpandProperty User

# 遍历移除每个成员
foreach ($member in $teamMembers) {
    Remove-TeamUser -GroupId $targetTeam.GroupId -User $member
    Write-Host "已移除成员: $member"
}

多Teams名称版本（支持批量处理多个Team） #

Connect-MicrosoftTeams

# 定义需要处理的Teams名称列表
$teamNames = @("test1", "test2", "test3")

foreach ($teamName in $teamNames) {
    $targetTeam = Get-Team -DisplayName $teamName
    if (-not $targetTeam) {
        Write-Warning "未找到名为 $teamName 的Team，跳过处理"
        continue
    }

    $teamMembers = Get-TeamUser -GroupId $targetTeam.GroupId -Role Member | Select-Object -ExpandProperty User
    
    foreach ($member in $teamMembers) {
        Remove-TeamUser -GroupId $targetTeam.GroupId -User $member
        Write-Host "已从Team [$teamName] 移除成员: $member"
    }
}

关键修正点 #

• 使用Select-Object -ExpandProperty User代替Select-Object user：直接提取User属性的字符串值，而非保留对象结构
• 新增错误提示（多版本）：若指定名称的Team不存在，输出警告并跳过，避免后续代码报错
• 新增操作日志：用Write-Host输出移除结果，方便追踪执行状态

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