WingetBatch

Author(s)

• Matthew Bubb

Tags

winget package-manager windows batch-install utility github-api interactive cache updates PwshSpectreConsole

Functions

Start-WingetUpdateCheck Install-WingetAll Get-WingetNewPackages Get-WingetUpdates Enable-WingetUpdateNotifications Disable-WingetUpdateNotifications Set-WingetBatchGitHubToken New-WingetBatchGitHubToken Remove-WingetRecent Export-WingetBatchConfig Import-WingetBatchConfig Set-WingetBatchConfig Get-WingetBatchConfig Invoke-WingetBatchCleanup Update-WingetBatch Invoke-WinGetBatch Repair-WingetBatchManager Get-WingetMachineState Get-WingetPackageInfo Get-WingetHistory Watch-WingetPackages Find-WingetDuplicate Register-WingetMaintenance Get-WingetDependencyGraph Start-WingetServer Get-WingetRecommend Invoke-WingetFleet Restore-WingetSnapshot Test-WingetCompliance Get-WingetHealthScore Send-WingetWebhook Export-WingetOffline Install-WingetProfile Get-WingetChangelog

Dependencies

• • Microsoft.WinGet.Client
  • PwshSpectreConsole

Release Notes

v2.9.0 - The Full Arsenal
- NEW: Get-WingetRecommend - AI-powered package recommendations (persona matching + personality clone).
- NEW: Invoke-WingetFleet - SCCM-lite fleet management over WinRM/SSH.
- NEW: Restore-WingetSnapshot - Package-level rollback engine (undo, restore, diff).
- NEW: Test-WingetCompliance - Policy/compliance engine (required, banned, version floors).
- NEW: Get-WingetHealthScore - Package trustworthiness rating (0-100, A+ through F).
- NEW: Send-WingetWebhook - Discord/Slack/Teams notifications for package events.
- NEW: Export-WingetOffline - Air-gapped offline package deployment with hash verification.
- NEW: Install-WingetProfile - Shareable community setup profiles (8 built-in).
- NEW: Get-WingetChangelog - Version history and release notes diff between versions.
- 34 total commands. Author/Architect: Matthew Bubb.

v2.8.0 - Automation, Visualization & Remote Management
- NEW: Register-WingetMaintenance - Scheduled maintenance tasks for automatic package updates.
 * Daily/Weekly/Monthly recurrence with configurable time and actions.
 * Actions: UpdateAll, UpdateOutdated, CleanupTemp, AuditDrift, NotifyOnly.
 * JSON reports with 30-report retention. Runs as SYSTEM or current user.
 * -Status, -Unregister, -RunNow for full lifecycle management.
- NEW: Get-WingetDependencyGraph - Package dependency graph visualization.
 * Output formats: Mermaid (GitHub/docs), DOT (Graphviz), ASCII Tree, Object.
 * Circular dependency detection and highlighting.
 * Fetches dependency data from winget-pkgs GitHub manifests.
 * Configurable depth, external dependency inclusion, and file output.
- NEW: Start-WingetServer - REST API server for remote package management (Pode).
 * Full CRUD: install, uninstall, update, search packages over HTTP.
 * Endpoints: /api/packages, /api/updates, /api/state, /api/history, /api/stats.
 * API key authentication, rate limiting, request logging.
 * Self-documenting: GET / returns full endpoint catalog.
- Author/Architect: Matthew Bubb.

v2.7.0 - Machine-as-Code & Developer Experience
- NEW: Get-WingetMachineState - Full machine state snapshot, drift comparison, and reconciliation (Machine-as-Code).
 * Export installed packages to portable JSON/YAML manifests.
 * Compare current state against a golden baseline for drift detection.
 * Reconcile: auto-install missing, update outdated, optionally remove extraneous packages.
- NEW: Get-WingetPackageInfo - Rich brew-info-style package explorer with GitHub manifest fetching.
- NEW: Get-WingetHistory - Installation history timeline from registry and winget logs.
- NEW: Watch-WingetPackages - Live terminal dashboard (htop-style) for package monitoring.
- NEW: Find-WingetDuplicate - Detect duplicate packages, multi-source installs, and version clusters.
- NEW: Tab-completion argument completers for package IDs across all commands.
- SECURITY: Eliminated all Invoke-Expression usage in Invoke-WinGetBatch (command injection fix).
- SECURITY: Replaced hardcoded paths with dynamic environment resolution.
- FIXED: Package deduplication bug in Install-WingetAll (duplicates were shown and installed).
- ENHANCED: Installation progress counter [N/M] for all batch operations.
- ENHANCED: Invoke-WinGetBatch now uses COM API as primary install path with CLI fallback.
- Author/Architect: Matthew Bubb.

