批量获取7万+共享邮箱统计数据及Get-Mailbox报错解决求助

报错原因 #

一次性通过Get-Mailbox -ResultSize Unlimited拉取7万+共享邮箱的全量属性时，会触发Exchange Online的服务器端限流机制，导致操作失败。虽然返回了部分计数，但结果并不完整（实际有7万+，但仅返回65000）。

获取共享邮箱总数的替代方案 #

方案1：使用更轻量的Get-Recipient命令 #

Get-Recipient返回的属性比Get-Mailbox少，服务器处理压力更小，不容易触发限流：

Get-Recipient -RecipientTypeDetails SharedMailbox -ResultSize Unlimited | Measure-Object

方案2：分页获取总数（更稳定） #

如果方案1仍报错，使用分页方式逐步累加计数，避免一次性请求过多数据：

$totalCount = 0
$skip = 0
$batchSize = 1000

do {
    # 使用Get-EXOMailbox（EXO V3模块命令，比旧Get-Mailbox更稳定）
    $currentBatch = Get-EXOMailbox -RecipientTypeDetails SharedMailbox -ResultSize $batchSize -Skip $skip
    $totalCount += $currentBatch.Count
    $skip += $batchSize
    # 增加短暂延迟，降低服务器压力
    Start-Sleep -Seconds 2
} while ($currentBatch.Count -eq $batchSize)

Write-Host "租户内共享邮箱总数：$totalCount"

分批检索统计数据的实现 #

获取总数后，通过分页获取邮箱列表，再分批执行统计操作，同时规避限流：

步骤1：分批获取所有共享邮箱的核心信息 #

$allSharedMailboxes = @()
$skip = 0
$batchSize = 1000

do {
    $currentBatch = Get-EXOMailbox -RecipientTypeDetails SharedMailbox -ResultSize $batchSize -Skip $skip -Properties PrimarySmtpAddress
    $allSharedMailboxes += $currentBatch
    $skip += $batchSize
    Start-Sleep -Seconds 2
} while ($currentBatch.Count -eq $batchSize)

步骤2：分批执行统计脚本 #

根据实际需求调整每批处理的数量（建议500-1000，避免限流），并添加延迟：

$statsBatchSize = 500
$outputPath = "C:\SharedMailboxStats\"

# 确保输出目录存在
if (-not (Test-Path $outputPath)) { New-Item -Path $outputPath -ItemType Directory | Out-Null }

for ($i = 0; $i -lt $allSharedMailboxes.Count; $i += $statsBatchSize) {
    $endIndex = [Math]::Min($i + $statsBatchSize - 1, $allSharedMailboxes.Count - 1)
    $currentStatsBatch = $allSharedMailboxes[$i..$endIndex]

    # 执行统计操作（示例：获取邮箱统计数据）
    $mailboxStats = Get-MailboxStatistics -Identity $currentStatsBatch.PrimarySmtpAddress

    # 导出到CSV文件
    $csvFileName = "SharedMailboxStats_Batch_$(([int]($i/$statsBatchSize)) + 1).csv"
    $mailboxStats | Export-Csv -Path (Join-Path $outputPath $csvFileName) -NoTypeInformation -Encoding UTF8

    # 添加延迟，避免触发限流
    Start-Sleep -Seconds 10
}

额外注意事项 #

• 确保安装最新版Exchange Online PowerShell模块（EXO V3），旧模块的稳定性和限流处理能力较差。
• 调整batchSize和延迟时间：如果仍出现限流错误，可减小每批数量、延长延迟时间。
• 优先使用Get-EXOMailbox而非旧的Get-Mailbox命令，EXO V3模块针对大规模操作做了优化。
• 可添加错误捕获逻辑，避免单批失败导致整个脚本中断：

  try {
      $mailboxStats = Get-MailboxStatistics -Identity $currentStatsBatch.PrimarySmtpAddress -ErrorAction Stop
  } catch {
      Write-Warning "处理第$(([int]($i/$statsBatchSize)) + 1)批时出错：$_"
      # 可记录错误日志或跳过该批
      continue
  }
  

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