Add Hyper-V host lifecycle audit script#48
Open
AlrightLad wants to merge 2 commits intoDTC-Inc:mainfrom
Open
Conversation
Contributor
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
🚧 Files skipped from review as they are similar to previous changes (1)
📝 WalkthroughWalkthroughAdds a new administrator-run PowerShell script that audits a Hyper-V host by starting a transcript log, collecting host OS/hardware, disks, storage controllers, VM inventory, VHD details, checkpoints, virtual switches, network adapters, and VMQ status, then stops the transcript and reports the log path. (50 words) Changes
Sequence Diagram(s)sequenceDiagram
autonumber
participant User as "Administrator (User)"
participant Script as "Invoke-HyperVHostAudit.ps1"
participant Host as "Hyper-V Host (CIM/Hyper-V cmdlets)"
participant Files as "VHD files / Log storage"
User->>Script: Launch with -LogPath
Script->>Files: Start-Transcript (create log)
Script->>Host: Query OS, ComputerSystem, Processor
Script->>Host: Query LogicalDisks, StorageControllers
Script->>Host: Get-VM (cache VM list)
loop For each VM
Script->>Host: Get-VM/VHD info (Get-VHD)
Host-->>Script: VHD size / used (or error)
Script->>Host: Get-VMSnapshot (checkpoints)
end
Script->>Host: Get-VMSwitch, Get-NetAdapter, Get-NetAdapterVmq
Script->>Files: Write summary to transcript
Script->>Files: Stop-Transcript
Script->>User: Print "HOST AUDIT COMPLETE" and transcript path
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~20 minutes Poem
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 2
🧹 Nitpick comments (2)
msft-windows/msft-windows-host-lifecycle-audit (2)
22-22: Cache VM inventory once for consistency.
Get-VMis called repeatedly at Line [22], Line [25], and Line [28]. Capturing it once reduces overhead and avoids cross-section drift during long runs.Suggested refactor
Write-Host "===== VM INVENTORY =====" -ForegroundColor Cyan -Get-VM | Select-Object Name, State, Generation, @{N='MemoryAssignedGB';E={[math]::Round($_.MemoryAssigned/1GB,1)}}, @{N='MemoryStartupGB';E={[math]::Round($_.MemoryStartup/1GB,1)}}, ProcessorCount, DynamicMemoryEnabled | Format-Table -AutoSize +$vms = Get-VM +$vms | Select-Object Name, State, Generation, @{N='MemoryAssignedGB';E={[math]::Round($_.MemoryAssigned/1GB,1)}}, @{N='MemoryStartupGB';E={[math]::Round($_.MemoryStartup/1GB,1)}}, ProcessorCount, DynamicMemoryEnabled | Format-Table -AutoSize Write-Host "===== VHDX PATHS & SIZES =====" -ForegroundColor Cyan -Get-VM | Get-VMHardDiskDrive | ForEach-Object { $vhd = Get-VHD -Path $_.Path -ErrorAction SilentlyContinue; [PSCustomObject]@{VMName=$_.VMName;Path=$_.Path;MaxSizeGB=if($vhd){[math]::Round($vhd.Size/1GB,1)}else{'ERROR'};UsedGB=if($vhd){[math]::Round($vhd.FileSize/1GB,1)}else{'ERROR'};Type=if($vhd){$vhd.VhdType}else{'N/A'}} } | Format-Table -AutoSize +$vms | Get-VMHardDiskDrive | ForEach-Object { $vhd = Get-VHD -Path $_.Path -ErrorAction SilentlyContinue; [PSCustomObject]@{VMName=$_.VMName;Path=$_.Path;MaxSizeGB=if($vhd){[math]::Round($vhd.Size/1GB,1)}else{'ERROR'};UsedGB=if($vhd){[math]::Round($vhd.FileSize/1GB,1)}else{'ERROR'};Type=if($vhd){$vhd.VhdType}else{'N/A'}} } | Format-Table -AutoSize Write-Host "===== VM CHECKPOINTS =====" -ForegroundColor Cyan -$snaps = Get-VM | Get-VMSnapshot -ErrorAction SilentlyContinue +$snaps = $vms | Get-VMSnapshot -ErrorAction SilentlyContinueAlso applies to: 25-25, 28-28
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@msft-windows/msft-windows-host-lifecycle-audit` at line 22, Capture the output of Get-VM once into a local variable (e.g., $vms) and reuse that variable in the subsequent pipelines instead of calling Get-VM multiple times; update the commands that currently use Get-VM followed by Select-Object / Format-Table (the pipeline that selects Name, State, Generation, MemoryAssignedGB, MemoryStartupGB, ProcessorCount, DynamicMemoryEnabled) and any other occurrences to read from the cached variable to reduce overhead and ensure a consistent VM snapshot across the report.
6-40: Persist audit output to%WINDIR%\Logsfor traceability.Current output is console-only. Adding transcript logging improves QA evidence retention and post-run validation.
Suggested transcript wrapper
+$logPath = Join-Path $env:WINDIR ("Logs\\HyperV-Host-Audit-{0}.log" -f (Get-Date -Format "yyyyMMdd-HHmmss")) +Start-Transcript -Path $logPath -Force | Out-Null + Write-Host "===== HOST OS & HARDWARE =====" -ForegroundColor Cyan ... Write-Host "===== HOST AUDIT COMPLETE =====" -ForegroundColor Green + +Stop-Transcript | Out-Null +Write-Host ("Audit transcript: {0}" -f $logPath) -ForegroundColor GreenBased on learnings:
Applies to **/*.ps1 : Verify transcripts/logs in %WINDIR%\logs after execution; support RMM simulation by setting $RMM=1 and predefining required variables during testing.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@msft-windows/msft-windows-host-lifecycle-audit` around lines 6 - 40, The script currently only writes to the console (Write-Host) and should persist output to %WINDIR%\Logs; update the top of the script to start a transcript (Start-Transcript) into a uniquely named file under $env:WINDIR\Logs after creating that folder if missing, and ensure Stop-Transcript runs at the end (or in a finally block) so all output from the host and VM enumeration sections (calls such as Get-CimInstance, Get-VM, Get-VHD, Get-VMSnapshot, Get-VMSwitch, Get-NetAdapter, Get-NetAdapterVmq) is captured; also add support for RMM simulation by honoring a $RMM variable (default 0) and allowing predefinition of required variables during testing, and log any Start/Stop-Transcript errors to the console (Write-Host) so failures to write the log are visible.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@msft-windows/msft-windows-host-lifecycle-audit`:
- Around line 1-9: Add explicit preflight checks before any Hyper-V cmdlet
usage: verify the script is running elevated (check membership in Administrators
or use Test-ProcessAdminRights) and confirm the Hyper-V module is available and
importable (use Get-Command Get-VM/Get-VHD/Get-VMSnapshot/Get-VMSwitch or try
Import-Module Hyper-V -ErrorAction Stop); if checks fail, emit a clear error and
exit early so later calls to Get-VM, Get-VMHardDiskDrive, Get-VHD,
Get-VMSnapshot and Get-VMSwitch are never attempted without privileges or the
module, or alternatively gate the Hyper-V sections behind those checks to skip
them safely.
- Around line 28-29: Replace the silent failures around the Get-VMSnapshot and
Get-NetAdapterVmq calls with explicit error handling: call Get-VMSnapshot and
Get-NetAdapterVmq with ErrorAction Stop inside a try/catch, assign results to
$snaps (and the net adapter var) and in the catch use Write-Warning (or output
an "ERROR" marker) to indicate the query failed; only if the call succeeds check
for empty result and emit "No checkpoints found" (or the existing success
output). Use the same pattern as the inline check at line 25
(if($vhd){...}else{'ERROR'}) and reference the Get-VMSnapshot/Get-NetAdapterVmq
call sites and $snaps variable to locate and update the code.
---
Nitpick comments:
In `@msft-windows/msft-windows-host-lifecycle-audit`:
- Line 22: Capture the output of Get-VM once into a local variable (e.g., $vms)
and reuse that variable in the subsequent pipelines instead of calling Get-VM
multiple times; update the commands that currently use Get-VM followed by
Select-Object / Format-Table (the pipeline that selects Name, State, Generation,
MemoryAssignedGB, MemoryStartupGB, ProcessorCount, DynamicMemoryEnabled) and any
other occurrences to read from the cached variable to reduce overhead and ensure
a consistent VM snapshot across the report.
- Around line 6-40: The script currently only writes to the console (Write-Host)
and should persist output to %WINDIR%\Logs; update the top of the script to
start a transcript (Start-Transcript) into a uniquely named file under
$env:WINDIR\Logs after creating that folder if missing, and ensure
Stop-Transcript runs at the end (or in a finally block) so all output from the
host and VM enumeration sections (calls such as Get-CimInstance, Get-VM,
Get-VHD, Get-VMSnapshot, Get-VMSwitch, Get-NetAdapter, Get-NetAdapterVmq) is
captured; also add support for RMM simulation by honoring a $RMM variable
(default 0) and allowing predefinition of required variables during testing, and
log any Start/Stop-Transcript errors to the console (Write-Host) so failures to
write the log are visible.
ℹ️ Review info
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro
Run ID: 0f92c44d-a0d1-44bc-b3dc-10ccf428616c
📒 Files selected for processing (1)
msft-windows/msft-windows-host-lifecycle-audit
AlrightLad
pushed a commit
to AlrightLad/Script-Testing
that referenced
this pull request
Mar 25, 2026
Addresses all CodeRabbit review feedback from DTC-Inc/msp-script-library#48: - Add #Requires -RunAsAdministrator and #Requires -Modules Hyper-V for preflight validation (Issue 1: missing preflight checks) - Cache Get-VM result once ($allVMs) to avoid repeated calls and cross-section drift during long runs (Issue 2: repeated Get-VM) - Add Start-Transcript/Stop-Transcript logging to %SystemRoot%\Logs for QA evidence retention (nitpick: console-only output) - Replace -ErrorAction SilentlyContinue with try/catch blocks on Get-VHD, Get-VMSnapshot, and Get-NetAdapterVmq to surface real errors instead of silently masking them (nitpick: audit masking) - Add proper comment-based help, CmdletBinding, and -LogPath param to match repo script conventions https://claude.ai/code/session_016vxJGXe9VEcq5g2rqDPK4J
Audits Hyper-V host for server lifecycle quote validation, gathering comprehensive information including OS, hardware, CPU, memory, disk layout, VM inventory, and network configuration.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
used during server quote QA checks to gather all HV host information
Summary by CodeRabbit