v2.6.0 - Smart Search Architecture
- ENHANCED: Smart Scope Routing implemented in Install-WingetAll. Purely numeric queries automatically bypass "Id" and "Moniker" fields while retaining Tag matching.
- NEW: Added -LimitResult (default 100) mapped natively to COM API Count parameter, ending searches early to massively boost performance.
- NEW: Added -Id parameter to easily specify specific exact IDs instead of wildcard queries.
- NEW: Added SQLite cache fragmentation check directly in Install-WingetAll logic with automated rebuild recommendations.
- NEW: Implemented Set-WingetBatchConfig and Get-WingetBatchConfig module preferences.
- ENHANCED: Dynamic config-driven COM SearchMatchOption override. ContainsCaseInsensitive remains default.
- FIXED: Microsoft.WinGet.Client\Find-WinGetPackage forced namespace avoids naming collisions with shadowing modules (like Cobalt).
v2.5.0 - COM API Migration (Breaking Fix)
- CRITICAL FIX: Migrated all core functions from winget.exe CLI text-parsing to Microsoft.WinGet.Client COM API.
 * Install-WingetAll now uses Find-WinGetPackage (COM) instead of parsing 'winget search' text output.
 * Get-WingetUpdates now uses Get-WinGetPackage (COM) instead of parsing 'winget upgrade' text output.
 * Installation now uses Install-WinGetPackage (COM) instead of shelling out to winget.exe.
 * Updates now use Update-WinGetPackage (COM) instead of shelling out to winget.exe.
 * This eliminates all dependency on winget.exe being in PATH (a known Windows update regression).
- NEW: Repair-WingetBatchManager - Diagnostic and self-repair tool for common winget issues.
 * Checks winget.exe PATH, Microsoft.WinGet.Client module, COM API health.
 * Auto-repairs by re-registering App Installer and fixing PATH.
- ENHANCED: Background detail jobs now resolve winget.exe by known filesystem paths with COM API fallback.
- ENHANCED: Added --no-progress and --disable-interactivity flags to all remaining CLI calls for cleaner output.
- DEPENDENCY: Microsoft.WinGet.Client is now a required module (auto-installed with WingetBatch).
- Author/Architect: Matthew Bubb. All credit for this architectural migration is attributed solely to him.

v2.4.0 - Security Update & Massive Feature Bloat
- FIXED: Replaced unsafe Invoke-Expression with argument array execution in Invoke-WinGetBatch.
- FIXED: Fallback PS5.1 execution for ForEach-Object -Parallel downloads.
- FIXED: Array casting fixes and character encoding parsing fixes.
- NEW: Get-WingetHoroscope - Predict the celestial fate of your package updates.
- NEW: Invoke-WingetRussianRoulette - Installs a completely random package from the Winget repository.
- NEW: Convert-WingetPackageToHaiku - Generates a 5-7-5 syllable poem for any package.
- NEW: Show-WingetMatrix - Displays your installed packages cascading down the screen like The Matrix.
- NEW: Test-WingetPackageVibes - Arbitrary algorithmic vibe check for Winget packages (Corporate = Cringe).

v2.3.0 - Next-Generation Idempotent Deployment Engine
- NEW: Invoke-WinGetBatch - Idempotent, manifest-driven package deployments using native COM APIs.
 * Decoupled from fragile CLI regex parsing; uses Microsoft.WinGet.Client COM interfaces.
 * Split-Phase Concurrency: Parallel downloads via native PowerShell 7 ForEach-Object -Parallel with serial, collision-free background installations.
 * High-fidelity target state configuration parsing from standard JSON and YAML manifests.
 * Diagnostic exit code mapping (standardizing successful exits 0, pending reboots 3010/1641, and failures).
 * Forensic and auditing: compilation of structured JSON deployment reports containing detailed per-package status telemetry.
 * Full integration with the winget batch environment and standalone distribution channels.
 * Author/Architect: Matthew Bubb. All credit for this next-generation design is attributed solely to him.

v2.0.0 - Major Feature Release
- NEW: Get-WingetNewPackages - Discover recently added packages from winget-pkgs GitHub repository
 * GitHub API integration with pagination support
 * Parallel background job system (max 10 concurrent) for fetching package details
 * Smart job waiting - only waits for jobs with selected packages
 * 30-day package details caching system for faster repeat searches
 * Comprehensive package info: Version, Publisher, GitHub links, License, Pricing, Release Notes, and 20+ fields
 * Interactive re-selection with preserved package information
 * Exclusion filter support to hide specific packages/publishers
 * API rate limit tracking with hourly rollover
 * GitHub token support for 5,000 req/hour (vs 60 unauthenticated)

- NEW: Remove-WingetRecent - Uninstall recently installed packages by date
 * Reads from Windows Registry (HKLM/HKCU Uninstall keys)
 * Filter by installation date (e.g., -Days 7 for last week)
 * Interactive selection of packages to remove

- ENHANCED: Install-WingetAll
 * Now uses --silent flag for cleaner output
 * Improved error handling and reporting

- ENHANCED: Profile Integration
 * Background update checks with cached results
 * 30-minute cache TTL for update notifications

- NEW: Token Management
 * Set-WingetBatchGitHubToken - Store GitHub PAT securely (AES encrypted CliXml)
 * New-WingetBatchGitHubToken - Interactive token creation wizard with masked input

- FIXED: Date parsing bug in API rate limit tracking (timezone handling)
- FIXED: Package selection workflow when going back to change selections

Configuration stored in: ~/.wingetbatch/
 - config.json - Update notification settings
 - github_token.clixml - Secure GitHub Personal Access Token
 - github_ratelimit.json - API usage tracking
 - package_cache.json - 30-day package details cache
 - update_cache.json - Cached update results

Requires: PowerShell 5.1+, winget CLI, PwshSpectreConsole (auto-installs if missing)