Governance Scripts
MicroHack Scripts
Section titled “MicroHack Scripts”PowerShell scripts for workshop automation. These are located in the scripts/ directory at the repository root.
Script Reference
Section titled “Script Reference”| Script | Purpose | When to Use |
|---|---|---|
Score-Team.ps1 | Record team scores | During workshop |
Get-Leaderboard.ps1 | Display team rankings | During workshop |
Cleanup-Resources.ps1 | Delete all workshop resources | After workshop |
During the MicroHack
Section titled “During the MicroHack”Score a Team
Section titled “Score a Team”.\scripts\Score-Team.ps1 -TeamName "team1" -Challenge "C1" -Score 20Parameters:
| Parameter | Required | Description |
|---|---|---|
-TeamName | Yes | Team identifier |
-Challenge | Yes | Challenge code (C0–C7 or Bonus) |
-Score | Yes | Points awarded (0–30) |
-Notes | No | Optional scoring notes |
-ScoreFile | No | Path to JSON score file (defaults to scores.json) |
Scores are capped at the maximum for each challenge.
Display Leaderboard
Section titled “Display Leaderboard”.\scripts\Get-Leaderboard.ps1Shows real-time rankings with medals for top 3 teams. Use -Detailed for breakdown by challenge.
After the MicroHack
Section titled “After the MicroHack”Cleanup Resources
Section titled “Cleanup Resources”.\scripts\Cleanup-Resources.ps1Deletes ArcBox and Azure Migrate resource groups for all teams. Supports -WhatIf to preview deletions before committing.
Always run with -WhatIf first to preview what will be deleted.
Troubleshooting
Section titled “Troubleshooting”| Issue | Solution |
|---|---|
command not found: pwsh | PowerShell not installed — install PowerShell 7+ |
az: command not found | Azure CLI not installed — install via brew install azure-cli or equivalent |
| Permission errors | Ensure Owner or Contributor role on the subscription |