PowerShell ForEach遍历Exchange邮箱脚本仅执行首个邮箱问题排查

你的脚本仅处理首个邮箱就停止，大概率是以下原因之一：

1. 点 sourcing 调用子脚本引发作用域冲突 #

你用.（点 sourcing）执行子脚本，会将子脚本内容加载到当前会话作用域运行。如果子脚本里存在exit这类终止整个会话的命令、覆盖父脚本变量（比如也定义了$mailbox），或者设置了全局错误终止策略，都会直接打断父脚本的循环。

解决方法：改用&在独立作用域调用子脚本，避免影响父循环：

$mailboxes = Get-EXOMailbox -resultsize unlimited -RecipientTypeDetails usermailbox
Foreach($mailbox in $mailboxes){
    & .\graph-PopulateContactsFromCSV.ps1 -Mailbox $mailbox.UserPrincipalName -ClientSecret $clientSecret -ClientID $clientID -TenantID $tenantID -CSVPath $csvPath
}

2. 子脚本包含终止执行的命令 #

检查graph-PopulateContactsFromCSV.ps1，如果里面有exit命令，会直接结束整个PowerShell会话，导致循环中断。若需退出子脚本，应改用return（仅终止子脚本，父循环会继续），或在子脚本内部循环中用break。

3. 未处理子脚本的错误 #

如果子脚本处理首个邮箱时触发错误，且脚本设置了$ErrorActionPreference = 'Stop'，会直接终止整个执行流程。

排查方法：在循环中添加日志输出，确认循环是否真的中断，以及子脚本的执行状态：

$mailboxes = Get-EXOMailbox -resultsize unlimited -RecipientTypeDetails usermailbox
Foreach($mailbox in $mailboxes){
    Write-Host "开始处理邮箱: $($mailbox.UserPrincipalName)"
    & .\graph-PopulateContactsFromCSV.ps1 -Mailbox $mailbox.UserPrincipalName -ClientSecret $clientSecret -ClientID $clientID -TenantID $tenantID -CSVPath $csvPath -ErrorAction Continue
    Write-Host "完成处理邮箱: $($mailbox.UserPrincipalName)"
}

通过日志可直观看到每个邮箱的处理节点，定位是否在某个步骤卡住。

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