Add I/O Device Identifiers subsection to VMHost Hardware report (#126)

tpcarman · claude · tpcarman · commit b3eee6f49aed · 2026-03-05T17:25:56.000+11:00
Adds a new NOTOCHeading5 subsection under each host's Hardware section
displaying VID, DID, SVID, and SSID in lowercase hex for HCL validation.

Uses PCI address mapping via Get-VMHostNetworkAdapter/Get-VMHostHba instead
of VMkernelName (unpopulated on ESXi 8). Guards null PCI keys to handle
software HBAs (iSCSI, software NVMe) without physical PCI addresses.

Adds 7 new localisation keys to all 5 locale files (en-US, en-GB, es-ES,
fr-FR, de-DE).

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/AsBuiltReport.VMware.vSphere/Language/de-DE/VMwarevSphere.psd1 b/AsBuiltReport.VMware.vSphere/Language/de-DE/VMwarevSphere.psd1
@@ -536,6 +536,13 @@ GetAbrVSphereVMHostHardware = ConvertFrom-StringData @'
     PCIDeviceError           = Error collecting PCI device information for {0}. {1}
     PCIDriversFirmwareError  = Error collecting PCI device driver & firmware information for {0}. {1}
     HardwareError            = Error collecting host hardware information for {0}. {1}
+    IODeviceIdentifiers      = E/A-Gerätekennungen
+    VendorID                 = VID
+    DeviceID                 = DID
+    SubVendorID              = SVID
+    SubDeviceID              = SSID
+    TableIODeviceIdentifiers = E/A-Gerätekennungen - {0}
+    IODeviceIdentifiersError = Fehler beim Sammeln der E/A-Gerätekennungen für {0}. {1}
 '@
 
 # Get-AbrVSphereVMHostSystem
diff --git a/AsBuiltReport.VMware.vSphere/Language/en-GB/VMwarevSphere.psd1 b/AsBuiltReport.VMware.vSphere/Language/en-GB/VMwarevSphere.psd1
@@ -536,6 +536,13 @@ GetAbrVSphereVMHostHardware = ConvertFrom-StringData @'
     PCIDeviceError           = Error collecting PCI device information for {0}. {1}
     PCIDriversFirmwareError  = Error collecting PCI device driver & firmware information for {0}. {1}
     HardwareError            = Error collecting host hardware information for {0}. {1}
+    IODeviceIdentifiers      = I/O Device Identifiers
+    VendorID                 = VID
+    DeviceID                 = DID
+    SubVendorID              = SVID
+    SubDeviceID              = SSID
+    TableIODeviceIdentifiers = I/O Device Identifiers - {0}
+    IODeviceIdentifiersError = Error collecting I/O device identifier information for {0}. {1}
 '@
 
 # Get-AbrVSphereVMHostSystem
diff --git a/AsBuiltReport.VMware.vSphere/Language/en-US/VMwarevSphere.psd1 b/AsBuiltReport.VMware.vSphere/Language/en-US/VMwarevSphere.psd1
@@ -536,6 +536,13 @@ GetAbrVSphereVMHostHardware = ConvertFrom-StringData @'
     PCIDeviceError           = Error collecting PCI device information for {0}. {1}
     PCIDriversFirmwareError  = Error collecting PCI device driver & firmware information for {0}. {1}
     HardwareError            = Error collecting host hardware information for {0}. {1}
+    IODeviceIdentifiers      = I/O Device Identifiers
+    VendorID                 = VID
+    DeviceID                 = DID
+    SubVendorID              = SVID
+    SubDeviceID              = SSID
+    TableIODeviceIdentifiers = I/O Device Identifiers - {0}
+    IODeviceIdentifiersError = Error collecting I/O device identifier information for {0}. {1}
 '@
 
 # Get-AbrVSphereVMHostSystem
diff --git a/AsBuiltReport.VMware.vSphere/Language/es-ES/VMwarevSphere.psd1 b/AsBuiltReport.VMware.vSphere/Language/es-ES/VMwarevSphere.psd1
@@ -536,6 +536,13 @@ GetAbrVSphereVMHostHardware = ConvertFrom-StringData @'
     PCIDeviceError           = Error collecting PCI device information for {0}. {1}
     PCIDriversFirmwareError  = Error collecting PCI device driver & firmware information for {0}. {1}
     HardwareError            = Error collecting host hardware information for {0}. {1}
+    IODeviceIdentifiers      = Identificadores de dispositivos de E/S
+    VendorID                 = VID
+    DeviceID                 = DID
+    SubVendorID              = SVID
+    SubDeviceID              = SSID
+    TableIODeviceIdentifiers = Identificadores de E/S - {0}
+    IODeviceIdentifiersError = Error al recopilar identificadores de E/S para {0}. {1}
 '@
 
 # Get-AbrVSphereVMHostSystem
diff --git a/AsBuiltReport.VMware.vSphere/Language/fr-FR/VMwarevSphere.psd1 b/AsBuiltReport.VMware.vSphere/Language/fr-FR/VMwarevSphere.psd1
@@ -536,6 +536,13 @@ GetAbrVSphereVMHostHardware = ConvertFrom-StringData @'
     PCIDeviceError           = Error collecting PCI device information for {0}. {1}
     PCIDriversFirmwareError  = Error collecting PCI device driver & firmware information for {0}. {1}
     HardwareError            = Error collecting host hardware information for {0}. {1}
+    IODeviceIdentifiers      = Identifiants des périphériques d'E/S
+    VendorID                 = VID
+    DeviceID                 = DID
+    SubVendorID              = SVID
+    SubDeviceID              = SSID
+    TableIODeviceIdentifiers = Identifiants E/S - {0}
+    IODeviceIdentifiersError = Erreur lors de la collecte des identifiants E/S pour {0}. {1}
 '@
 
 # Get-AbrVSphereVMHostSystem
diff --git a/AsBuiltReport.VMware.vSphere/Src/Private/Get-AbrVSphereVMHostHardware.ps1 b/AsBuiltReport.VMware.vSphere/Src/Private/Get-AbrVSphereVMHostHardware.ps1
@@ -280,6 +280,50 @@ function Get-AbrVSphereVMHostHardware {
                     }
                 }
                 #endregion ESXi Host PCI Devices Drivers & Firmware
