#Requires -RunAsAdministrator [CmdletBinding(SupportsShouldProcess)] param ( [Parameter(ValueFromPipeline = $true)][switch]$RunDefaults, [Parameter(ValueFromPipeline = $true)][switch]$RunWin11Defaults, [Parameter(ValueFromPipeline = $true)][switch]$RemoveApps, [Parameter(ValueFromPipeline = $true)][switch]$RemoveGamingApps, [Parameter(ValueFromPipeline = $true)][switch]$DisableTelemetry, [Parameter(ValueFromPipeline = $true)][switch]$DisableBingSearches, [Parameter(ValueFromPipeline = $true)][switch]$DisableBing, [Parameter(ValueFromPipeline = $true)][switch]$DisableLockscreenTips, [Parameter(ValueFromPipeline = $true)][switch]$DisableWindowsSuggestions, [Parameter(ValueFromPipeline = $true)][switch]$DisableSuggestions, [Parameter(ValueFromPipeline = $true)][switch]$ShowHiddenFolders, [Parameter(ValueFromPipeline = $true)][switch]$ShowKnownFileExt, [Parameter(ValueFromPipeline = $true)][switch]$TaskbarAlignLeft, [Parameter(ValueFromPipeline = $true)][switch]$HideSearchTb, [Parameter(ValueFromPipeline = $true)][switch]$ShowSearchIconTb, [Parameter(ValueFromPipeline = $true)][switch]$ShowSearchLabelTb, [Parameter(ValueFromPipeline = $true)][switch]$ShowSearchBoxTb, [Parameter(ValueFromPipeline = $true)][switch]$HideTaskview, [Parameter(ValueFromPipeline = $true)][switch]$DisableCopilot, [Parameter(ValueFromPipeline = $true)][switch]$DisableWidgets, [Parameter(ValueFromPipeline = $true)][switch]$HideWidgets, [Parameter(ValueFromPipeline = $true)][switch]$DisableChat, [Parameter(ValueFromPipeline = $true)][switch]$HideChat, [Parameter(ValueFromPipeline = $true)][switch]$ClearStart, [Parameter(ValueFromPipeline = $true)][switch]$DisableOnedrive, [Parameter(ValueFromPipeline = $true)][switch]$HideOnedrive, [Parameter(ValueFromPipeline = $true)][switch]$Disable3dObjects, [Parameter(ValueFromPipeline = $true)][switch]$Hide3dObjects, [Parameter(ValueFromPipeline = $true)][switch]$DisableMusic, [Parameter(ValueFromPipeline = $true)][switch]$HideMusic, [Parameter(ValueFromPipeline = $true)][switch]$DisableIncludeInLibrary, [Parameter(ValueFromPipeline = $true)][switch]$HideIncludeInLibrary, [Parameter(ValueFromPipeline = $true)][switch]$DisableGiveAccessTo, [Parameter(ValueFromPipeline = $true)][switch]$HideGiveAccessTo, [Parameter(ValueFromPipeline = $true)][switch]$DisableShare, [Parameter(ValueFromPipeline = $true)][switch]$HideShare ) # Reads list of apps from file and removes them for all user accounts and from the OS image. function RemoveApps { param( $appsFile, $message ) Write-Output $message # Get list of apps from file at the path provided, and remove them one by one Foreach ($app in (Get-Content -Path $appsFile | Where-Object { $_ -notmatch '^#.*' -and $_ -notmatch '^\s*$' } )) { # Remove any spaces before and after the Appname $app = $app.Trim() # Remove any comments from the Appname if (-Not ($app.IndexOf('#') -eq -1)) { $app = $app.Substring(0, $app.IndexOf('#')) } # Remove any remaining spaces from the Appname if (-Not ($app.IndexOf(' ') -eq -1)) { $app = $app.Substring(0, $app.IndexOf(' ')) } $appString = $app.Trim('*') Write-Output "Attempting to remove $appString..." # Remove installed app for all existing users Get-AppxPackage -Name $app -AllUsers | Remove-AppxPackage # Remove provisioned app from OS image, so the app won't be installed for any new users Get-AppxProvisionedPackage -Online | Where-Object { $_.PackageName -like $app } | ForEach-Object { Remove-ProvisionedAppxPackage -Online -AllUsers -PackageName $_.PackageName } } } # Import & execute regfile function RegImport { param ( $Message, $Path ) Write-Output $Message reg import $path } # Stop & Restart the windows explorer process function RestartExplorer { Write-Output "> Restarting windows explorer to apply all changes." Start-Sleep 0.5 taskkill /f /im explorer.exe Start-Process explorer.exe Write-Output "" } # Clear all pinned apps from the start menu. # Credit: https://lazyadmin.nl/win-11/customize-windows-11-start-menu-layout/ function ClearStartMenu { param( $message ) Write-Output $message # Path to start menu template $startmenuTemplate = "$PSScriptRoot/Start/start2.bin" # Get all user profile folders $usersStartMenu = get-childitem -path "C:\Users\*\AppData\Local\Packages\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\LocalState" # Copy Start menu to all users folders ForEach ($startmenu in $usersStartMenu) { $startmenuBinFile = $startmenu.Fullname + "\start2.bin" # Check if bin file exists if(Test-Path $startmenuBinFile) { Copy-Item -Path $startmenuTemplate -Destination $startmenu -Force $cpyMsg = "Replaced start menu for user " + $startmenu.Fullname.Split("\")[2] Write-Output $cpyMsg } else { # Bin file doesn't exist, indicating the user is not running the correct version of windows. Exit function Write-Output "Error: Start menu file not found. Please make sure you're running Windows 11 22H2 or later" return } } # Also apply start menu template to the default profile # Path to default profile $defaultProfile = "C:\Users\default\AppData\Local\Packages\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\LocalState" # Create folder if it doesn't exist if(-not(Test-Path $defaultProfile)) { new-item $defaultProfile -ItemType Directory -Force | Out-Null Write-Output "Created LocalState folder for default user" } # Copy template to default profile Copy-Item -Path $startmenuTemplate -Destination $defaultProfile -Force Write-Output "Copied start menu template to default user folder" } # Change script execution based on provided parameters or user input if ((-NOT $PSBoundParameters.Count) -or $RunDefaults -or $RunWin11Defaults -or (($PSBoundParameters.Count -eq 1) -and ($PSBoundParameters.ContainsKey('WhatIf') -or $PSBoundParameters.ContainsKey('Confirm') -or $PSBoundParameters.ContainsKey('Verbose')))) { if ($RunDefaults -or $RunWin11Defaults) { $Mode = '1'; } else { # Show menu and wait for user input, loops until valid input is provided Do { Clear-Host # Get & print script menu from file Foreach ($line in (Get-Content -Path "$PSScriptRoot/Menus/Menu.txt" )) { Write-Output $line } $Mode = Read-Host "Please select an option (1/2/0)" # Show information based on user input if ($Mode -eq '0') { Clear-Host # Get & print script information from file Foreach ($line in (Get-Content -Path "$PSScriptRoot/Menus/Info.txt" )) { Write-Output $line } Write-Output "Press any key to go back..." $null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown") } elseif ($Mode -eq '1') { Clear-Host # Get & print default settings info from file Foreach ($line in (Get-Content -Path "$PSScriptRoot/Menus/DefaultSettings.txt" )) { Write-Output $line } Write-Output "Press any key to start..." $null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown") } } while ($Mode -ne '1' -and $Mode -ne '2') } # Add execution parameters based on the mode switch ($Mode) { # Default mode, no user input required, all (relevant) options are added '1' { Clear-Host Write-Output "-------------------------------------------------------------------------------------------" Write-Output " Win11Debloat Script - Default Configuration" Write-Output "-------------------------------------------------------------------------------------------" $PSBoundParameters.Add('RemoveApps', $RemoveApps) $PSBoundParameters.Add('DisableTelemetry', $DisableTelemetry) $PSBoundParameters.Add('DisableBing', $DisableBing) $PSBoundParameters.Add('DisableLockscreenTips', $DisableLockscreenTips) $PSBoundParameters.Add('DisableSuggestions', $DisableSuggestions) $PSBoundParameters.Add('ShowKnownFileExt', $ShowKnownFileExt) $PSBoundParameters.Add('DisableWidgets', $DisableWidgets) $PSBoundParameters.Add('HideChat', $HideChat) # Only add this option for windows 10 users if (get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 10%'"){ $PSBoundParameters.Add('Hide3dObjects', $Hide3dObjects) } } # Custom mode, add options based on user input '2' { Clear-Host Write-Output "-------------------------------------------------------------------------------------------" Write-Output " Win11Debloat Script - Custom Configuration" Write-Output "-------------------------------------------------------------------------------------------" if ($( Read-Host -Prompt "Remove pre-installed bloatware apps? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('RemoveApps', $RemoveApps) Write-Output "" if ($( Read-Host -Prompt " Also remove gaming-related apps such as the Xbox App and Xbox Gamebar? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('RemoveGamingApps', $RemoveGamingApps) } } Write-Output "" if ($( Read-Host -Prompt "Disable telemetry, diagnostic data, app-launch tracking and targeted ads? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableTelemetry', $DisableTelemetry) } Write-Output "" if ($( Read-Host -Prompt "Disable bing search, bing AI & cortana in windows search? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableBing', $DisableBing) } Write-Output "" if ($( Read-Host -Prompt "Disable tips, tricks, suggestions and ads in start, settings, notifications, windows explorer and on the lockscreen? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableSuggestions', $DisableSuggestions) $PSBoundParameters.Add('DisableLockscreenTips', $DisableLockscreenTips) } Write-Output "" # Only show this option for windows 11 users if (get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 11%'"){ if ($( Read-Host -Prompt "Remove all pinned apps from the start menu? This applies to all existing and new users (y/n)" ) -eq 'y') { $PSBoundParameters.Add('ClearStart', $ClearStart) } } Write-Output "" if ($( Read-Host -Prompt "Do you want to make any changes to the taskbar and related services? (y/n)" ) -eq 'y') { # Only show these specific options for windows 11 users if (get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 11%'"){ Write-Output "" if ($( Read-Host -Prompt " Align taskbar buttons to left side? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('TaskbarAlignLeft', $TaskbarAlignLeft) } # Show options for search icon on taskbar, only continue on valid input Do { Write-Output "" Write-Output " Options:" Write-Output " (0) No change" Write-Output " (1) Hide search icon from the taskbar" Write-Output " (2) Show search icon on the taskbar" Write-Output " (3) Show search icon with label on the taskbar" Write-Output " (4) Show search box on the taskbar" $TbSearchInput = Read-Host " Hide or change the search icon on the taskbar? (0/1/2/3/4)" } while ($TbSearchInput -ne 'n' -and $TbSearchInput -ne '0' -and $TbSearchInput -ne '1' -and $TbSearchInput -ne '2' -and $TbSearchInput -ne '3' -and $TbSearchInput -ne '4') # Select correct taskbar search option based on user input switch ($TbSearchInput) { '1' { $PSBoundParameters.Add('HideSearchTb', $HideSearchTb) } '2' { $PSBoundParameters.Add('ShowSearchIconTb', $ShowSearchIconTb) } '3' { $PSBoundParameters.Add('ShowSearchLabelTb', $ShowSearchLabelTb) } '4' { $PSBoundParameters.Add('ShowSearchBoxTb', $ShowSearchBoxTb) } } Write-Output "" if ($( Read-Host -Prompt " Hide the taskview button from the taskbar? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideTaskview', $HideTaskview) } Write-Output "" if ($( Read-Host -Prompt " Disable Windows copilot and hide it from the taskbar? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableCopilot', $DisableCopilot) } } Write-Output "" if ($( Read-Host -Prompt " Disable the widgets service and hide the widget (news and interests) icon from the taskbar? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableWidgets', $DisableWidgets) } Write-Output "" if ($( Read-Host -Prompt " Hide the chat (meet now) icon from the taskbar? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideChat', $HideChat) } } Write-Output "" if ($( Read-Host -Prompt "Do you want to make any changes to windows explorer? (y/n)" ) -eq 'y') { Write-Output "" if ($( Read-Host -Prompt " Show hidden files, folders and drives? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('ShowHiddenFolders', $ShowHiddenFolders) } Write-Output "" if ($( Read-Host -Prompt " Show file extensions for known file types? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('ShowKnownFileExt', $ShowKnownFileExt) } } # Only show option for disabling these specific folders for windows 10 users if (get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 10%'"){ Write-Output "" if ($( Read-Host -Prompt "Do you want to hide any folders from the windows explorer sidepanel? (y/n)" ) -eq 'y') { Write-Output "" if ($( Read-Host -Prompt " Hide the onedrive folder in windows explorer? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideOnedrive', $HideOnedrive) } Write-Output "" if ($( Read-Host -Prompt " Hide the 3D objects folder in windows explorer? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('Hide3dObjects', $Hide3dObjects) } Write-Output "" if ($( Read-Host -Prompt " Hide the music folder in windows explorer? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideMusic', $HideMusic) } } } # Only show option for disabling context menu items for windows 10 users if (get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 10%'"){ Write-Output "" if ($( Read-Host -Prompt "Do you want to disable any context menu options? (y/n)" ) -eq 'y') { Write-Output "" if ($( Read-Host -Prompt " Hide the 'Include in library' option in the context menu? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideIncludeInLibrary', $HideIncludeInLibrary) } Write-Output "" if ($( Read-Host -Prompt " Hide the 'Give access to' option in the context menu? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideGiveAccessTo', $HideGiveAccessTo) } Write-Output "" if ($( Read-Host -Prompt " Hide the 'Share' option in the context menu? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideShare', $HideShare) } } } Write-Output "" Write-Output "" Write-Output "" Write-Output "Press any key to confirm your choices and execute the script..." $null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown") Clear-Host Write-Output "-------------------------------------------------------------------------------------------" Write-Output " Win11Debloat Script - Custom Configuration" Write-Output "-------------------------------------------------------------------------------------------" } } } else { Clear-Host Write-Output "-------------------------------------------------------------------------------------------" Write-Output " Win11Debloat Script - Custom Configuration" Write-Output "-------------------------------------------------------------------------------------------" } # Execute all selected/provided parameters switch ($PSBoundParameters.Keys) { 'RemoveApps' { RemoveApps "$PSScriptRoot/Appslist.txt" "> Removing pre-installed windows apps..." Write-Output "" continue } 'RemoveGamingApps' { RemoveApps "$PSScriptRoot/GamingAppslist.txt" "> Removing gaming-related windows apps..." Write-Output "" continue } 'DisableTelemetry' { RegImport "> Disabling telemetry, diagnostic data, app-launch tracking and targeted ads..." $PSScriptRoot\Regfiles\Disable_Telemetry.reg Write-Output "" continue } {$_ -in "DisableBingSearches", "DisableBing"} { RegImport "> Disabling bing search, bing AI & cortana in windows search..." $PSScriptRoot\Regfiles\Disable_Bing_Cortana_In_Search.reg Write-Output "" continue } 'DisableLockscreenTips' { RegImport "> Disabling tips & tricks on the lockscreen..." $PSScriptRoot\Regfiles\Disable_Lockscreen_Tips.reg Write-Output "" continue } {$_ -in "DisableSuggestions", "DisableWindowsSuggestions"} { RegImport "> Disabling tips, tricks, suggestions and ads in start, settings, notifications and windows explorer..." $PSScriptRoot\Regfiles\Disable_Windows_Suggestions.reg Write-Output "" continue } 'TaskbarAlignLeft' { RegImport "> Aligning taskbar buttons to the left..." $PSScriptRoot\Regfiles\Align_Taskbar_Left.reg Write-Output "" continue } 'HideSearchTb' { RegImport "> Hiding the search icon from the taskbar..." $PSScriptRoot\Regfiles\Hide_Search_Taskbar.reg Write-Output "" continue } 'ShowSearchIconTb' { RegImport "> Changing taskbar search to icon only..." $PSScriptRoot\Regfiles\Show_Search_Icon.reg Write-Output "" continue } 'ShowSearchLabelTb' { RegImport "> Changing taskbar search to icon with label..." $PSScriptRoot\Regfiles\Show_Search_Icon_And_Label.reg Write-Output "" continue } 'ShowSearchBoxTb' { RegImport "> Changing taskbar search to search box..." $PSScriptRoot\Regfiles\Show_Search_Box.reg Write-Output "" continue } 'HideTaskview' { RegImport "> Hiding the taskview button from the taskbar..." $PSScriptRoot\Regfiles\Hide_Taskview_Taskbar.reg Write-Output "" continue } 'DisableCopilot' { RegImport "> Disabling Windows copilot..." $PSScriptRoot\Regfiles\Disable_Copilot.reg Write-Output "" continue } {$_ -in "HideWidgets", "DisableWidgets"} { RegImport "> Disabling the widget service and hiding the widget icon from the taskbar..." $PSScriptRoot\Regfiles\Disable_Widgets_Taskbar.reg Write-Output "" continue } {$_ -in "HideChat", "DisableChat"} { RegImport "> Hiding the chat icon from the taskbar..." $PSScriptRoot\Regfiles\Disable_Chat_Taskbar.reg Write-Output "" continue } 'ClearStart' { ClearStartMenu "> Removing all pinned apps from the start menu..." Write-Output "" continue } 'ShowHiddenFolders' { RegImport "> Unhiding hidden files, folders and drives..." $PSScriptRoot\Regfiles\Show_Hidden_Folders.reg Write-Output "" continue } 'ShowKnownFileExt' { RegImport "> Enabling file extensions for known file types..." $PSScriptRoot\Regfiles\Show_Extensions_For_Known_File_Types.reg Write-Output "" continue } {$_ -in "HideOnedrive", "DisableOnedrive"} { RegImport "> Hiding the onedrive folder in windows explorer..." $PSScriptRoot\Regfiles\Hide_Onedrive_Folder.reg Write-Output "" continue } {$_ -in "Hide3dObjects", "Disable3dObjects"} { RegImport "> Hiding the 3D objects folder in windows explorer..." $PSScriptRoot\Regfiles\Hide_3D_Objects_Folder.reg Write-Output "" continue } {$_ -in "HideMusic", "DisableMusic"} { RegImport "> Hiding the music folder in windows explorer..." $PSScriptRoot\Regfiles\Hide_Music_folder.reg Write-Output "" continue } {$_ -in "HideIncludeInLibrary", "DisableIncludeInLibrary"} { RegImport "> Hiding 'Include in library' in the context menu..." $PSScriptRoot\Regfiles\Disable_Include_in_library_from_context_menu.reg Write-Output "" continue } {$_ -in "HideGiveAccessTo", "DisableGiveAccessTo"} { RegImport "> Hiding 'Give access to' in the context menu..." $PSScriptRoot\Regfiles\Disable_Give_access_to_context_menu.reg Write-Output "" continue } {$_ -in "HideShare", "DisableShare"} { RegImport "> Hiding 'Share' in the context menu..." $PSScriptRoot\Regfiles\Disable_Share_from_context_menu.reg Write-Output "" continue } } RestartExplorer Write-Output "" Write-Output "" Write-Output "Script completed!" Write-Output "" Write-Output "" Write-Output "Press any key to continue..." $null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")