Invoke-Wizard Blog

A Hugo blog for the InvokeSystems PowerShell module suite. Documents automation tools for Windows system administration.

Module Suite

This blog documents the following PowerShell modules:

• InvokeSystems.Common - Shared helpers (event log initialization, admin context check)
• InvokeSystems.RestrictedTask - Creates and manages restricted scheduled tasks with hash-verified payloads
• InvokeSystems.UpdateRepair - Windows Update remediation with logging and optional event log integration
• InvokeSystems.Generator - Secure random string, password, and GUID generation

All modules use the InvokeSystems.* prefix following Microsoft Graph naming conventions.

Function Naming Convention

Functions use the Inv prefix (Microsoft.Graph-style convention) so they're easy to spot in a session and don't collide with anything you already have:

Module	Functions
InvokeSystems.Common	Initialize-InvEventLogSource, Test-InvAdministratorContext
InvokeSystems.RestrictedTask	Get-InvTask, New-InvTask, Remove-InvTask, Update-InvTask, Invoke-InvTask, Get-InvTaskPrincipal, Set-InvTaskPrincipal
InvokeSystems.UpdateRepair	Invoke-InvUpdateRepair
InvokeSystems.Generator	New-InvPassword, New-InvRandomString, New-InvGuid, New-InvRandomNumber

Building and Running the Hugo Site

The Hugo site is fully containerized with Docker. The Dockerfile handles everything:

# Build the image
docker build -t invoke-wizard-blog .

# Run the container
docker run -d -p 8080:80 --name invoke-wizard-blog invoke-wizard-blog

# Or use docker-compose
docker-compose up -d

The Dockerfile:

• Initializes git submodules (Terminal theme)
• Builds the minified Hugo site
• Serves with nginx

Site will be available at http://localhost:8080.

For Nginx Proxy Manager

Point your proxy host to the container:

• Backend: http://invoke-wizard-blog:80 (if using docker network)
• Or: http://localhost:8080 (if exposing port directly)

CI/CD with GitHub Actions

Docker Build

Manually build and push Docker image to GitHub Container Registry:

• Run from Actions tab → "Build and Push Docker Image" → Run workflow
• See .github/workflows/docker-build.yml

Blog Post Ingestion

The blog automatically ingests posts from other repositories:

• Source repos push changes → Triggers ingestion workflow
• Posts land in staging (master branch)
• Promote to production manually or on weekly schedule

See .github/workflows/README.md for details.

PowerShell Gallery Publishing

Manually publish modules to PSGallery:

• Run from Actions tab → "Publish to PowerShell Gallery" → Run workflow
• Publishes all modules: InvokeSystems.Common, InvokeSystems.RestrictedTask, InvokeSystems.UpdateRepair, InvokeSystems.Generator
• Skips if version already exists
• Requires PSGALLERY_API_KEY secret
• See .github/workflows/publish-psgallery.yml

Quick Start:

1. Get API key from https://www.powershellgallery.com/account
2. Add as repository secret: PSGALLERY_API_KEY
3. Update module manifests (Author, LicenseUri, ProjectUri)
4. Run workflow from Actions tab to publish