Powershell Scripting Guide

Load these files on demand based on the task:

• references/naming-parameters-pipeline.md — Verb-Noun naming, variable casing, no-aliases rule, parameter design, pipeline patterns, PassThru pattern.
• references/error-handling-advanced-patterns.md — ShouldProcess, ConfirmImpact levels, message streams, try/catch patterns, splatting, dynamic parameters, tab completion.
• references/help-testing-quick-reference.md — Comment-based help template, Pester test structure, test checklist, quick reference tables.

Workflow

1. Define function signature — choose approved verb, design parameters with validation, add [CmdletBinding()].
2. Load naming guide — read naming-parameters-pipeline.md to verify verb, variable casing, and pipeline wiring.
3. Implement logic — use Process block for pipeline items, return [PSCustomObject], add ShouldProcess for mutations.
4. Handle errors — read error-handling-advanced-patterns.md for try/catch and stream patterns.
5. Document and test — read help-testing-quick-reference.md for help template and Pester test structure.

Quick Reference

• Approved verb — Get-Verb: Get / Set / New / Remove / Update / Invoke
• Parameter validation — [ValidateSet], [ValidateRange], [ValidateScript]
• Pipeline input — [Parameter(ValueFromPipeline)] + Process block
• No output by default — action cmdlets silent unless -PassThru is specified
• Destructive actions — [CmdletBinding(SupportsShouldProcess)] + ShouldProcess
• Verbose logging — Write-Verbose; never Write-Host for operational messages
• Splatting — $params = @{...}; Cmdlet @params
• Help documentation — <# .SYNOPSIS .DESCRIPTION .EXAMPLE #> inside function