并行创建Exchange Online远程邮箱时Session参数验证失败求助

问题根源 #

Exchange Online对单个用户的并发远程PowerShell会话有默认限制（通常为10个），当并行触发50+脚本时，大量请求同时创建会话会超出该限制，导致New-PSSession执行失败并返回null，后续Import-PSSession接收null参数时就会抛出你遇到的错误。

解决方案 #

1. 复用会话而非每个用户新建会话 #

不要为每个用户单独创建会话，改为一次性创建一个会话，批量处理所有新建用户，大幅减少会话数量，避免触发限制。

示例脚本：

# 创建单个Exchange会话
$so = New-PSSessionOption -SkipCNCheck
try {
    $ExchangeSession = New-PSSession -ConfigurationName Microsoft.Exchange -Credential $cred -ConnectionUri $msoExchangeURL -Authentication kerberos -SessionOption $so -Verbose
    Import-PSSession $ExchangeSession -AllowClobber

    # 遍历所有新建用户的UPN集合，批量启用远程邮箱
    $newUserUPNs = @("user1@domain.com", "user2@domain.com") # 替换为实际的新建用户UPN列表
    foreach ($UPN in $newUserUPNs) {
        Enable-RemoteMailbox -Identity $UPN
    }
}
catch {
    Write-Error "处理过程出错: $_"
}
finally {
    # 确保会话被关闭
    if ($ExchangeSession) {
        Remove-PSSession $ExchangeSession
    }
}

2. 添加错误重试机制 #

如果必须保持并行触发，在脚本中添加会话创建失败的重试逻辑，避免因瞬时会话占满导致的失败。

示例修改：

$maxRetries = 3
$retryDelaySeconds = 10
$ExchangeSession = $null

for ($i=1; $i -le $maxRetries; $i++) {
    try {
        $so = New-PSSessionOption -SkipCNCheck
        $ExchangeSession = New-PSSession -ConfigurationName Microsoft.Exchange -Credential $cred -ConnectionUri $msoExchangeURL -Authentication kerberos -SessionOption $so -Verbose
        if ($ExchangeSession) { break }
    }
    catch {
        Write-Warning "第$i次创建会话失败，$retryDelaySeconds秒后重试: $_"
        Start-Sleep -Seconds $retryDelaySeconds
    }
}

if (-not $ExchangeSession) {
    Write-Error "多次重试后仍无法创建Exchange会话"
    exit 1
}

# 后续操作
Import-PSSession $ExchangeSession -AllowClobber
Enable-RemoteMailbox -Identity $UPN
Remove-PSSession $ExchangeSession

3. 限制并行触发数量 #

调整IAM工具的配置，将并行运行的脚本数量限制在Exchange会话限制以内（比如最多10个并行），避免同时发起过多会话请求。

4. 使用Exchange Online Management模块的现代连接方式 #

放弃传统的New-PSSession，改用官方推荐的Connect-ExchangeOnline（需先安装Exchange Online Management模块），它的会话管理更高效，能自动处理会话复用，降低并发问题。

示例：

# 首次运行需安装模块
# Install-Module -Name ExchangeOnlineManagement -Force -AllowClobber

Connect-ExchangeOnline -Credential $cred -ShowBanner:$false
Enable-RemoteMailbox -Identity $UPN
Disconnect-ExchangeOnline -Confirm:$false

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