little-helper

WinGet Setup PowerShell Script - Documentation

File: Setup-WinGet.ps1
Version: 2.5.2
Date: March 7, 2026
Status: ✅ Ready to Use

---

📋 OVERVIEW

The Setup-WinGet.ps1 PowerShell script provides an automated, comprehensive setup and configuration system for Windows Package Manager (WinGet) for use with My Little Helper.

What It Does:

✅ Checks if WinGet is installed
✅ Installs WinGet if missing (2 methods)
✅ Configures WinGet sources
✅ Verifies WinGet is working properly
✅ Creates quick reference documentation
✅ Provides troubleshooting guidance

---

🚀 HOW TO RUN

Method 1: Right-Click (Easiest)

1. Right-click Setup-WinGet.ps1
2. Select "Run with PowerShell"
3. Click "Yes" when prompted for Administrator
4. Follow on-screen instructions

Method 2: PowerShell Window

# Open PowerShell as Administrator
# Navigate to project folder
cd "C:\Users\GreenHornet\IdeaProjects\My Little Helper"

# Run the script
.\Setup-WinGet.ps1

Method 3: From Windows Terminal

# Open Windows Terminal (Admin)
# Navigate to project folder
cd "C:\Users\GreenHornet\IdeaProjects\My Little Helper"

# Run the script
.\Setup-WinGet.ps1

---

📊 SCRIPT FEATURES

8-Step Automated Setup Process

STEP 1: System Requirements Check

• ✅ Verifies Windows version (10+ or 11)
• ✅ Checks Administrator privileges
• ✅ Validates PowerShell version
• ✅ Reports system information

STEP 2: WinGet Installation Check

• ✅ Detects if WinGet is installed
• ✅ Shows current version if present
• ✅ Displays installation path
• ✅ Determines if installation is needed

STEP 3: WinGet Installation (if needed)

• ✅ Method 1: Microsoft Store installation
• ✅ Method 2: GitHub direct download
• ✅ Automatic fallback between methods
• ✅ Installation verification

STEP 4: WinGet Configuration

• ✅ Updates package sources
• ✅ Lists available sources
• ✅ Accepts package agreements
• ✅ Configures default settings

STEP 5: Functionality Verification

• ✅ Tests version command
• ✅ Tests list command
• ✅ Tests search command
• ✅ Confirms WinGet is operational

STEP 6: WinGet Information Display

• ✅ Shows version details
• ✅ Lists configured sources
• ✅ Displays common commands
• ✅ Provides usage examples

STEP 7: Environment Configuration

• ✅ Checks PATH environment
• ✅ Verifies Windows App Execution Alias
• ✅ Confirms WinGet accessibility
• ✅ Reports configuration status

STEP 8: Reference Documentation

• ✅ Creates WinGet_Quick_Reference.txt
• ✅ Includes command reference
• ✅ Lists pre-configured packages
• ✅ Provides troubleshooting tips

---

🎯 INSTALLATION METHODS

Method 1: Microsoft Store (Primary)

- Opens Microsoft Store automatically
- User completes installation via Store UI
- Most reliable method
- Automatic updates via Store

Method 2: GitHub Direct (Fallback)

- Downloads latest WinGet release from GitHub
- Installs .msixbundle package
- Used if Microsoft Store method fails
- Manual download and installation

---

📖 QUICK REFERENCE FILE

The script creates WinGet_Quick_Reference.txt containing:

Contents:

• Setup date and WinGet version
• Common WinGet commands with examples
• Pre-configured package IDs from My Little Helper
• Useful command-line options
• Troubleshooting guidance
• Resource links (documentation, web search, GitHub)

Location:

C:\Users\GreenHornet\IdeaProjects\My Little Helper\WinGet_Quick_Reference.txt

---

💡 USAGE SCENARIOS

Scenario 1: New System Setup

User has never used WinGet before:
  1. Run Setup-WinGet.ps1
  2. Script installs WinGet
  3. Configures sources
  4. Creates reference guide
  5. Ready to use My Little Helper

Scenario 2: Verify Existing Installation

User has WinGet but wants to verify:
  1. Run Setup-WinGet.ps1
  2. Script detects existing installation
  3. Updates sources and configuration
  4. Verifies functionality
  5. Creates reference guide

Scenario 3: Troubleshooting

WinGet not working properly:
  1. Run Setup-WinGet.ps1
  2. Script identifies issues
  3. Attempts to fix problems
  4. Re-configures if needed
  5. Provides error details

---

🎨 COLOR-CODED OUTPUT

The script uses color-coding for clarity:

Color	Meaning	Example
🟢 Green	Success	✓ WinGet installed successfully
🔴 Red	Error	✗ Administrator privileges required
🟡 Yellow	Warning	⚠ PowerShell 5.0 or higher recommended
🔵 Blue	Information	ℹ Windows Version: 10.0.22631
🔷 Cyan	Headers	=== STEP 1: Checking System Requirements ===

---

