如何实现PowerShell ForEach脚本并行处理多邮箱任务？

方案1：PowerShell 7+ 用ForEach-Object -Parallel（推荐） #

PowerShell 7及以上版本支持原生并行遍历，写法最简洁。核心是把单个邮箱的处理逻辑放到并行块中，注意块内引用外部变量要加$using:前缀，同时用-ThrottleLimit控制并发数（避免一次性跑满50个导致资源过载，比如设为10，可根据服务器性能调整）。

$mailboxes | ForEach-Object -Parallel {
    $mailbox = $_
    Write-Host "$(Get-TimeStamp) Start of adding contacts $($mailbox.UserPrincipalName)"
    & $using:scriptPath -Mailbox $mailbox.UserPrincipalName -ClientSecret $using:clientSecret -ClientID $using:clientID -TenantID $using:tenantID -CSVPath $using:csvPath
    Write-Host "$(Get-TimeStamp) Start of deduplicating contacts $($mailbox.UserPrincipalName)"
    & $using:scriptPath2 -Mailbox $mailbox.UserPrincipalName -ClientSecret $using:clientSecret -ClientID $using:clientID -TenantID $using:tenantID
} -ThrottleLimit 10

方案2：Windows PowerShell 用Start-Job兼容旧版本 #

如果还在使用Windows PowerShell 5.1及以下版本，可通过Start-Job启动后台作业，每个邮箱对应一个独立作业，最后统一等待所有作业完成并获取输出。

# 批量启动后台作业
$jobs = foreach ($mailbox in $mailboxes) {
    Start-Job -ScriptBlock {
        param($mailbox, $scriptPath, $scriptPath2, $clientSecret, $clientID, $tenantID, $csvPath)
        Write-Host "$(Get-TimeStamp) Start of adding contacts $($mailbox.UserPrincipalName)"
        & $scriptPath -Mailbox $mailbox.UserPrincipalName -ClientSecret $clientSecret -ClientID $clientID -TenantID $tenantID -CSVPath $csvPath
        Write-Host "$(Get-TimeStamp) Start of deduplicating contacts $($mailbox.UserPrincipalName)"
        & $scriptPath2 -Mailbox $mailbox.UserPrincipalName -ClientSecret $clientSecret -ClientID $clientID -TenantID $tenantID
    } -ArgumentList $mailbox, $scriptPath, $scriptPath2, $clientSecret, $clientID, $tenantID, $csvPath
}

# 等待所有作业完成并收集输出
Wait-Job $jobs | Receive-Job

关键注意事项 #

• 并发数要合理：别一次性跑满50个任务，根据机器CPU、内存或API接口限制调整并发数，避免资源耗尽或触发限流。
• 日志输出优化：并行时Write-Host的输出会混乱，建议给每个邮箱的日志单独写入文件，方便后续排查问题。
• 错误处理：可在并行块中加入try/catch逻辑，捕获单个邮箱处理时的错误，避免单个任务失败影响整体流程。

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