Hyper-V VHDX Auditing
Purpose
Collects detailed information about Hyper-V VHD and VHDX files and saves the results as an HTML table in a NinjaRMM custom field.
Associated content
| Content | Type | Purpose |
|---|---|---|
| cPVAL Hyper-V Vhdx Details | Custom Field | Holds the HTML-formatted inventory of Hyper-V virtual hard disks (VHD/VHDX). |
| Audit Hyper-V VHDX | Automation | Gathers VHD/VHDX details and writes them to the custom field. |
| Hyper-V Vhdx Audit | Task | Runs the automation on Hyper-V hosts on a scheduled cadence. |
Additional dependencies
| Content | Type | Purpose |
|---|---|---|
| cPVAL - Roles Detected | Custom Field | Records detected server roles for Windows systems. |
| cPVAL - Server Role - Hyper-V Host | Group | A group containing Windows servers with the Hyper-V role. |
| Server Roles Detection and Grouping for NinjaOne | Solution | Classifies servers into role-based groups used by the automation. |
Implementation
- Import and configure the Server Roles Detection and Grouping for NinjaOne solution.
- Create the cPVAL Hyper-V Vhdx Details custom field.
- Create the Audit Hyper-V VHDX automation.
- Create the Hyper-V Vhdx Audit task to run the automation daily at
02:00 PMagainst the cPVAL - Server Role - Hyper-V Host group.
FAQ
Q: What does this solution do?
A: Collects Hyper-V VHD/VHDX details and stores them as an HTML table in the cPVAL Hyper-V Vhdx Details custom field.
Q: Where is the data stored?
A: In the cPVAL Hyper-V Vhdx Details custom field.
Q: Which automation populates it?
A: The Audit Hyper-V VHDX automation (script referenced in the automation configuration repository).
Q: What are the prerequisites?
A: The target must be a Windows server with the Hyper-V role; ensure the Server Roles Detection and Grouping solution is configured so Hyper-V hosts are targeted.
Q: How often should it run?
A: It runs the automation at 02:00 PM daily.
Q: Can I edit the custom field manually?
A: No — the custom field is auto-populated by the automation. The field footer notes: "Auto-generated by script. Do not edit manually."
Q: How do I interpret the table?
A: The table includes disk path, allocation type (Dynamic/Fixed), current file size, fragmentation percentage, and a DataCollectionTime column showing when the data was collected.