winutil/KnownIssues/index.html

13 lines
36 KiB
HTML
Raw Normal View History

<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><link href=../devdocs/ rel=prev><link href=../faq/ rel=next><link rel=icon href=../assets/favicon.png><meta name=generator content="mkdocs-1.6.0, mkdocs-material-9.5.31"><title>Known Issues - WinUtil Documentation</title><link rel=stylesheet href=../assets/stylesheets/main.3cba04c6.min.css><link rel=stylesheet href=../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#launch-issues class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=.. title="WinUtil Documentation" class="md-header__button md-logo" aria-label="WinUtil Documentation" data-md-component=logo> <img src=../assets/favicon.png alt=logo> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> WinUtil Documentation </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Known Issues </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media=(prefers-color-scheme) data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=blue aria-label="Switch to dark mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_2 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=blue aria-label="Switch to light mode" type=radio name=__palette id=__palette_2> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3
</span></code></pre></div> <p>If you are seeing errors referencing TLS or security, you may be running an older version of Windows where TLS 1.2 is not the default security protocol used for network connections. The following commands will force .NET to use TLS 1.2, and download the script directly using .NET instead of PowerShell:</p> <div class="language-ps1 highlight"><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a><span class=no>[Net.ServicePointManager]</span><span class=p>::</span><span class=n>SecurityProtocol</span> <span class=p>=</span> <span class=no>[Net.SecurityProtocolType]</span><span class=p>::</span><span class=n>Tls12</span>
</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=nb>iex </span><span class=p>(</span><span class=nb>New-Object</span> <span class=n>Net</span><span class=p>.</span><span class=n>WebClient</span><span class=p>).</span><span class=n>DownloadString</span><span class=p>(</span><span class=s1>&#39;https://github.com/ChrisTitusTech/winutil/releases/latest/download/winutil.ps1&#39;</span><span class=p>)</span>
</span></code></pre></div> <p>If it still isn't working and you live in India, it might be due to India blocking GitHub's content domain and preventing downloads. See more on <a href=https://timesofindia.indiatimes.com/gadgets-news/github-content-domain-blocked-for-these-indian-users-reports/articleshow/96687992.cms>Times of India</a>.</p> <p>If you are still having issues, try using a <strong>VPN</strong>, or changing your <strong>DNS provider</strong> to one of following two providers:</p> <table> <thead> <tr> <th style="text-align: center;">Provider</th> <th style="text-align: center;">Primary DNS</th> <th style="text-align: center;">Secondary DNS</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">Cloudflare</td> <td style="text-align: center;"><code>1.1.1.1</code></td> <td style="text-align: center;"><code>1.0.0.1</code></td> </tr> <tr> <td style="text-align: center;">Google</td> <td style="text-align: center;"><code>8.8.8.8</code></td> <td style="text-align: center;"><code>8.8.4.4</code></td> </tr> </tbody> </table> <h3 id=script-blocked-by-execution-policy>Script blocked by Execution Policy<a class=headerlink href=#script-blocked-by-execution-policy title="Permanent link">&para;</a></h3> <ol> <li>Ensure you are running PowerShell as admin: Press <code>Windows Key</code>+<code>X</code> and select <em>PowerShell (Admin)</em> in Windows 10, or <code>Windows Terminal (Admin)</code> in Windows 11.</li> <li>In the PowerShell window, type this to allow unsigned code to execute and run the installation script: <div class="language-ps1 highlight"><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a><span class=nb>Set-ExecutionPolicy</span> <span class=n>Unrestricted</span> <span class=n>-Scope</span> <span class=k>Process</span> <span class=n>-Force</span>
</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=nb>irm </span><span class=n>christitus</span><span class=p>.</span><span class=n>com</span><span class=p>/</span><span class=n>win</span> <span class=p>|</span> <span class=nb>iex</span>
</span></code></pre></div></li> </ol> <h2 id=runtime-issues>Runtime Issues<a class=headerlink href=#runtime-issues title="Permanent link">&para;</a></h2> <h3 id=winget-configuration>WinGet configuration<a class=headerlink href=#winget-configuration title="Permanent link">&para;</a></h3> <p>If you have not installed anything using PowerShell before, you may be prompted to configure WinGet. This requires user interaction on first run. You will need to manually type <code>y</code> into the PowerShell console and press enter to continue. Once you do it the first time, you will not be prompted again.</p> <h3 id=microwin-error-0x80041031>MicroWin: Error <code>0x80041031</code><a class=headerlink href=#microwin-error-0x80041031 title="Permanent link">&para;</a></h3> <p>This error code typically indicates an issue related to Windows Management Instrumentation (WMI). Here are a few steps you can try to resolve the issue:</p> <ol> <li> <p><strong>Reboot Your Computer:</strong></p> <p>Sometimes, a simple reboot can resolve temporary issues. Restart your computer and try mounting the ISO again.</p> </li> <li> <p><strong>Check for System Corruption:</strong></p> <p>Run the System File Checker (SFC) utility to scan and repair system files that may be corrupted. <div class="language-powershell highlight"><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a><span class=n>sfc</span> <span class=p>/</span><span class=n>scannow</span>
</span></code></pre></div></p> </li> <li> <p><strong>Update Your System:</strong></p> <p>Make sure your operating system is up-to-date. Check for Windows updates and install any pending updates.</p> </li> <li> <p><strong>Check WMI Service:</strong></p> <p>Ensure that the Windows Management Instrumentation (WMI) service is running. You can do this through the Services application: - Press <code>Win</code>+<code>R</code> to open the Run dialog. - Type <code>services.msc</code> and press Enter. - Locate <em>Windows Management Instrumentation</em> in the list. - Make sure to set its status to "Running" and the startup type to "Automatic".</p> </li> <li> <p><strong>Check for Security Software Interference:</strong></p> <p>Security software can sometimes interfere with WMI operations. Temporarily disable your anti-virus or security software and check if the issue persists. WMI is a common attack/infection vector, so many anti-virus programs will limit its usage.</p> </li> <li> <p><strong>Event Viewer:</strong></p> <p>Check the Event Viewer for more detailed error information. Look for entries related to the <code>80041031</code> error and check if there are any additional details that can help identify the cause.</p> <ul> <li>Press <code>Win</code>+<code>X</code> and select <em>Event Viewer</em>.</li> <li>Navigate to <em>Windows Logs</em> &gt; <em>Application</em> or <em>System</em>.</li> <li>Look for entries with the source related to WMI or the application use to mount the ISO.</li> </ul> </li> <li> <p><strong>ISO File Integrity:</strong></p> <p>Ensure that the ISO file you are trying to mount is uncorrupted. Try mounting a different ISO file to see if the issue persists.</p> </li> </ol> <p>If the problem persists after trying these steps, additional troubleshooting is required. Consider seeking assistance from Microsoft support or community forums for more specific guidance based on your system configuration and the software you use to mount the ISO.</p> <h2 id=windows-issues>Windows Issues<a class=headerlink href=#windows-issues title="Permanent link">&para;</a></h2> <h3 id=windows-takes-longer-to-shut-down>Windows takes longer to shut down<a class=headerlink href=#windows-takes-longer-to-shut-down title="Permanent link">&para;</a></h3> <p>This could be for a number of reasons: - Turn on fast startup: Press <code>Windows key</code>+<code>R</code>, then type: <div class="language-bat highlight"><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a>control /name Microsoft.PowerOptions /page pageGlobalSettings
</span></code></pre></div> - If that doesn't work, disable Hibernation: - Press <code>Windows Key</code>+<code>X</code> and select <em>PowerShell (Admin)</em> in Windows 10, or <code>Windows Terminal (Admin)</code> in Windows 11. - In the PowerShell window, type: <div class="language-bat highlight"><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a>powercfg /H off
</span></code></pre></div> Related issue: <a href=https://github.com/ChrisTitusTech/winutil/issues/69>#69</a></p> <h3 id=windows-search-does-not-work>Windows Search does not work<a class=headerlink href=#windows-search-does-not-work title="Permanent link">&para;</a></h3> <p>Enable Background Apps. Related issues: <a href=https://github.com/ChrisTitusTech/winutil/issues/69>#69</a> <a href=https://github.com/ChrisTitusTech/winutil/issues/95>95</a> <a href=https://github.com/ChrisTitusTech/winutil/issues/232>#232</a></p> <h3 id=xbox-game-bar-activation-broken>Xbox Game Bar Activation Broken<a class=headerlink href=#xbox-game-bar-activation-broken title="Permanent link">&para;</a></h3> <p>Set the Xbox Accessory Management Service to Automatic:</p> <div class="language-ps1 highlight"><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=nb>Get-Service</span> <span class=n>-Name</span> <span class=s2>&quot;XboxGipSvc&quot;</span> <span class=p>|</span> <span class=nb>Set-Service</span> <span class=n>-StartupType</span> <span class=n>Automatic</span>
</span></code></pre></div> <p>Related issue: <a href=https://github.com/ChrisTitusTech/winutil/issues/198>#198</a></p> <h3 id=windows-11-quick-settings-no-longer-works>Windows 11: Quick Settings no longer works<a class=headerlink href=#windows-11-quick-settings-no-longer-works title="Permanent link">&para;</a></h3> <p>Launch the Script and click <em>Enable Action Center</em>.</p> <h3 id=explorer-file-browser-no-longer-launches>Explorer (file browser) no longer launches<a class=headerlink href=#explorer-file-browser-no-longer-launches title="Permanent link">&para;</a></h3> <ul> <li>Press <code>Windows key</code>+<code>R</code> then type: <div class="language-bat highlight"><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a>control /name Microsoft.FolderOptions
</span></code></pre></div></li> <li>Change the <em>Open File Explorer to</em> option to <em>This PC</em>.</li> </ul> <h3 id=battery-drains-too-fast>Battery drains too fast<a class=headerlink href=#battery-drains-too-fast title="Permanent link">&para;</a></h3> <p>If you're using a laptop or tablet and find your battery drains too fast, please try the below troubleshooting steps, and report the results back to the Winutil community.</p> <ol> <li> <p><strong>Check Battery Health:</strong></p> <ul> <li>Press <code>Windows Key</code>+<code>X</code> and select <em>PowerShell (Admin)</em> in Windows 10, or <code>Windows Terminal (Admin)</code> in Windows 11.</li> <li>Run the following command to generate a battery report: <div class="language-powershell highlight"><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a><span class=n>powercfg</span> <span class=p>/</span><span class=n>batteryreport</span> <span class=p>/</span><span class=n>output</span> <span class=s2>&quot;C:\battery_report.html&quot;</span>
</span></code></pre></div></li> <li>Open the generated HTML report to review information about battery health and usage. A battery with poor health may hold less charge, discharge faster, or cause other issues.</li> </ul> </li> <li> <p><strong>Review Power Settings:</strong></p> <ul> <li>Open the Settings app, and go to <em>System</em> &gt; <em>Power &amp; sleep</em>.</li> <li>Adjust power plan settings based on your preferences and usage patterns.</li> <li>Click on <em>Additional power settings</em> to access advanced power settings that may help.</li> </ul> </li> <li> <p><strong>Identify Power-Hungry Apps:</strong></p> <ul> <li>Right-click on the taskbar and select <em>Task Manager</em>.</li> <li>Navigate to the <em>Processes</em> tab to identify applications with high CPU or memory usage.</li> <li>Consider reconfiguring, closing, disabling, or uninstalling applications that use a lot of resources.</li> </ul> </li> <li> <p><strong>Update Drivers:</strong></p> <ul> <li>Visit your device manufacturer's website or use Windows Update to check for driver updates.</li> <li>Ensure graphics, chipset, and other essential drivers are up to date.</li> </ul> </li> <li> <p><strong>Check for Windows Updates:</strong></p> <ul> <li>Open the Settings app, and go to <em>Update &amp; Security</em> &gt; <em>Windows Update</em>.</li> <li>Check for and install any available updates for your operating system.</li> </ul> </li> <li> <p><strong>Reduce Screen Brightness:</strong></p> <ul> <li>Open the Settings app, and go to <em>System</em> &gt; <em>Display</em>.</li> <li>Adjust screen brightness based on your preferences and lighting conditions.</li> </ul> </li> <li> <p><strong>Enable Battery Saver:</strong></p> <ul> <li>Open the Settings app, and go to <em>System</em> &gt; <em>Battery</em>.</li> <li>Turn on <em>Battery saver</em> to limit background activity and conserve power.</li> </ul> </li> <li> <p><strong>Check Power Usage in Settings:</strong></p> <ul> <li>Open the Settings app, and go to <em>System</em> &gt; <em>Battery</em> &gt; <em>Battery usage by app</em>.</li> <li>Review the list of apps and their power usage. Disable or uninstall any you don't need.</li> </ul> </li> <li> <p><strong>Check Background Apps:</strong></p> <ul> <li>Open the Settings app, and go to <em>Privacy</em> &gt; <em>Background apps</em>.</li> <li>Disable or uninstall unnecessary apps running in the background.</li> </ul> </li> <li> <p><strong>Use <code>powercfg</code> for Analysis:</strong></p> <ul> <li>Press <code>Windows Key</code>+<code>X</code> and select <em>PowerShell (Admin)</em> in Windows 10, or <code>Windows Terminal (Admin)</code> in Windows 11.</li> <li>Run the following command to analyze energy usage and generate a report: <div class="language-powershell highlight"><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a><span class=n>powercfg</span> <span class=p>/</span><span class=n>energy</span> <span class=p>/</span><span class=n>output</span> <span class=s2>&quot;C:\energy_report.html&quot;</span>
</span></code></pre></div></li> <li>Open the generated HTML report to identify energy consumption patterns.</li> </ul> </li> <li> <p><strong>Review Event Logs:</strong></p> <ul> <li>Open Event Viewer by searching for it in the Start menu.</li> <li>Navigate to <em>Windows Logs</em> &gt; <em>System</em>.</li> <li>Look for events with the source <em>Power-Troubleshooter</em> to identify power-related events. These may highlight battery, input power, and other issues.</li> </ul> </li> <li> <p><strong>Check Wake-up Sources:</strong></p> <ul> <li>Press <code>Windows Key</code>+<code>X</code> and select <em>PowerShell (Admin)</em> in Windows 10, or <code>Windows Terminal (Admin)</code> in Windows 11.</li> <li>Use the command <code>powercfg /requests</code> to identify processes preventing sleep.</li> <li>Use the command <code>powercfg /waketimers</code> to view active wake timers.</li> <li>Check Task Scheduler to see if any of the discovered processes are scheduled to start on boot or at regular intervals.</li> </ul> </li> <li> <p><strong>Advanced Identification of Power-Hungry Apps:</strong></p> <ul> <li>Open Resource Monitor from the Start menu.</li> <li>Navigate to the <em>CPU</em>, <em>Memory</em>, <em>Network</em>, and other tabs to identify processes with high resource usage.</li> <li>Consider reconfiguring, closing, disabling, or uninstalling applications that use a lot of resources.</li> </ul> </li> <li> <p><strong>Disable Activity History:</strong></p> <ul> <li>Open the Settings app, and go to <em>Privacy</em> &gt; <em>Activity history</em>.</li> <li>Turn off <em>Let Windows collect my activities from this PC</em>.</li> </ul> </li> <li> <p><strong>Prevent Network Adapters From Waking PC:</strong></p> <ul> <li>Open Device Manager by searching for it in the Start menu.</li> <li>Locate your network adapter, right-click, and go to <em>Properties</em>.</li> <li>Under the <em>Power Management</em> tab, uncheck the option that allows the device to wake the computer.</li> </ul> </li> <li> <p><strong>Review Installed Applications:</strong></p> <ul> <li>Manually review installed applications by searching for <em>Add or remove programs</em> in the Start menu.</li> <li>Check settings/preferences of individual applications for power-related options.</li> <li>Uninstall unnecessary or problematic software.</li> </ul> </li> </ol> <p>These troubleshooting steps are generic, but should help in most situations. You should have these key takeaways: - Battery health is the most significant limiter on your device's runtime. A battery in poor health usually cannot be made to last like it used to, simply by closing some applications. Consider replacing your battery. - Background applications that use CPU and memory, make lots of or large network requests, read/write to disk frequently, or that keep your PC awake when it could be conserving energy are the next major concern. Avoid installing programs you don't need, only use programs you trust, and configure applications to use as little power and run as infrequently as possible. - Windows performs a lot of tasks that may affect battery life by default. Changing settings, stopping scheduled tasks, and disabling features can help the system stay in lower power states to conserve battery. - Bad chargers, inconsistent power input, and high temperatures will cause batteries to degrade and discharge faster. Use trusted high-quality chargers, ensure input power is steady, clean any fans or airflow ports, and keep the battery/PC cool.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1-2.1-2M12.5 7v5.2l4 2.4-1 1L11 13V7h1.5M11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2v1.8Z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-da