使用Add-UnifiedGroupLinks批量添加Office365组成员时遇对象找不到错误

你遇到的核心问题是对Add-UnifiedGroupLinks的-Links参数类型理解有误——这个参数接受的是字符串数组，而非单个包含逗号分隔值的字符串。当你传递拼接好的user1@domain.com,user2@domain.com单个字符串时，PowerShell会把整个内容当成一个用户标识符去查找，自然会返回“找不到对象”的错误；而手动输入逗号分隔值时，PowerShell会自动将其解析为字符串数组，所以能正常执行。

推荐的批量处理修正代码 #

放弃StringBuilder拼接字符串的方式，直接将用户收集到数组中，达到指定批次大小后批量传递给命令，既符合参数要求，又能大幅提升性能：

$batchSize = 500 # 可尝试调大到500（Office 365单批次最大支持数）
$groupName = "MyGroupName"
$userBatch = @()

Import-CSV "myCSV.csv" | ForEach-Object {
    $userBatch += $_.UserPrincipalName
    # 达到批次阈值时执行添加操作
    if ($userBatch.Count -eq $batchSize) {
        Add-UnifiedGroupLinks –Identity $groupName –LinkType Members –Links $userBatch
        Write-Host "Completed batch: $($userBatch -join ',')"
        $userBatch = @() # 重置批次数组
    }
}

# 处理循环结束后剩余的未批量用户
if ($userBatch.Count -gt 0) {
    Add-UnifiedGroupLinks –Identity $groupName –LinkType Members –Links $userBatch
    Write-Host "Completed final batch: $($userBatch -join ',')"
}

保留StringBuilder逻辑的修正方案 #

如果想维持原有的拼接思路，只需在传递前将字符串拆分为数组即可：

$sb = New-Object System.Text.StringBuilder
$i = 1
$batchSize = 20
$groupName = "MyGroupName"

Import-CSV "myCSV.csv" | ForEach-Object {
    [void]$sb.Append($_.UserPrincipalName + ',')
    if($i -eq $batchSize) {
        $sb.Length-- # 移除末尾多余的逗号
        $usersArray = $sb.ToString() -split ',' # 将字符串拆分为数组
        Add-UnifiedGroupLinks –Identity $groupName –LinkType Members –Links $usersArray
        Write-Host $sb.ToString()
        $sb.Clear()
        $i = 1
    } Else {$i++}
}

# 处理剩余未批量的用户
if ($sb.Length -gt 0) {
    $sb.Length--
    $usersArray = $sb.ToString() -split ','
    Add-UnifiedGroupLinks –Identity $groupName –LinkType Members –Links $usersArray
}

额外性能优化建议 #

• 最大化批次大小：将$batchSize调整为500（Office 365允许的单批次最大成员数），能大幅减少API调用次数，直接提升处理速度。
• 更新Exchange Online模块：确保安装最新版本的ExchangeOnlineManagement模块，新模块在性能和稳定性上都优于旧版本。

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