优化1.8万邮箱PowerShell脚本：Get-EXOMailbox查询提速求助

1. 核心优化：批量拉取替代循环调用 #

循环逐个调用Get-EXOMailbox和Get-EXOMailboxStatistics是耗时的根源——每个API调用都要建立连接、等待响应，1.8万次调用的累积开销直接拉满时长。换成一次性批量拉取所有数据，再做本地关联处理：

批量获取邮箱基础信息 #

# 只拉取你需要的属性（按需调整，避免冗余数据）
$allMailboxes = Get-EXOMailbox -ResultSize Unlimited -Properties DisplayName, PrimarySmtpAddress, ArchiveStatus, ArchiveName

批量获取邮箱统计数据 #

$allMailboxStats = Get-EXOMailboxStatistics -ResultSize Unlimited -Properties TotalItemSize, ItemCount, ArchiveTotalItemSize, ArchiveItemCount

本地关联两个数据集 #

$combinedData = foreach ($mailbox in $allMailboxes) {
    # 通过邮箱GUID关联统计数据（比SMTP地址更可靠）
    $stats = $allMailboxStats | Where-Object { $_.MailboxGuid -eq $mailbox.ExchangeGuid }
    
    # 处理空值，避免导出报错
    [PSCustomObject]@{
        DisplayName          = $mailbox.DisplayName
        PrimarySmtpAddress   = $mailbox.PrimarySmtpAddress
        ArchiveStatus        = $mailbox.ArchiveStatus
        TotalItemSize        = if ($stats) { $stats.TotalItemSize.Value.ToMB() } else { $null }
        ItemCount            = $stats.ItemCount ?? 0
        ArchiveTotalItemSize = if ($stats -and $stats.ArchiveTotalItemSize) { $stats.ArchiveTotalItemSize.Value.ToMB() } else { $null }
        ArchiveItemCount     = $stats.ArchiveItemCount ?? 0
    }
}

# 导出结果
$combinedData | Export-Csv -Path "MailboxArchiveReport.csv" -NoTypeInformation -Encoding UTF8

2. 并行处理的正确打开方式（针对批量拉取仍有压力的场景） #

Start-Job启动开销极大，不适合大量小任务，换成PowerShell 7+的ForEach-Object -Parallel，同时解决你遇到的参数集和空值问题：

并行查询脚本示例 #

# 先获取所有邮箱的GUID列表（传递简单类型避免参数集冲突）
$mailboxGuids = (Get-EXOMailbox -ResultSize Unlimited).ExchangeGuid

# 控制并行度（Exchange有API速率限制，建议5-10，别太高）
$combinedData = $mailboxGuids | ForEach-Object -Parallel {
    # 并行块内单独导入模块，复用主会话的登录信息
    Import-Module ExchangeOnlineManagement
    Connect-ExchangeOnline -ConnectionUri $USING:connectionUri -AccessToken $USING:token -ShowBanner:$false

    # 用GUID作为Identity，避免参数集冲突
    $mailbox = Get-EXOMailbox -Identity $_ -Properties DisplayName, PrimarySmtpAddress, ArchiveStatus, ArchiveName
    $stats = Get-EXOMailboxStatistics -Identity $_ -Properties TotalItemSize, ItemCount, ArchiveTotalItemSize, ArchiveItemCount

    # 空值处理，防止导出错误
    [PSCustomObject]@{
        DisplayName          = $mailbox.DisplayName
        PrimarySmtpAddress   = $mailbox.PrimarySmtpAddress
        ArchiveStatus        = $mailbox.ArchiveStatus
        TotalItemSize        = $stats.TotalItemSize.Value.ToMB() ?? $null
        ItemCount            = $stats.ItemCount ?? 0
        ArchiveTotalItemSize = $stats.ArchiveTotalItemSize.Value.ToMB() ?? $null
        ArchiveItemCount     = $stats.ArchiveItemCount ?? 0
    }
} -ThrottleLimit 8

$combinedData | Export-Csv -Path "MailboxArchiveReport_Parallel.csv" -NoTypeInformation -Encoding UTF8

解决你遇到的两个问题 #

• 参数集错误：并行时只传递字符串/GUID这类简单类型，别传复杂对象；调用Get-EXOMailbox/Get-EXOMailboxStatistics时统一用-Identity参数，避免参数冲突。
• 空值导出错误：用??空值合并操作符给空属性设默认值（比如0或$null），提前判断$stats是否存在再访问其属性。

3. 额外优化细节 #

• 精简属性：只拉取你需要的字段，减少数据传输量和处理时间。
• 复用登录会话：并行任务里不要重复登录Exchange Online，用主会话的连接信息复用。
• 降低并行度：如果遇到429速率限制错误，把-ThrottleLimit调小，比如改成5。
• 升级PowerShell 7+：比5.x的并行性能好太多，还支持??这类简化空值处理的语法。

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