You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## Summary
This PR addresses 5 open documentation Task issues:
### Changes
| Issue | Description | File Changed |
|-------|-------------|--------------|
| #5296 | Add missing `downloadBehavior` and `defaultDownloadDirectory`
settings to Settings.md | `doc/Settings.md` |
| #5921 | Add PowerShell module (`Microsoft.WinGet.Client`) section with
cmdlet examples to README | `README.md` |
| #5108 | Add missing `resume` experimental feature to the settings JSON
schema | `schemas/JSON/settings/settings.schema.0.2.json` |
| #4372 | Add AppInstaller reset/repair commands (Win10 & Win11) to
troubleshooting guide | `doc/troubleshooting/README.md` |
| #5867 | Fix broken `aka.ms/winget-dsc-resources` help link that
redirects to Bing | `src/AppInstallerCLICore/Commands/DscCommand.cpp` |
### Details
- **Settings.md (#5296):** The `downloadBehavior` section with
`defaultDownloadDirectory` was already defined in the settings schema
(`settings.schema.0.2.json`) but was not documented in
`doc/Settings.md`. Added it between Configure Behavior and Telemetry
sections.
- **README.md (#5921):** Added a new **PowerShell Module** section
showing how to install `Microsoft.WinGet.Client` from the PowerShell
Gallery and example cmdlet usage (`Find-WinGetPackage`,
`Install-WinGetPackage`, `Get-WinGetPackage`, `Update-WinGetPackage`,
`Repair-WinGetPackageManager`).
- **Settings schema (#5108):** The `resume` experimental feature was
documented in `Settings.md` but missing from the JSON schema. Added it
alongside the existing experimental features. (The other items from the
original issue — `archiveExtractionMethod` and `fonts` — have already
been fixed.)
- **Troubleshooting (#4372):** Added step 5 with PowerShell commands to
reset the App Installer package when it's in a broken state, with
separate commands for Windows 10 and Windows 11.
- **DSC help link (#5867):** The `https://aka.ms/winget-dsc-resources`
URL in `DscCommand.cpp` redirects to Bing's home page. Updated it to
point to the WinGet Configuration documentation on Microsoft Learn.
Fixes#5296, #5921, #5108, #4372, #5867
###### Microsoft Reviewers: [Open in
CodeFlow](https://microsoft.github.io/open-pr/?codeflow=https://github.com/microsoft/winget-cli/pull/6110)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The [Microsoft.WinGet.Client](https://www.powershellgallery.com/packages/Microsoft.WinGet.Client/) PowerShell module provides native cmdlets for interacting with the Windows Package Manager. You can install it from the PowerShell Gallery:
For more information, see the [Microsoft.WinGet.Client](https://www.powershellgallery.com/packages/Microsoft.WinGet.Client/) page on the PowerShell Gallery.
74
+
46
75
## Administrator Considerations
47
76
48
77
Installer behavior can be different depending on whether you are running **WinGet** with administrator privileges.
Copy file name to clipboardExpand all lines: doc/Settings.md
+16Lines changed: 16 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -248,6 +248,22 @@ The `defaultModuleRoot` behavior affects the default root directory where module
248
248
},
249
249
```
250
250
251
+
## Download Behavior
252
+
253
+
The `downloadBehavior` settings affect the default behavior of downloading packages.
254
+
255
+
### Default Download Directory
256
+
257
+
The `defaultDownloadDirectory` setting affects the default directory where installers are downloaded to. Defaults to `%USERPROFILE%/Downloads/` if value is not set or is invalid.
258
+
259
+
> Note: This setting value must be an absolute path.
Copy file name to clipboardExpand all lines: doc/troubleshooting/README.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -113,6 +113,9 @@ These errors most commonly occur for one of following reasons. Please try out th
113
113
1. Get the `PackageFullName` of your installed `App Installer` package (PowerShell): `Get-AppxPackage Microsoft.DesktopAppInstaller | Select Name, PackageFullName`.
114
114
2.`Add-AppxPackage -register "C:\Program Files\WindowsApps\{PackageFullName}\appxmanifest.xml" -DisableDevelopmentMode` (where `{PackageFullName}` is the info from the previous point).
115
115
3. Toggle the App Execution Alias for winget, again (see above).
116
+
5. The App Installer package may be in a broken state. You can try resetting it using PowerShell:
117
+
* On **Windows 11**: `Get-AppxPackage Microsoft.DesktopAppInstaller | Reset-AppxPackage`
0 commit comments