PowerShell中ConvertTo-HTML导出特殊字符的解决方案咨询

这个坑我之前踩过！ConvertTo-HTML默认会把像<、>、&这类HTML特殊字符当成标签语法处理，导致导出后要么显示异常，要么直接破坏HTML结构。不用事后手动编辑HTML的话，有几个靠谱的前置处理方案：

1. 用.NET类提前编码特殊字符 #

最稳妥的方式是在把数据传给ConvertTo-HTML之前，先用.NET的HTML编码工具把特殊字符转成HTML实体（比如<转成<）。这里分两种环境情况：

针对Windows PowerShell（桌面版） #

使用[System.Web.HttpUtility]::HtmlEncode：

# 示例哈希表（模拟从SQL提取的数据）
$sqlData = @{
    TableName = "UserInfo"
    Query = "SELECT * FROM Users WHERE Id < 100"
    Status = "Completed & Ready"
}

# 遍历哈希表，对每个值进行HTML编码
$encodedData = $sqlData.GetEnumerator() | ForEach-Object {
    [PSCustomObject]@{
        Field = $_.Key
        Content = [System.Web.HttpUtility]::HtmlEncode($_.Value)
    }
}

# 生成HTML并保存
$encodedData | ConvertTo-HTML -Property Field, Content -Title "SQL Data Export" | Out-File "SQL_Report.html"

针对PowerShell Core（跨平台版） #

因为Core版本移除了System.Web程序集，改用[System.Net.WebUtility]::HtmlEncode：

$encodedData = $sqlData.GetEnumerator() | ForEach-Object {
    [PSCustomObject]@{
        Field = $_.Key
        Content = [System.Net.WebUtility]::HtmlEncode($_.Value)
    }
}

2. 用计算属性直接在管道中处理 #

如果不想单独创建编码后的对象，可以在Select-Object里用计算属性一步完成编码，代码更简洁：

$sqlData.GetEnumerator() | 
    Select-Object @{Name='Field'; Expression={$_.Key}},
                  @{Name='Content'; Expression={[System.Net.WebUtility]::HtmlEncode($_.Value)}} |
    ConvertTo-HTML -Title "SQL Data Report" |
    Out-File "SQL_Report.html"

为什么这个方法有效？ #

HTML里的特殊字符必须转成对应的实体才能被浏览器正确显示为普通文本，而.NET的这两个编码方法会自动处理所有需要转义的字符（包括<、>、&、"、'等），比手动替换要全面得多，完全不用导出后再修改HTML文件。

如果你是直接从SQL Server查询数据，也可以考虑在SQL语句里做编码，但需要手动替换所有特殊字符，不如PowerShell里用.NET方法高效可靠。

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