🔧 TECHNICAL DETAILS

Requirements:

• OS: Windows 10 (1809+) or Windows 11
• PowerShell: 5.0 or higher
• Privileges: Administrator
• Internet: Required for installation
• Storage: ~100MB for WinGet

PowerShell Functions:

Write-ColorOutput   # Colored console output
Write-Header        # Section headers
Write-Success       # Success messages
Write-Error         # Error messages
Write-Warning       # Warning messages
Write-Info          # Information messages
Test-WinGetInstalled # Check WinGet status

Error Handling:

• Comprehensive try-catch blocks
• Graceful fallback between methods
• Detailed error messages
• Actionable troubleshooting steps

---

✅ VERIFICATION TESTS

The script performs these verification tests:

1. Version Test

winget --version
# Expected: v1.x.xxxx or similar

2. List Test

winget list --accept-source-agreements
# Expected: List of installed packages

3. Search Test

winget search "Microsoft.PowerShell"
# Expected: Search results with PowerShell

---

🚨 TROUBLESHOOTING

If Script Fails:

“Script cannot be loaded” Error

# Set execution policy
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Then run script again
.\Setup-WinGet.ps1

“Not running as Administrator” Error

1. Right-click PowerShell
2. Select "Run as Administrator"
3. Navigate to project folder
4. Run script again

“WinGet not found after installation”

1. Restart PowerShell
2. Run: Get-Command winget
3. If still not found, restart computer
4. Run script again

“Microsoft Store method failed”

Script automatically tries GitHub method
If both fail:
  1. Visit: https://aka.ms/getwinget
  2. Manual install from Store
  3. Run script again to verify

---

📋 OUTPUT FILES

Files Created by Script:

File	Location	Purpose
WinGet_Quick_Reference.txt	Project root	Command reference guide
Setup log	Console output	Installation details

Files NOT Created (Manual):

• WinGet itself is installed to: C:\Program Files\WindowsApps\
• WinGet configuration: %LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_*\

---

🎯 INTEGRATION WITH MY LITTLE HELPER

After Running Setup Script:

1. Launch My Little Helper:

   Double-click START.bat
   

2. Access Software Installer:

   Main Menu → Option 11
   

3. Use WinGet Features: ``` Options 1-24 now fully functional
   • Install pre-configured packages (1-11)
   • Search packages (16)
   • Manage versions (19)
   • Check updates (20)
   • Update WinGet (23) ```

---

📊 SUCCESS INDICATORS

Script Completed Successfully If:

✅ “SETUP COMPLETE” header displayed
✅ WinGet version shown
✅ “Installation Status: Ready” displayed
✅ “Configuration: Complete” displayed
✅ WinGet_Quick_Reference.txt created
✅ No red error messages

---

🔄 RE-RUNNING THE SCRIPT

Safe to Re-run:

• ✅ Script is idempotent (safe to run multiple times)
• ✅ Won’t reinstall if WinGet exists
• ✅ Updates configuration
• ✅ Recreates reference file
• ✅ Verifies functionality

When to Re-run:

• After Windows updates
• If WinGet stops working
• To update sources
• To regenerate reference file
• For verification after changes

---

📖 COMMAND EXAMPLES FROM REFERENCE

Common Commands Created in Reference File:

# Search
winget search Python

# Install
winget install --id=Microsoft.PowerShell

# List installed
winget list

# Check updates
winget upgrade

# Update all
winget upgrade --all

# Update specific
winget upgrade --id=Microsoft.PowerShell

# Uninstall
winget uninstall --id=FileZilla.FileZilla

# Package details
winget show --id=VideoLAN.VLC

# Update sources
winget source update

---

🎉 BENEFITS

Why Use This Script:

1. Automated Setup: No manual steps required
2. Error Handling: Handles common issues automatically
3. Verification: Ensures WinGet is working
4. Documentation: Creates reference guide
5. Idempotent: Safe to run multiple times
6. Troubleshooting: Provides actionable error messages
7. Integration: Designed for My Little Helper
8. Comprehensive: Covers all setup aspects

---

📞 SUPPORT

If You Need Help:

1. Check Output: Script provides detailed status messages
2. Review Reference: See WinGet_Quick_Reference.txt
3. Verify Requirements: Windows 10+, Admin rights
4. Check Internet: Required for installation
5. Manual Install: Visit https://aka.ms/getwinget

Resources:

• WinGet Documentation: https://learn.microsoft.com/windows/package-manager/
• Package Search: https://winstall.app
• GitHub Issues: https://github.com/microsoft/winget-cli/issues

---

🏆 COMPLETION

After Successful Setup:

✅ WinGet is installed and configured
✅ Package sources are updated
✅ Functionality is verified
✅ Quick reference created
✅ Ready to use with My Little Helper
✅ All 24 Software Installer options functional

---

File: Setup-WinGet.ps1
Version: 2.5.2
Status: ✅ Production Ready
Date: March 7, 2026

Next Step: Run the script to set up WinGet! 🚀