PowerShell哈希表表达式处理ProxyAddresses字段问题求助

直接上修正后的完整代码，核心是处理多值属性ProxyAddresses的序列化问题：

# 加载并连接所需服务模块
Import-Module ExchangeOnlineManagement
Connect-ExchangeOnline
Connect-MsolService

# 获取所有目标邮箱（可按需添加筛选条件，比如 -RecipientTypeDetails UserMailbox）
$mailboxes = Get-Mailbox -ResultSize Unlimited

# 初始化结果容器
$reportData = @()

foreach ($mbx in $mailboxes) {
    # 批量预取的方式效率更高，这里先保留循环内查询（小批量场景可用）
    $mbxStats = Get-MailboxStatistics -Identity $mbx.UserPrincipalName -ErrorAction SilentlyContinue
    $msolAccount = Get-MsolUser -UserPrincipalName $mbx.UserPrincipalName -ErrorAction SilentlyContinue

    # 关键处理：把多值的ProxyAddresses转成CSV兼容的单字符串（用分号分隔避免和CSV逗号冲突）
    # 如果只需要SMTP地址，可改为：$proxyList = $mbx.ProxyAddresses | Where-Object { $_ -cmatch '^SMTP:' } -join ';'
    $proxyList = $mbx.ProxyAddresses -join ';'

    # 整合多模块字段到自定义对象
    $reportEntry = [PSCustomObject]@{
        DisplayName               = $mbx.DisplayName
        UserPrincipalName         = $mbx.UserPrincipalName
        Alias                     = $mbx.Alias
        # 处理后的ProxyAddresses字段
        ProxyAddresses            = $proxyList
        # 邮箱统计维度字段
        MailboxSizeMB             = if ($mbxStats) { $mbxStats.TotalItemSize.Value.ToMB() } else $null
        MailItemCount             = if ($mbxStats) { $mbxStats.ItemCount } else $null
        LastLogonTime             = if ($mbxStats) { $mbxStats.LastLogonTime } else $null
        # Msol用户维度字段
        IsLicensed                = if ($msolAccount) { $msolAccount.IsLicensed } else $null
        Department                = if ($msolAccount) { $msolAccount.Department } else $null
        UsageLocation             = if ($msolAccount) { $msolAccount.UsageLocation } else $null
    }

    $reportData += $reportEntry
}

# 导出到CSV（指定UTF8编码避免乱码）
$reportData | Export-Csv -Path "C:\Temp\FullMailboxReport.csv" -NoTypeInformation -Encoding UTF8

关键说明 #

1. ProxyAddresses处理逻辑：这个属性是多值集合，直接写入CSV会被序列化为System.Collections.ArrayList这类无效字符串。用-join ';'将所有地址拼接成单个字符串，既保留完整信息，又符合CSV单字段格式要求。
2. 性能优化建议：如果邮箱数量超过100个，建议先批量获取所有Get-MailboxStatistics和Get-MsolUser数据，再通过UserPrincipalName匹配，减少远程服务调用次数：

   # 提前批量拉取所有数据
   $allStats = Get-MailboxStatistics -ResultSize Unlimited
   $allMsolUsers = Get-MsolUser -All
   
   # 循环内直接匹配
   $mbxStats = $allStats | Where-Object { $_.UserPrincipalName -eq $mbx.UserPrincipalName }
   $msolAccount = $allMsolUsers | Where-Object { $_.UserPrincipalName -eq $mbx.UserPrincipalName }
   

3. 权限要求：确保账号同时拥有Exchange Online的邮箱查询权限，以及Azure AD的用户读取权限，否则部分字段会返回空值。

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