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" />
此命令创建 cmdlet 返回的服务对象的 Get-Service
HTML 页。 命令使用 CssUri 参数指定 HTML 页面的级联样式表。
CssUri 参数将附加<link rel="stylesheet" type="text/css" href="test.css">
标记添加到生成的 HTML。 标记中的 HREF 属性包含该样式表的名称。
示例 6:创建网页以显示服务对象
Get-Service | ConvertTo-Html -As LIST | Out-File services.htm
此命令创建 cmdlet 返回的服务对象的 Get-Service
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
命令使用 Property 参数仅选择事件的 ID、 Level 和 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
的计算机上的服务。 它使用 的 Title、 Body、 PreContent 和 PostContent 参数 ConvertTo-Html
来自定义输出。
命令的第一部分使用 Get-Service
cmdlet 获取以 开头 A
的计算机上的服务。 命令使用管道运算符 (|
) 将结果发送到 ConvertTo-Html
cmdlet。 该命令还使用 Out-File
cmdlet 将输出发送到 Services.htm
文件。
分号 (;
) 结束第一个命令并启动第二个命令,该命令使用 Invoke-Item
cmdlet 在默认浏览器中打开 Services.htm
文件。
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
确定将对象设置为表格格式还是列表格式。 有效值为 Table 和 List。 默认值为 Table。
Table 值生成类似于 PowerShell 表格式的 HTML 表。 标题行显示属性名称。 表格的每一行表示一个对象,并显示该对象的每个属性值。
List 值为每个对象生成一个两列 HTML 表,该表类似于 PowerShell 列表格式。 第一列显示属性名称。 第二列显示属性值。
Type:String
Accepted values:Table, List
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Body
指定要在左 <BODY>
标记之后添加的文本。 默认情况下,该位置没有文本。
Type:String[]
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Charset
指定要添加到开始 <charset>
标记的文本。 默认情况下,该位置没有文本。
此参数是在 PowerShell 6.0 中引入的。
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CssUri
指定级联样式表 (CSS) 的统一资源标识符 (URI),该 URI 适用于 HTML 文件。 输出中的样式表链接中包含该 URI。
Type:Uri
Aliases:cu, uri
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Fragment
仅生成一个 HTML 表。 <HTML>
省略 、<HEAD>
、 <TITLE>
和 <BODY>
标记。
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Head
指定 <HEAD>
标记的内容。 默认为 <title\>HTML TABLE</title>
。 如果使用 Head 参数,则忽略 Title 参数。
Type:String[]
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject
指定要用 HTML 表示的对象。 输入一个包含对象的变量,或键入可获取对象的命令或表达式。
如果使用此参数提交多个对象(例如计算机上的所有服务), ConvertTo-Html
则会创建一个表,用于显示集合或对象数组的属性。 若要创建单个对象的表,请使用管道运算符通过管道将对象传递给 ConvertTo-Html
。
Type:PSObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Meta
指定要添加到开始 <meta>
标记的文本。 默认情况下,该位置没有文本。
此参数是在 PowerShell 6.0 中引入的。
Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PostContent
指定要在右 </TABLE>
标记之后添加的文本。 默认情况下,该位置没有文本。
Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PreContent
指定要在左 <TABLE>
标记之前添加的文本。 默认情况下,该位置没有文本。
Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Property
在 HTML 中包括所指定的对象属性。 Property 参数的值可以是新的计算属性。 计算属性可以是脚本块或哈希表。 有效的键值对包括:
Name
(或标签) - <string>
(添加到 PowerShell 6.x)
Expression
- <string>
或 <script block>
FormatString
- <string>
Width
- <int32>
- 必须大于 0
Alignment
- 值可以是 Left
、 Center
、 或 Right
有关详细信息,请参阅 about_Calculated_Properties。
Type:Object[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Title
指定 HTML 文件的标题,即在 <TITLE>
标记之间显示的文本。
Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Transitional
DOCTYPE
将 更改为 XHTML 过渡 DTD,默认值DOCTYPE
为 XHTML Strict DTD。
此参数是在 PowerShell 6.0 中引入的。
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
PSObject
你可以通过管道将任何对象传递给此 cmdlet。
String
此 cmdlet 返回一个由 HTML 字符串构成的数组,这些字符串表示转换后的对象。
若要使用此 cmdlet,请通过管道将一个或多个对象传递给 cmdlet,或使用 InputObject 参数指定对象。 当输入由多个对象组成时,这两种方法的输出将完全不同。
通过管道将多个对象传递给 cmdlet 时,PowerShell 一次将一个对象发送到 cmdlet。 因此, ConvertTo-Html
会创建一个显示各个对象的表。 例如,如果将计算机上的进程通过管道传递给 ConvertTo-Html
,则生成的表将显示所有进程。
使用 InputObject 参数提交多个对象时, ConvertTo-Html
将作为集合或数组接收这些对象。 因此,它会创建一个表格,该表格将显示数组及其属性,而非数组中的项。 例如,如果使用 InputObject 将计算机上的进程提交到 ConvertTo-Html
,则生成的表将显示对象数组及其属性。
为了遵守 XHTML 严格 DTD, DOCTYPE
将相应地修改 标记:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"\>