本文详解如何在 PowerShell 中通过 Send-MailMessage 将本地截图（如 BMP、PNG）真正嵌入邮件正文显示，解决因直接引用本地路径导致的“Body 为空”错误，并提供 CID 内嵌、Base64 嵌入和 URL 引用三种可靠方案。
本文详解如何在 powershell 中通过 `send-mailmessage` 将本地截图（如 bmp、png）真正嵌入邮件正文显示，解决因直接引用本地路径导致的“body 为空”错误，并提供 cid 内嵌、base64 嵌入和 url 引用三种可靠方案。
在 PowerShell 中使用 Send-MailMessage 发送带图片的 HTML 邮件时，不能直接在 <img src="local_path.bmp"> 中引用本地文件路径——邮件客户端无法访问发件人机器上的本地磁盘，因此该 HTML 会渲染失败，甚至导致 Body 参数被判定为无效（如报错 Cannot validate argument on parameter 'Body'. The argument is null or empty），尤其当 $body 构建逻辑中未正确初始化或循环未执行时更易触发。
✅ 正确做法是：将图片作为附件内嵌（inline attachment）并用 cid: 引用。这是最兼容、最稳妥的企业级方案，支持 Outlook、Thunderbird、Apple Mail 等主流客户端。
✅ 推荐方案：CID 内嵌（推荐用于内部/可控环境）
# 1. 准备截图文件（建议转为 PNG/JPG 以减小体积）
$screenshots = Get-ChildItem "C:\Test\Screenshots" -Filter "*.png" -ErrorAction SilentlyContinue
# 2. 构建 HTML body，为每张图生成唯一 CID（如 screenshot01.png → cid:screenshot01.png）
$bodyParts = @()
$attachments = @()
foreach ($screenshot in $screenshots) {
$cid = "cid:$($screenshot.Name)" # 注意：cid 值必须与 Add-Attachment 的 ContentID 严格一致
$bodyParts += "<p><img src='$cid' alt='$($screenshot.Name)' width='800'/></p>"
$attachments += @{
Path = $screenshot.FullName
ContentId = $screenshot.Name # Send-MailMessage 要求 ContentID = 文件名（不含路径）
IsInline = $true
}
}
$body = "<html><body><h2>自动化测试截图报告</h2>$($bodyParts -join "`n")</body></html>"
# 3. 发送邮件（PowerShell 5.1+ 支持 -Attachments 参数传哈希表数组）
$params = @{
To = "recipient@company.com"
From = "sender@company.com"
Subject = "【截图报告】系统状态快照"
Body = $body
BodyAsHtml = $true
SmtpServer = "smtp.company.com"
Port = 587
UseSsl = $true
Credential = (Get-Credential)
Attachments = $attachments.Values # 实际传递附件对象数组（需转换）
}
# ⚠️ 注意：Send-MailMessage 不原生支持哈希表附件 —— 需手动构造 [System.Net.Mail.Attachment] 对象
$attachmentObjects = @()
foreach ($att in $attachments.Values) {
$a = New-Object System.Net.Mail.Attachment($att.Path)
$a.ContentId = $att.ContentId
$a.ContentType = [System.Net.Mime.MediaTypeNames+Image]::Png # 按实际格式设（Png/Jpeg/Bmp）
$a.IsInline = $true
$attachmentObjects += $a
}
try {
$mailMsg = New-Object System.Net.Mail.MailMessage
$mailMsg.From = $params.From
$mailMsg.To.Add($params.To)
$mailMsg.Subject = $params.Subject
$mailMsg.Body = $params.Body
$mailMsg.IsBodyHtml = $true
foreach ($a in $attachmentObjects) { $mailMsg.Attachments.Add($a) }
$smtp = New-Object System.Net.Mail.SmtpClient($params.SmtpServer, $params.Port)
$smtp.EnableSsl = $params.UseSsl
$smtp.Credentials = $params.Credential
$smtp.Send($mailMsg)
Write-Host "✅ 邮件发送成功，共嵌入 $($attachments.Count) 张截图。" -ForegroundColor Green
}
catch {
Write-Error "❌ 邮件发送失败：$($_.Exception.Message)"
}
finally {
$mailMsg?.Dispose()
$attachmentObjects | ForEach-Object { $_.Dispose() }
}⚠️ 替代方案对比（按适用性排序）
| 方案 | 实现方式 | 兼容性 | 风险提示 |
|---|---|---|---|
| CID 内嵌（首选） | 图片作为 IsInline=$true 附件 + src="cid:xxx" | ★★★★★（Outlook/Exchange 完美支持） | 需手动构造 MailMessage（Send-MailMessage 不支持 inline 附件） |
| Base64 内联（轻量场景） | 将图片读为字节 → Base64 编码 → <img src="data:image/png;base64,..."> | ★★☆☆☆（Gmail/Outlook Web 支持，但桌面版 Outlook 2016+ 有长度限制） | BMP 文件体积大，Base64 膨胀 33%，易超邮件大小限制；部分客户端屏蔽 data: URI |
| 公网/内网 URL（仅限可信环境） | 将图片上传至 Web 服务器（如 IIS/SharePoint/内部 NAS），用 <img src="https://intranet/images/1.png"> | ★★★☆☆（依赖网络可达性） | 企业邮箱常默认阻止外部图片加载（防追踪），需收件人手动启用；内网 URL 更安全 |
? 重要提示：
anything-to-html下载将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- .bmp 文件强烈建议转换为 .png 或 .jpg：BMP 无压缩，单图常达数 MB，极大增加邮件体积和失败率；
- 使用 Get-ChildItem 后务必加 -ErrorAction SilentlyContinue，避免空目录导致循环跳过；
- Send-MailMessage 已弃用（PowerShell 6+ 移除），生产环境请迁移到 Microsoft.PowerShell.Utility\Send-MailMessage（WinPS5.1）或改用 SMTP.NET / MailKit 库；
- 测试时优先用 Outlook 客户端验证，Web 邮箱（如 Gmail）对 inline 图片支持更宽松。
通过以上方法，你不仅能稳定嵌入多张截图，还能为后续扩展（如添加时间戳、标题、边框样式）预留清晰结构。记住：邮件不是网页，所有资源必须随信携带或通过可信服务交付。
立即学习“前端免费学习笔记（深入）”；
