debugging-and-error-recovery
A disciplined general debugging workflow for PowerShell/DSC code, builds, and tests: reproduce, localize, reduce to a minimal case, fix the root cause, then guard with a regression test. Stop-the-line on a red build; fix causes not symptoms; never swallow an error to make a failure disappear. A language-neutral method with PowerShell tactics (-ErrorAction Stop, try/catch, Get-PSCallStack). USE FOR: debugging, how to debug, systematic debugging, reproduce the bug, isolate the failure, root cause analysis, minimal repro, bisect a regression, flaky test, intermittent failure, error handling strategy, stop the line, regression guard, works on my machine, heisenbug. DO NOT USE FOR: DSC resource failures on a node (use dsc-troubleshooting), WinRM connectivity (use winrm-troubleshooting), Sampler build or Pester failure diagnosis (use sampler-build-debug), whether a long job is stuck (use long-running-job-monitor), security review (use agent-security-review).
Pinned to revision 7a186c5dfcf8, so it is the text this page describes rather than whatever the author pushed since.
Files
Every link opens the file at its source, pinned to the revision this page describes.