ConvertTo-Html (Microsoft.PowerShell.Utility) - PowerShell

示例 1：创建网页以显示日期

ConvertTo-Html -InputObject (Get-Date)

此命令将创建一个 HTML 页面，用于显示当前日期的属性。它使用 InputObject 参数将 Get-Date 命令的结果提交到 ConvertTo-Html cmdlet。

示例 2：创建用于显示 PowerShell 别名的网页

Get-Alias | ConvertTo-Html | Out-File aliases.htm
Invoke-Item aliases.htm

此命令将创建一个 HTML 页面，其中列出了当前控制台中的 PowerShell 别名。

该命令使用 Get-Alias cmdlet 获取别名。它使用管道运算符（ | ）将别名发送到创建 HTML 页面的 ConvertTo-Html cmdlet。该命令还使用 Out-File cmdlet 将 HTML 代码发送到 aliases.htm 文件。

示例 3：创建用于显示 PowerShell 事件的网页

Get-EventLog -LogName "Windows PowerShell" | ConvertTo-Html | Out-File pslog.htm

此命令将创建一个名为 pslog.htm 的 HTML 页，用于在本地计算机上的 Windows PowerShell 事件日志中显示事件。

它使用 Get-EventLog cmdlet 获取 Windows PowerShell 日志中的事件，然后使用管道运算符（ | ）将事件发送到 ConvertTo-Html cmdlet。该命令还使用 Out-File cmdlet 将 HTML 代码发送到 pslog.htm 文件。

该命令还使用 Out-File cmdlet 将 HTML 代码发送到 pslog.htm 文件。

示例 4：创建用于显示进程的网页

Get-Process |
  ConvertTo-Html -Property Name, Path, Company -Title "Process Information" |
    Out-File proc.htm
Invoke-Item proc.htm

这些命令创建并打开一个 HTML 页面，其中列出了本地计算机上的进程的名称、路径和公司。

第一个命令使用 Get-Process cmdlet 获取表示计算机上运行的进程的对象。该命令使用管道运算符（ | ）将进程对象发送到 ConvertTo-Html cmdlet。

该命令使用 Property 参数选择要包含在表中的进程对象的三个属性。该命令使用 Title 参数为 HTML 页面指定标题。该命令还使用 Out-File cmdlet 将生成的 HTML 发送到名为 Proc.htm 的文件。

第二个命令使用 Invoke-Item cmdlet 在默认浏览器中打开 Proc.htm 。

示例 5：创建用于显示服务对象的网页

Get-Service | ConvertTo-Html -CssUri "test.css"
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
		此命令创建 Get-Service cmdlet 返回的服务对象的 HTML 页。 该命令使用 CssUri 参数为 HTML 页面指定级联样式表。
              CssUri 参数向生成的 HTML 添加额外的 <link rel="stylesheet" type="text/css" href="test.css"> 标记。 标记中的 HREF 属性包含样式表的名称。
	
示例 6：创建用于显示服务对象的网页
		Get-Service | ConvertTo-Html -As List | Out-File services.htm
		此命令创建 Get-Service cmdlet 返回的服务对象的 HTML 页。 该命令使用 As 参数来指定列表格式。 cmdlet Out-File 将生成的 HTML 发送到 Services.htm 文件。
	示例 7：为当前日期创建 Web 表
		Get-Date | ConvertTo-Html -Fragment
<table>
<colgroup>...</colgroup>
<tr><th>DisplayHint</th><th>DateTime</th><th>Date</th><th>Day</th><th>DayOfWeek</th><th>DayOfYear</th><th>Hour</th>
<th>Kind</th><th>Millisecond</th><th>Minute</th><th>Month</th><th>Second</th><th>Ticks</th><th>TimeOfDay</th><th>Year</th></tr>
<tr><td>DateTime</td><td>Monday, May 05, 2008 10:40:04 AM</td><td>5/5/2008 12:00:00 AM</td><td>5</td><td>Monday</td>
<td>126</td><td>10</td><td>Local</td><td>123</td><td>40</td><td>5</td><td>4</td><td>633455808041237213</td><td>10:40:04.12
37213</td><td>2008</td></tr>
</table>
		此命令使用 ConvertTo-Html 生成当前日期的 HTML 表。 该命令使用 Get-Date cmdlet 获取当前日期。 它使用管道运算符（|）将结果发送到 ConvertTo-Html cmdlet。
              ConvertTo-Html 命令包括 Fragment 参数，该参数将输出限制为 HTML 表。 因此，省略 HTML 页面的其他元素，例如 <HEAD> 和 <BODY> 标记。
	
示例 8：创建网页以显示 PowerShell 事件
		Get-EventLog -Log "Windows PowerShell" | ConvertTo-Html -Property ID, Level, Task
		此命令使用 Get-EventLog cmdlet 从 Windows PowerShell 事件日志中获取事件。
它使用管道运算符（|）将事件发送到 ConvertTo-Html cmdlet，该 cmdlet 将事件转换为 HTML 格式。
              ConvertTo-Html 命令使用 属性 参数仅选择事件的 Id、级别和 Task 属性。
	
