Skip to content

Commit d65ed17

Browse files
authored
Add known scope issues (#3615)
1 parent 850953a commit d65ed17

File tree

3 files changed

+12
-2
lines changed

3 files changed

+12
-2
lines changed

hub/package-manager/winget/install.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ The options allow you to customize the install experience to meet your needs.
4242
| **--moniker** | Limits the search to the moniker listed for the application. |
4343
| **-v, --version** | Enables you to specify an exact version to install. If not specified, latest will install the highest versioned application. |
4444
| **-s, --source** | Restricts the search to the source name provided. Must be followed by the source name. |
45-
| **--scope** | Allows you to specify if the installer should target user or machine scope. |
45+
| **--scope** | Allows you to specify if the installer should target user or machine scope. See [known issues relating to package installation scope](./troubleshooting.md#scope-for-specific-user-vs-machine-wide).|
4646
| **-a, --architecture** | Select the architecture to install. |
4747
| **-e, --exact** | Uses the exact string in the query, including checking for case-sensitivity. It will not use the default behavior of a substring. |
4848
| **-i, --interactive** | Runs the installer in interactive mode. The default experience shows installer progress. |

hub/package-manager/winget/settings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -136,7 +136,7 @@ Any arguments passed on the command line will effectively override the matching
136136

137137
#### scope
138138

139-
The `scope` behavior affects the choice between installing a package for the current user or for the entire machine. The matching parameter is `--scope`, and uses the same values (`user` or `machine`).
139+
The `scope` behavior affects the choice between installing a package for the current user or for the entire machine. The matching parameter is `--scope`, and uses the same values (`user` or `machine`). See [known issues relating to package installation scope](./troubleshooting.md#scope-for-specific-user-vs-machine-wide).
140140

141141
```json
142142
"installBehavior": {

hub/package-manager/winget/troubleshooting.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,3 +33,13 @@ If you need more comprehensive log files, that provide the complete communicatio
3333
## Known issues
3434

3535
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.
36+
37+
### Scope for specific user vs machine-wide
38+
39+
Not all installers support installing in “user” scope vs. “machine” scope consistently.
40+
41+
- [MSIX-based packages](/windows/msix/overview): Reliable WinGet behavior.
42+
- [MSI-based packages](/windows/win32/msi/installation-package) typically support reliable WinGet configurations, but in some cases, are nested inside an .exe-based installer so there may be more variability.
43+
- [EXE-based installers](https://stackoverflow.com/questions/3886455/whats-the-difference-between-an-exe-and-a-msi-installer) behavior around scope is not necessarily deterministic. In some cases the arguments to specify scope are not available, and in other cases the installer may make the determination based on whether the user is a member of the local administrators group. Packages installed in user scope may still require UAC (User Account Control) authorization from an administrator.
44+
45+
See more details on [scope-related issues](https://github.com/microsoft/winget-cli/issues?q=is%3Aissue+is%3Aopen+label%3Aarea-scope) in the WinGet product repository on GitHub.

0 commit comments

Comments
 (0)