使用 PowerShell 创建彩色 HTML 磁盘报告

我不知道是什么让我着迷，但有一天我遇到了一个旧脚本，它使用 PowerShell 创建一个 HTML 报告，显示一组计算机的驱动器利用率。使用从绿色到红色的颜色渐变来显示利用率，以提供视觉参考。当我查看代码时，我想到了要添加哪些有趣的内容，现在一两天后我有一些新东西要向您展示。

该功能可以使用存储模块中的命令（如 Get-Volume 和 Get-Disk）进行修改。但我决定坚持使用 Get-CimInstance 来查询传统的 Win32_* 类。我还想利用 Get-CimAssociatedInstance 来捕获其他信息。您可以在 Github 上找到作为要点的脚本文件。

:

用法非常简单。您指定一台或多台计算机即可。生成的 HTML 文件有一个默认值，但您可能需要指定自己的值。由于该函数会动态生成自定义 HTML，因此我还为您提供了提供前内容和后内容 HTML 材料的选项，就像使用 ConvertTo-HTML 一样。我还为您提供了一个选项来指定图形文件，该文件在报告顶部显示为徽标。图形文件将嵌入到 HTML 文件中。 CSS 还嵌入到 HTML 中，使整个文件完全独立。

$params = @{
Computername = 'bovine320','dom1','think51','srv1','win10'
Path = 'c:\work\r.html'
Precontent = "<H3>Company Confidential</H3>" 
PostContent = "This report is provided <i>as-is</i>. Use commands like <b>Get-Volume</b> to validate."
LogoPath = 'c:\scripts\db.png'
}
New-HTMLDiskReport @params

当您查看代码时，请注意我如何使用 Write-Progress 来让用户了解情况。我希望更多人使用它来代替 Write-Host。它使您的代码更加专业。让我给你看看结果。

颜色渐变是不言而喻的，但让我指出一些其他的事情。注意页脚。

这是我在 HTML 报告脚本中开始做的事情，我鼓励您考虑一下。在某些时候，您可能会设置这样的脚本作为计划作业或任务运行。也许给一组管理员发送电子邮件。随着时间的推移和员工流动，您可能会想“这是从哪里来的？”希望元数据信息可以帮助您追踪它。我创建一个自定义对象并将其转换为 HTML 片段。

#add some metadata about this report
[xml]$metadata = [pscustomobject]@{
    "Report Run" = "$((Get-Date).ToUniversalTime()) UTC"
    "Run By"     = "$($env:USERDOMAIN)$env:username"
    Originated   = $env:Computername
    Command      = $($myinvocation.invocationname)
    Version      = "2.0"
} | ConvertTo-html -as List -Fragment

如果您查看代码，您将看到插入样式标签的附加步骤。

另一个功能是使用“标题”属性或自定义版本来显示附加信息。如果将鼠标悬停在计算机名称上，您将看到一个带有操作系统的弹出窗口。

因为我将 HTML 保存为 XML，所以我可以轻松地解析和更新它。

#convert drive objects to HTML but as an XML document
Write-Verbose "Converting to XML"
[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
$pop = $html.CreateAttribute("title")
$pop.value = (Get-Ciminstance -ClassName Win32_OperatingSystem -Property caption -cimsession $cs).caption
$html.table.item("caption").attributes.append($pop) | Out-Null

当您将鼠标悬停在设备 ID 上时，我会对物理媒体信息执行类似的操作。

使用 Get-CimlinkedInstance 获取信息。由于一台计算机可能有多个驱动器，因此我使用设备 ID 作为键、DiskDrive 实例作为值创建一个哈希表。

#initialize a hashtable of for phsyical media
$hash = @{}
#Create a custom object for each drive
$drives = foreach ($item in $data) {
                        
    $Physical = $item | Get-CimAssociatedInstance -ResultClassName Win32_DiskPartition | Get-CimAssociatedInstance -ResultClassName Win32_DiskDrive
    $hash.Add($item.DeviceID,$physical)

    $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

后来我添加了一个自定义提示类。

#add physical media as a popup for each device
for ($i=1; $i -le $html.table.tr.count -1;$i++) {
    $id = $html.table.tr[$i].ChildNodes[0]."#text"
    $pop = $html.CreateAttribute("tip")
    $props = ($hash.Item($id) | Select-Object -property Caption,SerialNumber,FirmwareRevision,Size,InterfaceType,SCSI* | Out-String).trim()     
    $pop.Value = $props
    $html.table.tr[$i].ChildNodes[0].Attributes.append($pop) | Out-Null
}

由于我不是网页设计人员，最困难的部分是获得正确的样式设置以整齐地显示文本。

td[tip]:hover {
    color: #ff2283;
    position: relative;
}

td[tip]:hover:after {
    content: attr(tip);
    left: 0;
    top: 100%;
    margin-left: 80px;
    margin-top: 10px;
    width: 400px;
    padding: 3px 8px;
    position: absolute;
    color: #85003a;
    font-family: 'Courier New', Courier, monospace;
    font-size: 10pt;
    background-color: gainsboro;
    white-space: pre-wrap;
}

但我不得不说我喜欢它的结果。

您可能不需要编写此脚本，但希望我已经为您提供了一些想法和一些代码示例以供您开始使用。享受吧，我希望你能让我知道你的想法。