示例 9：创建用于显示指定服务的网页
		$htmlParams = @{
  Title = "Windows Services: Server01"
  Body = Get-Date
  PreContent = "<P>Generated by Corporate IT</P>"
  PostContent = "For details, contact Corporate IT."
Get-Service A* |
  ConvertTo-Html @htmlParams |
    Out-File Services.htm
Invoke-Item Services.htm
		此命令创建并打开一个网页，该网页显示以 A开头的计算机上的服务。 它使用 游戏、正文、PreContent和 ConvertTo-Html 参数来自定义输出。

命令的第一部分使用 Get-Service cmdlet 获取以 A开头的计算机上的服务。 该命令使用管道运算符（|）将结果发送到 ConvertTo-Html cmdlet。 该命令还使用 Out-File cmdlet 将输出发送到 Services.htm 文件。
分号（;）结束第一个命令并启动第二个命令，该命令使用 Invoke-Item cmdlet 在默认浏览器中打开 Services.htm 文件。
	示例 10：设置 HTML 的元属性和字符集
		Get-Service | ConvertTo-Html -Meta @{
  refresh=10
  author="Author's Name"
  keywords="PowerShell, HTML, ConvertTo-Html"
} -Charset "UTF-8"
		此命令为包含刷新、作者和关键字的元标记的网页创建 HTML。
页面的字符集设置为 UTF-8
	示例 11：将 HTML 设置为 XHTML 过渡 DTD
		Get-Service | ConvertTo-Html -Transitional
		此命令将返回的 HTML 的 DOCTYPE 设置为 XHTML 过渡 DTD
	确定对象的格式是表还是列表。 有效值 表 和 列表。 默认值为表 。

              表 值生成类似于 PowerShell 表格式的 HTML 表。 标题行显示属性名称。 每个表行表示一个对象，并显示每个属性的对象的值。
              List 值为每个类似于 PowerShell 列表格式的对象生成一个双列 HTML 表。 第一列显示属性名称。 第二列显示属性值。

			类型:String
			接受的值:Table, List
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Body
	指定要在打开 <BODY> 标记后添加的文本。 默认情况下，该位置没有文本。
			类型:String[]
			Position:3
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Charset
	指定要添加到开始 <charset> 标记的文本。 默认情况下，该位置没有文本。
此参数是在 PowerShell 6.0 中引入的。
			类型:String
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-CssUri
	指定应用于 HTML 文件的级联样式表（CSS）的统一资源标识符（URI）。 URI 包含在输出的样式表链接中。
			类型:Uri
			别名:cu, uri
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Fragment
	仅生成 HTML 表。 省略 <HTML>、<HEAD>、<TITLE>和 <BODY> 标记。
			类型:SwitchParameter
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Head
	指定 <HEAD> 标记的内容。 默认值为 <title\>HTML TABLE</title>。 如果使用 Head 参数，则忽略 Title 参数。
			类型:String[]
			Position:1
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-InputObject
	指定要在 HTML 中表示的对象。 输入包含对象或键入获取对象的命令或表达式的变量。
如果使用此参数提交多个对象（例如计算机上的所有服务），ConvertTo-Html 将创建一个表来显示集合或对象数组的属性。 若要创建单个对象的表，请使用管道运算符通过管道将对象传递给 ConvertTo-Html。
			类型:PSObject
			Position:Named
			默认值:None
		必需:False
		接受管道输入:True
		接受通配符:False
-Meta
	指定要添加到开始 <meta> 标记的文本。 默认情况下，该位置没有文本。
此参数是在 PowerShell 6.0 中引入的。
			类型:Hashtable
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-PostContent
	指定要在结束 </TABLE> 标记后添加的文本。 默认情况下，该位置没有文本。
			类型:String[]
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-PreContent
	指定要在开始 <TABLE> 标记之前添加的文本。 默认情况下，该位置没有文本。
			类型:String[]
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Property
	在 HTML 中包含对象的指定属性。 
              属性 参数的值可以是新的计算属性。 计算属性可以是脚本块或哈希表。 有效的键值对包括：
              Name （或标签） - <string>（在 PowerShell 6.x 中添加）
              Expression
              <string> 或 <script block>
FormatString - <string>
              Width
              <int32> - 必须大于 0
              Alignment - 值可以是 Left、Center或 Right
有关详细信息，请参阅 about_Calculated_Properties。
			类型:Object[]
			Position:0
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Title
	指定 HTML 文件的标题，即 <TITLE> 标记之间的文本。
			类型:String
			Position:2
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
-Transitional
	将 DOCTYPE 更改为 XHTML 过渡 DTD，默认 DOCTYPEXHTML 严格 DTD。
此参数是在 PowerShell 6.0 中引入的。
			类型:SwitchParameter
			Position:Named
			默认值:None
		必需:False
		接受管道输入:False
		接受通配符:False
				PSObject
			可以通过管道将任何对象传递给此 cmdlet。
				String
			此 cmdlet 返回表示转换后对象的 HTML 字符串数组。
		若要使用此 cmdlet，请通过管道将一个或多个对象传递给该 cmdlet，或使用 InputObject 参数指定对象。 当输入包含多个对象时，这两种方法的输出大相径庭。
将多个对象通过管道传递给 cmdlet 时，PowerShell 一次将对象发送到该 cmdlet。 因此，ConvertTo-Html 创建一个显示单个对象的表。 例如，如果通过管道将计算机上的进程传递给 ConvertTo-Html，生成的表将显示所有进程。
使用 InputObject 参数提交多个对象时，ConvertTo-Html 将这些对象作为集合或数组接收。 因此，它会创建一个表来显示数组及其属性，而不是数组中的项。 例如，如果使用 InputObject 将计算机上的进程提交到 ConvertTo-Html，则生成的表将显示对象数组及其属性。
为了符合 XHTML Strict DTD，将相应地修改 DOCTYPE 标记：
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"   "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"\>