Consolidate build scripts into a single Build-Samples.ps1

[5an7y-Microsoft]

Summary

Replaces the three separate build scripts (Build-AllSamples.ps1, Build-SampleSet.ps1, Build-Sample.ps1) with a single unified Build-Samples.ps1 that handles all build scenarios. Adds a new ListAllSamples.ps1 for sample discovery.

Motivation

The previous build system required users to choose between three scripts depending on the scenario, with a confusing call chain (Build-AllSamples → Build-SampleSet → Build-Sample). This consolidation provides a single entry point while keeping the code maintainable through internal helper functions.

Changes

New scripts

• Build-Samples.ps1 — Single build orchestrator that replaces all three scripts. Includes:
  • Build-SingleSample internal function (formerly Build-Sample.ps1)
  • Resolve-BuildEnvironment, Import-SampleExclusions, and other well-structured helpers
  • Wildcard support in -Samples parameter (e.g. .\Build-Samples -Samples 'tools.*')
  • Improved build plan and failure output formatting
  • Requires PowerShell 7+ (explicit #Requires directive)
• ListAllSamples.ps1 — Dedicated sample discovery script, decoupled from building

Deleted scripts

• Build-AllSamples.ps1
• Build-SampleSet.ps1
• Build-Sample.ps1

Updated files

• .github/workflows/ci.yml — Calls Build-Samples.ps1 instead of Build-AllSamples.ps1
• .github/scripts/Build-ChangedSamples.ps1 — Uses Build-Samples.ps1 for both full and partial builds
• Building-Locally.md — Rewritten Step 6 with new script usage, examples (including wildcards), and updated example output

Usage examples

# Build everything (discovers samples automatically):
.\Build-Samples

# Build samples matching a wildcard:
.\Build-Samples -Samples 'tools.*'

# Build specific samples for one configuration:
.\Build-Samples -Samples 'usb.kmdf_fx2' -Configurations 'Debug' -Platforms 'x64'

Testing

CI workflow runs successfully on fork (5an7y-Microsoft/Windows-driver-samples-2)