+
+                #region ESXi Host I/O Device Identifiers
+                try {
+                    # Build PCI address -> VMkernel name mapping (VMkernelName is unpopulated on ESXi 8)
+                    # Guard against null keys — software HBAs (iSCSI, software NVMe) have no PCI address
+                    $IOPciToDevice = @{}
+                    Get-VMHostNetworkAdapter -VMHost $VMHost -Physical | ForEach-Object {
+                        if ($_.PciId) { $IOPciToDevice[$_.PciId] = $_.DeviceName }
+                    }
+                    Get-VMHostHba -VMHost $VMHost | ForEach-Object {
+                        if ($_.Pci) { $IOPciToDevice[$_.Pci] = $_.Device }
+                    }
+                    (Get-VMHost $VMHost | Get-View -Property Config).Config.GraphicsInfo | ForEach-Object {
+                        if ($_.pciId) { $IOPciToDevice[$_.pciId] = $_.deviceName }
+                    }
+                    $VMHostIODevices = $esxcli.hardware.pci.list.Invoke() |
+                        Where-Object { $IOPciToDevice.ContainsKey($_.Address) } |
+                        Sort-Object -Property Address
+                    if ($VMHostIODevices) {
+                        Section -Style NOTOCHeading5 -ExcludeFromTOC $LocalizedData.IODeviceIdentifiers {
+                            $VMHostIODeviceInfo = $VMHostIODevices | ForEach-Object {
+                                [PSCustomObject]@{
+                                    $LocalizedData.Device      = $IOPciToDevice[$_.Address]
+                                    $LocalizedData.Model       = $_.DeviceName
+                                    $LocalizedData.VendorID    = [String]::Format("{0:x4}", $_.VendorID)
+                                    $LocalizedData.DeviceID    = [String]::Format("{0:x4}", $_.DeviceID)
+                                    $LocalizedData.SubVendorID = [String]::Format("{0:x4}", $_.SubVendorID)
+                                    $LocalizedData.SubDeviceID = [String]::Format("{0:x4}", $_.SubDeviceID)
+                                }
+                            }
+                            $TableParams = @{
+                                Name         = ($LocalizedData.TableIODeviceIdentifiers -f $VMHost)
+                                ColumnWidths = 13, 31, 14, 14, 14, 14
+                            }
+                            if ($Report.ShowTableCaptions) {
+                                $TableParams['Caption'] = "- $($TableParams.Name)"
+                            }
+                            $VMHostIODeviceInfo | Sort-Object $LocalizedData.Device | Table @TableParams
+                        }
+                    }
+                } catch {
+                    Write-PScriboMessage -Message ($LocalizedData.IODeviceIdentifiersError -f $VMHost.Name, $_.Exception.Message)
+                }
+                #endregion ESXi Host I/O Device Identifiers
             }
         } catch {
             Write-PScriboMessage -Message ($LocalizedData.HardwareError -f $VMHost.Name, $_.Exception.Message)
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add I/O Device Identifiers subsection to VMHost Hardware report, displaying VID/DID/SVID/SSID in lowercase hex for HCL validation ([#126](https://github.com/AsBuiltReport/AsBuiltReport.VMware.vSphere/issues/126))
 - Modular architecture: each report section is now a dedicated private function (`Get-AbrVSphere*`)
 - Internationalization (i18n) support via `Language/` `.psd1` files (`en-US`, `en-GB`, `es-ES`, `fr-FR`, `de-DE`)
 - Pester test suite (`AsBuiltReport.VMware.vSphere.Tests.ps1`, `LocalizationData.Tests.ps1`, `Invoke-Tests.ps1`)
