winutil/KnownIssues.md
MyDrift b47036630c
Move Launch Issues from ReadMe to Known Issues (#2222)
* remove launching issues from ReadME

* Add Launch Issues to Known Issues

* Relayout some stuff

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2024-06-29 08:08:23 -05:00

3.0 KiB

Known Issues and Fixes

Launch Issues:

  • Windows Security (formerly Defender) and other anti-virus software are known to block the script. The script gets flagged due to the fact that it requires administrator privileges & makes drastic system changes.

    • If possible: Allow script in Anti-Virus software settings.
  • If you are having TLS 1.2 issues, or are having trouble resolving christitus.com/win then run with the following command:

[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12;iex(New-Object Net.WebClient).DownloadString('https://github.com/ChrisTitusTech/winutil/releases/latest/download/winutil.ps1')

If you are still having issues try using a VPN, or changing your DNS provider to:

1.1.1.1 1.0.0.1 or 8.8.8.8 8.8.4.4
  • Script doesn't run/PowerShell crashes:
    1. Press Windows Key+X and select 'PowerShell (Admin)' (Windows 10) or 'Windows Terminal (Admin)' (Windows 11)
    2. Run:
    Set-ExecutionPolicy Unrestricted -Scope Process -Force
    
    1. Run:
    irm christitus.com/win | iex
    

Other Issues:

  • Windows taking longer to shut down:
    • #69 Turn on fast startup: Press Windows key + R, then type:
    control /name Microsoft.PowerOptions /page pageGlobalSettings
    
    • If that doesn't work, Disable Hibernation: Press Windows Key+X and select 'PowerShell (Admin)' (Windows 10) or 'Windows Terminal (Admin)' (Windows 11) and enter:
    powercfg /H off
    
  • #69 95 #232 Windows Search does not work: Enable Background Apps
  • #198 Xbox Game Bar Activation Broken: Set the Xbox Accessory Management Service to Automatic
Get-Service -Name "XboxGipSvc" | Set-Service -StartupType Automatic
  • Winget requires interaction on first run: Manually type 'y' and 'enter' into the PowerShell console to continue

  • (Windows 11) Quick Settings no longer works: Launch the Script and click 'Enable Action Center'

  • Explorer no longer launches: Go to Control Panel, File Explorer Options, Change the 'Open File Explorer to' option to 'This PC'.

  • Script doesn't run/PowerShell crashes:

    1. Press Windows Key+X and select 'PowerShell (Admin)' (Windows 10) or 'Windows Terminal (Admin)' (Windows 11)
    2. Run:
    Set-ExecutionPolicy Unrestricted -Scope Process -Force
    
    1. Run:
    irm christitus.com/win | iex