#Requires -RunAsAdministrator [CmdletBinding(SupportsShouldProcess)] param ( [Parameter(ValueFromPipeline = $true)][switch]$Silent, [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]$HideDupliDrive, [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 } } Write-Output "" } # Import & execute regfile function RegImport { param ( $Message, $Path ) Write-Output $Message reg import $path Write-Output "" } # 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" } $SPParams = 'WhatIf', 'Confirm', 'Verbose', 'Silent' $SPParamCount = 0 foreach ($param in $SPParams) { if ($PSBoundParameters.ContainsKey($param)) { $SPParamCount++ } } # Change script execution based on provided parameters or user input if ((-not $PSBoundParameters.Count) -or $RunDefaults -or $RunWin11Defaults -or ($SPParamCount -eq $PSBoundParameters.Count)) { 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, Suppress user prompt if Silent parameter was passed 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 (-not $Silent -and ($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 "-------------------------------------------------------------------------------------------" # Add default parameters if they don't already exist $DefaultParameterNames = 'RemoveApps','DisableTelemetry','DisableBing','DisableLockscreenTips','DisableSuggestions','ShowKnownFileExt','DisableWidgets','HideChat','DisableCopilot' foreach ($ParameterName in $DefaultParameterNames) { if(-not $PSBoundParameters.ContainsKey($ParameterName)){ $PSBoundParameters.Add($ParameterName, $true) } } # Only add this option for windows 10 users, if it doesn't already exist if ((get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 10%'") -and (-not $PSBoundParameters.ContainsKey('Hide3dObjects'))) { $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, explorer and lockscreen? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableSuggestions', $DisableSuggestions) $PSBoundParameters.Add('DisableLockscreenTips', $DisableLockscreenTips) } Write-Output "" # Only show these options for windows 11 users if (get-ciminstance -query "select caption from win32_operatingsystem where caption like '%Windows 11%'"){ if ($( Read-Host -Prompt "Disable Windows Copilot? This applies to all users (y/n)" ) -eq 'y') { $PSBoundParameters.Add('DisableCopilot', $DisableCopilot) } Write-Output "" if ($( Read-Host -Prompt "Remove all pinned apps from the start menu? This applies to all existing and new users and can't be reverted (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 the widgets service and hide the 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) } Write-Output "" if ($( Read-Host -Prompt " Hide duplicate removable drive entries from the windows explorer sidepane so they only show under 'This PC'? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideDupliDrive', $HideDupliDrive) } # 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 sidepane? (y/n)" ) -eq 'y') { Write-Output "" if ($( Read-Host -Prompt " Hide the onedrive folder from the windows explorer sidepane? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('HideOnedrive', $HideOnedrive) } Write-Output "" if ($( Read-Host -Prompt " Hide the 3D objects folder from the windows explorer sidepane? (y/n)" ) -eq 'y') { $PSBoundParameters.Add('Hide3dObjects', $Hide3dObjects) } Write-Output "" if ($( Read-Host -Prompt " Hide the music folder from the windows explorer sidepane? (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) } } } # Suppress prompt if Silent parameter was passed if (-not $Silent) { 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 "-------------------------------------------------------------------------------------------" } if ($SPParamCount -eq $PSBoundParameters.Keys.Count) { Write-Output "The script completed without making any changes." # Suppress prompt if Silent parameter was passed if(-not $Silent) { Write-Output "" Write-Output "Press any key to exit..." $null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown") } } else { # Execute all selected/provided parameters switch ($PSBoundParameters.Keys) { 'RemoveApps' { RemoveApps "$PSScriptRoot/Appslist.txt" "> Removing pre-installed windows apps..." continue } 'RemoveGamingApps' { RemoveApps "$PSScriptRoot/GamingAppslist.txt" "> Removing gaming-related windows apps..." continue } 'DisableTelemetry' { RegImport "> Disabling telemetry, diagnostic data, app-launch tracking and targeted ads..." $PSScriptRoot\Regfiles\Disable_Telemetry.reg continue } {$_ -in "DisableBingSearches", "DisableBing"} { RegImport "> Disabling bing search, bing AI & cortana in windows search..." $PSScriptRoot\Regfiles\Disable_Bing_Cortana_In_Search.reg continue } 'DisableLockscreenTips' { RegImport "> Disabling tips & tricks on the lockscreen..." $PSScriptRoot\Regfiles\Disable_Lockscreen_Tips.reg continue } {$_ -in "DisableSuggestions", "DisableWindowsSuggestions"} { RegImport "> Disabling tips, tricks, suggestions and ads across Windows..." $PSScriptRoot\Regfiles\Disable_Windows_Suggestions.reg continue } 'TaskbarAlignLeft' { RegImport "> Aligning taskbar buttons to the left..." $PSScriptRoot\Regfiles\Align_Taskbar_Left.reg continue } 'HideSearchTb' { RegImport "> Hiding the search icon from the taskbar..." $PSScriptRoot\Regfiles\Hide_Search_Taskbar.reg continue } 'ShowSearchIconTb' { RegImport "> Changing taskbar search to icon only..." $PSScriptRoot\Regfiles\Show_Search_Icon.reg continue } 'ShowSearchLabelTb' { RegImport "> Changing taskbar search to icon with label..." $PSScriptRoot\Regfiles\Show_Search_Icon_And_Label.reg continue } 'ShowSearchBoxTb' { RegImport "> Changing taskbar search to search box..." $PSScriptRoot\Regfiles\Show_Search_Box.reg continue } 'HideTaskview' { RegImport "> Hiding the taskview button from the taskbar..." $PSScriptRoot\Regfiles\Hide_Taskview_Taskbar.reg continue } 'DisableCopilot' { RegImport "> Disabling Windows copilot..." $PSScriptRoot\Regfiles\Disable_Copilot.reg continue } {$_ -in "HideWidgets", "DisableWidgets"} { RegImport "> Disabling the widget service and hiding the widget icon from the taskbar..." $PSScriptRoot\Regfiles\Disable_Widgets_Taskbar.reg continue } {$_ -in "HideChat", "DisableChat"} { RegImport "> Hiding the chat icon from the taskbar..." $PSScriptRoot\Regfiles\Disable_Chat_Taskbar.reg continue } 'ClearStart' { ClearStartMenu "> Removing all pinned apps from the start menu..." continue } 'ShowHiddenFolders' { RegImport "> Unhiding hidden files, folders and drives..." $PSScriptRoot\Regfiles\Show_Hidden_Folders.reg continue } 'ShowKnownFileExt' { RegImport "> Enabling file extensions for known file types..." $PSScriptRoot\Regfiles\Show_Extensions_For_Known_File_Types.reg continue } 'HideDupliDrive' { RegImport "> Hiding duplicate removable drive entries from the windows explorer navigation pane..." $PSScriptRoot\Regfiles\Hide_duplicate_removable_drives_from_navigation_pane_of_File_Explorer.reg continue } {$_ -in "HideOnedrive", "DisableOnedrive"} { RegImport "> Hiding the onedrive folder from the windows explorer navigation pane..." $PSScriptRoot\Regfiles\Hide_Onedrive_Folder.reg continue } {$_ -in "Hide3dObjects", "Disable3dObjects"} { RegImport "> Hiding the 3D objects folder from the windows explorer navigation pane..." $PSScriptRoot\Regfiles\Hide_3D_Objects_Folder.reg continue } {$_ -in "HideMusic", "DisableMusic"} { RegImport "> Hiding the music folder from the windows explorer navigation pane..." $PSScriptRoot\Regfiles\Hide_Music_folder.reg continue } {$_ -in "HideIncludeInLibrary", "DisableIncludeInLibrary"} { RegImport "> Hiding 'Include in library' in the context menu..." $PSScriptRoot\Regfiles\Disable_Include_in_library_from_context_menu.reg continue } {$_ -in "HideGiveAccessTo", "DisableGiveAccessTo"} { RegImport "> Hiding 'Give access to' in the context menu..." $PSScriptRoot\Regfiles\Disable_Give_access_to_context_menu.reg continue } {$_ -in "HideShare", "DisableShare"} { RegImport "> Hiding 'Share' in the context menu..." $PSScriptRoot\Regfiles\Disable_Share_from_context_menu.reg continue } } RestartExplorer Write-Output "" Write-Output "" Write-Output "Script completed successfully!" # Suppress prompt if Silent parameter was passed if(-not $Silent) { Write-Output "" Write-Output "Press any key to exit..." $null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown") } }