Skip to content

Commit e6c18ee

Browse files
denelonmattwojo
andauthored
Update troubleshooting (#5544)
* Update troubleshooting * Update date --------- Co-authored-by: Matt Wojciakowski <[email protected]>
1 parent 1e7f5dd commit e6c18ee

File tree

1 file changed

+25
-1
lines changed

1 file changed

+25
-1
lines changed

hub/package-manager/winget/troubleshooting.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Debugging and troubleshooting issues with WinGet
33
description: Provides information on logging and WinGet diagnostics.
4-
ms.date: 11/15/2024
4+
ms.date: 07/15/2025
55
ms.topic: troubleshooting-general
66
---
77

@@ -44,6 +44,20 @@ If you need more comprehensive log files, that provide the complete communicatio
4444
> winget source add -n mysource -t Microsoft.REST -a https://www.contoso.org --verbose
4545
```
4646

47+
### settings
48+
49+
You can specify the default logging level for WinGet to use in your WinGet Settings file. The **settings** command will open the settings.json file in your default JSON editor.
50+
51+
Example with verbose logging:
52+
```JSON
53+
{
54+
"$schema": "https://aka.ms/winget-settings.schema.json",
55+
"logging": {
56+
"level": "verbose"
57+
}
58+
}
59+
```
60+
4761
## Known issues
4862

4963
A list of known issues with sources and behaviors is kept up to date in the [Windows Package Manager Client repository](https://www.github.com/microsoft/winget-cli). If you encounter issues when using the WinGet tool, go [here](https://github.com/microsoft/winget-cli/tree/master/doc/troubleshooting) for troubleshooting.
@@ -52,6 +66,12 @@ A list of known issues with sources and behaviors is kept up to date in the [Win
5266

5367
The WinGet tool returns exit codes to indicate success or failure of the command. Find a table of exit codes and their meanings in the ["Return codes" file of the Windows Package Manager Client repository](https://github.com/microsoft/winget-cli/blob/master/doc/windows/package-manager/winget/returnCodes.md).
5468

69+
The WinGet **error** command accepts errors from "Exit codes" and displays a description for known error codes for WinGet, MSIX, and MSI installers. Many .exe-based installers have non-standard error codes and may not be displayed.
70+
71+
```CMD
72+
> winget error 1603
73+
```
74+
5575
### Scope for specific user vs machine-wide
5676

5777
Not all installers support installing in “user” scope vs. “machine” scope consistently.
@@ -75,3 +95,7 @@ The user agent string for WinGet has the following format:
7595
Example:
7696

7797
`winget-cli WindowsPackageManager/1.9.25200 DesktopAppInstaller/Microsoft.DesktopAppInstaller v1.24.25200.0`
98+
99+
### System Context
100+
101+
WinGet is delivered via the App Installer as a packaged application. MSIX (packaged) applications depend on an App Execution Alias to be resolved on the PATH environment variable. The WinGet CLI is not supported in the system context. The Microsoft.WinGet.Client PowerShell module can be used in the system context with applications that are installed machine wide.

0 commit comments

Comments
 (0)