周五乐趣：50 种 PowerShell HTML 报告

我一直在寻找为 HTML 报告添加视觉强化的方法。由于跟踪磁盘空间是 IT 专业人员的一项常见任务，因此我认为最好能够直观地表示磁盘利用率。因此，我创建了一个简短的概念验证脚本，用于生成如下 HTML 报告：

你怎么认为？我是这样做的。

#requires -version 3.0

<#
proof of concept using an HTML gradient.
#>

[cmdletbinding()]
Param(
[string]$Computername=$env:computername,
[string]$ReportTitle="Drive Utilization Report",
[string]$Path="$env:temp\utilization.htm"
)

#define HTML header with style elements
$head = @'
<style>
body { background-color:#FFFFFF;
       font-family:Calibri;
       font-size:12pt; }
td, th { border:0px solid black; 
         border-collapse:collapse; }
th { color:white;
     background-color:black; }
table, tr, td, th { padding: 2px; margin: 0px }
tr:nth-child(odd) {background-color: lightgray}
table {
width:95%;
margin-left:10px; 
margin-bottom:20px;
}
caption 
{
background-color:#FFFF66;
text-align:left;
font-weight:bold;
font-size:14pt;
}
</style>
'@

 <#
 Define a here string for coloring percentage cells.
 The starting and ending percents will need to provided
 using the -f operator.
 #>
$gradient=@"
filter:progid:DXImageTransform.Microsoft.Gradient(GradientType=0, 
StartColorStr=#0A802D, EndColorStr=#FF0011)
background-color: #376C46;
background-image: -mso-linear-gradient(left, #0A802D {0}%, #FF0011 {1}%);
background-image: -ms-linear-gradient(left, #0A802D {0}%, #FF0011 {1}%);
background-image: -moz-linear-gradient(left, #0A802D {0}%, #FF0011 {1}%);
background-image: -o-linear-gradient(left, #0A802D {0}%, #FF0011 {1}%);
background-image: -webkit-linear-gradient(left, #0A802D {0}%, #FF0011 {1}%);
background-image: linear-gradient(left, #0A802D {0}%, #FF0011 {1}%);
"@

#define an array to hold HTML fragments
$fragments=@()

#get the data for the report
$data = Get-CimInstance Win32_logicaldisk -filter "drivetype=3" -ComputerName $computername

#Create a custom object for each drive
$drives = foreach ($item in $data) {
    $prophash = [ordered]@{
    Drive = $item.DeviceID
    Volume = $item.VolumeName
    SizeGB = $item.size/1GB -as [int]
    FreeGB = "{0:N4}" -f ($item.Freespace/1GB)
    PercentFree = [math]::Round(($item.Freespace/$item.size) * 100,2)
    }
    New-Object PSObject -Property $prophash
} #foreach item

#convert drive objects to HTML but as an XML document
[xml]$html = $drives | ConvertTo-Html -Fragment

#add the computer name as the table caption
$caption= $html.CreateElement("caption")                                                                     
$html.table.AppendChild($caption) | Out-Null                                                                            
$html.table.caption= $data[0].SystemName

#go through rows again and add gradient
for ($i=1;$i -le $html.table.tr.count-1;$i++) {
  $class = $html.CreateAttribute("style")
  [int]$start = $html.table.tr[$i].td[-1]
  #create the gradient using starting and ending values
  #based on %free
  $class.value = $Gradient -f $start,(100-$start)
  $html.table.tr[$i].ChildNodes[4].Attributes.Append($class) | Out-Null
} #for

#add the html to the fragments
$fragments+= $html.InnerXml

#include a footer
$fragments+="<I>Report run $(Get-Date)</I>"

#create the final report
ConvertTo-HTML -head $head -title $reportTitle -PreContent "<h1>Drive Utilization</h1>" -PostContent $fragments |
Out-File -FilePath $path -Encoding ascii

这里的关键元素是添加渐变。在脚本中，您可以看到我在这里为渐变定义了一个字符串。该字符串包含支持几乎所有浏览器的代码，这就是您看到所有背景图像行的原因。这里的字符串还包含占位符，{0} 和 {1} 分别表示开始和结束百分比。我稍后会解释它是如何工作的。

使用 Get-CIMInstance，脚本获取固定逻辑磁盘。现在，我不是简单地创建 HTML 片段，而是将片段创建为 XML 文档。这允许我使用计算机名称向表格添加标题。然后我迭代表节点，跳过第一行，即表头。我创建了一个名为 Style 的属性。

for ($i=1;$i -le $html.table.tr.count-1;$i++) {
  $class = $html.CreateAttribute("style")
...

接下来，我获取最后一个 单元格的值，即 PercentFree 值。这就是我使用有序哈希表的原因之一，这样我就可以保证最后一个单元格始终是 PercentFree 属性。我获取该值并确保它是一个整数。

[int]$start = $html.table.tr[$i].td[-1]

我可以使用这个值并使用 -f 运算符将其插入到我的渐变字符串中。

$class.value = $Gradient -f $start,(100-$start)

我将样式属性附加到每个节点。这允许我为每个驱动器设置不同的值。

$html.table.tr[$i].ChildNodes[4].Attributes.Append($class) | Out-Null

浏览完表行后，剩下的就是将修改后的 HTML（即 InnerXML 属性）添加到我的片段数组中并创建最终报告。

渐变不是绝对的，但它可以让您粗略地直观地了解每个驱动器上有多少可用空间。顺便说一句，如果您想让报告的背景变得生动活泼，您还可以在样式表的正文元素中使用渐变。

我在代码中添加了大量注释，希望对您有所帮助。如果没有，请发表评论。享受！