download command (winget)

  • Makale

The download command of the winget tool downloads the installer, dependencies, and license file (when downloading a Microsoft Store Packaged app). Use the search command and the show command to identify the package installer you want to download.

The download command requires that you specify the exact string to download. If there is any ambiguity, you will be prompted to further filter the download command to an exact application.

The download command requires EntraID (formally Azure Active Directory) authentication to download a Microsoft Store packaged app (*.msix, *.appx, *.msixbundle, or *.appxbundle) and to download the Microsoft Store packaged app license file. The EntraID account used for authentication to generate and retrieve a Microsoft Store packaged app license file must be a member of one of the following three Azure roles: Global Administrator, User Administrator, or License Administrator.

Note

By default, the download command will download the appropriate installer to the user's Downloads folder. Use the --download-directory option to specify a custom download path.

Usage

winget download [[-q] <query>] [<options>]

download command

Download without license file

Downloading a package using WinGet, the package license file can be omitted by appending to the command the --skip-license parameter. The exclusion of the package license file will remove the authorization requirement for generating the offline license file.

winget download [[--id] <package id>] [[--skip-license]] [<options>]

Download for a specific platform

Downloading a package using WinGet, by default will download the latest available version of a package for each applicable use case (architecture, device platform, etc.). Filtering the downloaded content for a specific device platform is done by appending to the command the --platform parameter.

winget download [[--id] <package id>] [[--platform] <platform type> ] [<options>]
Platform Description
Windows.Desktop Supports being installed on Windows desktop experience
Windows.Universal Supports being installed on all Microsoft operating systems
Windows.Holographic Supports being installed on Microsoft HoloLens devices

Download for a specific architecture

Downloading a package using WinGet, by default will download the latest available version of a package for each applicable use case (architecture, device platform, etc.). Filtering the downloaded content with a specific architecture is done by appending to the command the --architecture parameter.

winget download [[--id] <package id>] [[--architecture] <Architecture>] [<options>]
Architecture Description
x86 32-bit processor
x64 64-bit processor
arm 32-bit ARM processor
arm64 64-bit ARM processor

Arguments

The following arguments are available.

Argument Description
-q,--query The query used to search for an app.

Note

The query argument is positional. Wild-card style syntax is not supported. This is most often the string of characters you expect to uniquely identify the package you wish to download.

Options

The options allow you to customize the download experience to meet your needs.

Option Description
-d, --download-directory Directory where the installers are downloaded to.
-m, --manifest Must be followed by the path to the manifest (YAML) file.
--id Limits the download to the ID of the application.
--name Limits the search to the name of the application.
--moniker Limits the search to the moniker listed for the application.
-v, --version Enables you to specify an exact version to install. If not specified, latest will download the highest versioned application.
-s, --source Restricts the search to the source name provided. Must be followed by the source name.
--scope Allows you to specify if the installer should target user or machine scope. See known issues relating to package installation scope.
-a, --architecture Select the architecture to download.
--installer-type Select the installer type to download.
-e, --exact Uses the exact string in the query, including checking for case-sensitivity. It will not use the default behavior of a substring.
--locale Specifies which locale to use (BCP47 format).
--ignore-security-hash Ignore the installer hash check failure. Not recommended.
--skip-dependencies Skips processing package dependencies and Windows features.
--header Optional Windows-Package-Manager REST source HTTP header.
--authentication-mode Specify authentication window preference (silent, silentPreferred or interactive).
--authentication-account Specify the account to be used for authentication.
--accept-package-agreements Used to accept the license agreement, and avoid the prompt.
--accept-source-agreements Used to accept the source license agreement, and avoid the prompt.
--skip-license,--skip-microsoft-store-package-license Skips retrieving Microsoft Store package offline license.
--platform Select the target platform.
-?, --help Get additional help on this command.
--wait Prompts the user to press any key before exiting.
--logs,--open-logs Open the default logs location.
--verbose, --verbose-logs Used to override the logging setting and create a verbose log.
--nowarn,--ignore-warnings Suppresses warning outputs.
--disable-interactivity Disable interactive prompts.
--proxy Set a proxy to use for this execution.
--no-proxy Disable the use of proxy for this execution.

Example queries

The following example downloads a specific version of an application from its ID.

winget download --id Microsoft.PowerToys --version 0.15.2

The following example downloads an application with a specific installer type.

winget download --id Microsoft.WingetCreate --installer-type msix

The following example downloads an application by architecture and scope to a specific download directory.

winget download --id Microsoft.PowerToys --scope machine --architecture x64 --download-directory <Path>