Back to Winget Cli

uninstall Command

doc/windows/package-manager/winget/uninstall.md

1.28.2404.2 KB
Original Source

uninstall command (winget)

The uninstall command of the winget tool uninstalls the specified application.

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

Usage

winget uninstall [[-q] <query>...] [<options>]

The following command aliases are available:
remove
rm

Arguments

The following arguments are available.

ArgumentDescription
-q,--queryThe query used to search for an app.

Options

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

OptionDescription
-m, --manifestMust be followed by the path to the manifest (YAML) file. You can use the manifest to run the uninstall experience from a local YAML file.
--idLimits the uninstall to the ID of the application.
--nameLimits the search to the name of the application.
--monikerLimits the search to the moniker listed for the application.
-v, --versionEnables you to specify an exact version to uninstall. If not specified, the latest will uninstall the highest versioned application.
-s, --sourceRestricts the search to the source name provided. Must be followed by the source name.
-e, --exactUses the exact string in the query, including checking for case-sensitivity. It will not use the default behavior of a substring.
-i, --interactiveRuns the uninstaller in interactive mode. The default experience shows uninstaller progress.
-h, --silentRuns the uninstaller in silent mode. This suppresses all UI. The default experience shows uninstaller progress.
-o, --logDirects the logging to a log file. You must provide a path to a file that you have the write rights to.
--product-codeFilters using the product code.
--scopeSelect installed package scope filter (user or machine).
--forceDirectly run the command and continue with non-security-related issues.
--purgeDeletes all files and directories in the package directory (portable).
--preserveRetains all files and directories created by the package (portable).
--headerOptional Windows-Package-Manager REST source HTTP header.
--accept-source-agreementsAccept all source agreements during source operations.
-?, --helpGet additional help on this command.
--waitPrompts the user to press any key before exiting.
--logs, --open-logsOpen the default logs location.
--verbose, --verbose-logsEnables verbose logging for winget.
--disable-interactivityDisable interactive prompts.

Once you have successfully identified the application intended to uninstall, winget will execute the uninstall command. In the example below, the name 'orca' and the id was passed in.

Example queries

The following example uninstalls a specific version of an application.

CMD
winget uninstall --name powertoys --version 0.15.2

The following example uninstalls an application using its ID.

CMD
winget uninstall --id "{24559D0F-481C-F3BE-8DD0-D908923A38F8}"

Multiple selections

If the query provided to winget does not result in a single application to uninstall, then winget will display multiple results. You can then use additional filters to refine the search for a correct application.

Uninstalling apps not installed with Windows Package Manager

As mentioned in list, the winget list command will display more than just apps installed with the winget. Therefore you can use these commands to quickly and easily remove apps from your PC.

In this example, list was used to find the application, and then the id was passed in as part of uninstall.