PowerShell Send-MailMessage邮件主题正文颜色设置失效问题

你遇到的问题来自两个认知误区和代码错误：

• 所有符合RFC规范的邮件主题（Subject）都是纯文本字段，没有任何主流邮件客户端支持在主题中渲染HTML/CSS颜色样式，你写的带style的p标签会被直接当普通文本展示，完全不会生效。
• 你的报错场景代码存在字符串拼接语法错误，且调用Send-MailMessage时没有开启HTML正文开关，所以正文颜色也不会正常渲染。

主题区分方案 #

因为发件人无法控制邮件主题的显示颜色，通用的替代方案是加明确的状态前缀做区分：

• 执行出错时主题格式：【执行异常】你的脚本任务名
• 执行成功时主题格式：【执行成功】你的脚本任务名
  如果是企业内部统一用Outlook的场景，可以在客户端配置收信规则，给带指定前缀的邮件自动标记主题颜色，这个配置是收件人侧生效的，发件人无法通过邮件内容强制控制。

正文颜色正确实现 #

要让正文颜色生效，必须满足两个条件：一是正文内容是合法的HTML字符串，二是调用Send-MailMessage时加上-BodyAsHtml开关，告诉邮件客户端按HTML渲染内容。

报错场景参考代码 #

# 先做异常判空，避免没有错误时取InnerException抛空引用错误
if ($error.Count -gt 0) {
    $errorDetail = if ($error[0].Exception.InnerException) {
        $error[0].Exception.InnerException.ToString()
    } else {
        $error[0].Exception.Message
    }
    $mailSubject = "【执行异常】XX脚本运行出错"
    # 红色样式正文
    $mailBody = @"
<p style="color: #dc2626; font-size: 14px; line-height: 1.5;">
脚本运行过程中触发异常，错误详情如下：<br><br>
$errorDetail
</p>
"@

    # 发信，务必加-BodyAsHtml参数
    Send-MailMessage `
        -From "ops-alert@yourcompany.com" `
        -To "admin@yourcompany.com" `
        -SmtpServer "smtp.yourcompany.com" `
        -Subject $mailSubject `
        -Body $mailBody `
        -BodyAsHtml
}

成功场景参考代码 #

else {
    $mailSubject = "【执行成功】XX脚本运行完成"
    # 蓝色样式正文
    $mailBody = @"
<p style="color: #2563eb; font-size: 14px; line-height: 1.5;">
脚本已顺利执行完成，运行过程无异常抛出。
</p>
"@

    Send-MailMessage `
        -From "ops-alert@yourcompany.com" `
        -To "admin@yourcompany.com" `
        -SmtpServer "smtp.yourcompany.com" `
        -Subject $mailSubject `
        -Body $mailBody `
        -BodyAsHtml
}

1. 字符串拼接语法错误：你写的"<p style=""color:red;"">" New-Object System.Exception (...) 属于断开的语句，PowerShell不会自动把New-Object生成的异常对象拼接到字符串里，直接运行会报语法错误。
2. 缺少-BodyAsHtml参数：就算HTML字符串写的完全正确，不加这个参数的话，邮件客户端会把所有HTML标签当普通文本展示，不会渲染颜色、换行等样式。
3. 给主题套HTML标签完全无效：主题是纯文本字段，不支持任何样式定义，写再多HTML标签也只会被当成普通字符显示。

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