Windows 10/11 Provisioning & Debloat Utility for MSP Technicians
One-click Windows provisioning — debloat, harden, and tune for production use
@@ -23,16 +23,27 @@ ## ✨ Features - **One-Click Provisioning** — Single PowerShell script for full Windows setup -- **AppX Bloatware Removal** — Removes pre-installed Windows Store apps and Xbox bloatware +- **AppX Bloatware Removal** — Removes Xbox-related AppX packages - **Service Hardening** — Ensures essential services (Print Spooler) are enabled and automatic -- **Power Tuning** — Applies high performance or balanced power scheme +- **Power Tuning** — Applies High Performance power scheme - **Restart-Friendly** — No background service installation required; run from any PowerShell prompt - **Remote Execution** — Deploy via URL download — perfect for remote technician scenarios ## 🚀 Quick Start +Run this one-liner from an **elevated PowerShell** prompt on any Windows 10/11 machine: + +```powershell +# One-liner for MSP technician use — downloads and executes the toolkit +iex ((New-Object System.Net.WebClient).DownloadString( + 'https://raw.githubusercontent.com/OneByJorah/MSPEngine/main/install.ps1' +)) +``` + +Alternatively, clone the repo and run locally: + ```powershell -# Run from an elevated PowerShell prompt +# Local execution from an elevated PowerShell prompt Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process .\install.ps1 ``` @@ -42,30 +53,40 @@ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process | Step | Action | |------|--------| | 1 | Downloads MSP-Ultra-Debloat.ps1 utility | -| 2 | Removes AppX packages (system bloatware) | -| 3 | Removes Xbox-related applications and services | -| 4 | Ensures Print Spooler service is enabled and running | -| 5 | Sets power scheme to High Performance or Balanced | -| 6 | System is ready for production deployment | +| 2 | Removes Xbox-related AppX packages (bloatware) | +| 3 | Ensures Print Spooler service is enabled and running | +| 4 | Sets power scheme to High Performance | +| 5 | System is ready for production deployment | ## 🌐 Remote Execution -For remote technician scenarios, download and execute directly: - -```powershell -# One-liner for MSP technician use -iex ((New-Object System.Net.WebClient).DownloadString( - 'https://raw.githubusercontent.com/OneByJorah/J1-MSP-Toolkit/main/install.ps1' -)) -``` +For remote technician scenarios, use the one-liner in [Quick Start](#-quick-start) from an elevated PowerShell session. No USB, no SCCM, no RMM agent required — ideal for break-fix and rapid provisioning. ## 📁 Project Structure ``` -J1-MSP-Toolkit/ -├── install.ps1 # Main installation script -├── debloat/ # Debloat utility scripts -└── README.md +|MSPEngine/ +├── install.ps1 # Bootstrap installer — downloads and executes debloat script +├── debloat/ +│ └── MSP-Ultra-Debloat.ps1 # Core debloat utility — removes Xbox bloat, enables services +├── INTENT.md # Engineering intent reconstruction +├── README.md # Primary documentation (this file) +├── CHANGELOG.md # Release history +├── ROADMAP.md # Future direction +├── CONTRIBUTING.md # Contribution guidelines +├── SECURITY.md # Security policy & disclosure +├── CODE_OF_CONDUCT.md # Community standards +├── LICENSE # MIT License +├── j1.yaml # J1-PIPELINE registry +├── .gitignore # Git ignore rules +└── .github/ + ├── dependabot.yml # Weekly GitHub Actions dependency updates + ├── workflows/ + │ └── codeql.yml # CodeQL security analysis + ├── ISSUE_TEMPLATE/ + │ ├── bug_report.md # Bug report template + │ └── feature_request.md # Feature request template + └── PULL_REQUEST_TEMPLATE.md # PR submission template ``` ## 📄 License diff --git a/install.ps1 b/install.ps1 index de2e65c..97d1796 100644 --- a/install.ps1 +++ b/install.ps1 @@ -1,6 +1,6 @@ -Write-Host "Starting J1-MSP-Toolkit..." +Write-Host "Starting MSPEngine..." -$scriptURL = "https://raw.githubusercontent.com/OneByJorah/J1-MSP-Toolkit/main/debloat/MSP-Ultra-Debloat.ps1" +$scriptURL = "https://raw.githubusercontent.com/OneByJorah/MSPEngine/main/debloat/MSP-Ultra-Debloat.ps1" $temp = "$env:TEMP\debloat.ps1" Invoke-WebRequest $scriptURL -OutFile $temp diff --git a/j1.yaml b/j1.yaml new file mode 100644 index 0000000..8ad0205 --- /dev/null +++ b/j1.yaml @@ -0,0 +1,15 @@ +repo: MSPEngine +class: PowerShell, Shell, Windows, CLI +org: OneByJorah +owner: Jhonattan L. Jimenez +license: MIT +production_score: 76 +last_audit: "2026-07-05T20:30:00Z" +last_publish: null +standards_version: "2.1" +dependencies: [] +deploy_target: scratch +tailscale_only: false +public_facing: true +community_sla_hours: 48 +adoption_tracked: false diff --git a/tests/MSP-Ultra-Debloat.Tests.ps1 b/tests/MSP-Ultra-Debloat.Tests.ps1 new file mode 100644 index 0000000..60fe6d0 --- /dev/null +++ b/tests/MSP-Ultra-Debloat.Tests.ps1 @@ -0,0 +1,50 @@ +BeforeAll { + # Mock external commands to avoid actual system changes + Mock Get-AppxPackage { return @() } + Mock Remove-AppxPackage { return $null } + Mock Set-Service { return $null } + Mock Start-Service { return $null } + Mock powercfg { return $null } + Mock Write-Host { return $null } +} + +Describe "MSP-Ultra-Debloat.ps1" { + It "should remove Xbox AppX packages" { + # Simulate the debloat script's AppX removal logic + $xboxPackages = Get-AppxPackage *xbox* + $xboxPackages | ForEach-Object { Remove-AppxPackage $_ -ErrorAction SilentlyContinue } + + Should -Invoke Get-AppxPackage -Times 1 -Exactly + Should -Invoke Remove-AppxPackage -Times 0 -Exactly # No packages to remove in mock + } + + It "should enable Print Spooler service" { + Set-Service spooler -StartupType Automatic + Start-Service spooler + + Should -Invoke Set-Service -Times 1 -Exactly + Should -Invoke Start-Service -Times 1 -Exactly + } + + It "should set High Performance power scheme" { + powercfg -setactive SCHEME_MIN + + Should -Invoke powercfg -Times 1 -Exactly + } +} + +Describe "install.ps1" { + It "should download debloat script from GitHub" { + Mock Invoke-WebRequest { return $null } + Mock powershell { return $null } + + $scriptURL = "https://raw.githubusercontent.com/OneByJorah/MSPEngine/main/debloat/MSP-Ultra-Debloat.ps1" + $temp = "$env:TEMP\debloat.ps1" + + Invoke-WebRequest $scriptURL -OutFile $temp + powershell -ExecutionPolicy Bypass -File $temp + + Should -Invoke Invoke-WebRequest -Times 1 -Exactly + Should -Invoke powershell -Times 1 -Exactly + } +}