learn.microsoft.com
Open in
urlscan Pro
2a02:26f0:7100:9a1::3544
Public Scan
URL:
https://learn.microsoft.com/en-us/windows/package-manager/winget/upgrade
Submission: On December 09 via api from BE — Scanned from DE
Submission: On December 09 via api from BE — Scanned from DE
Form analysis
3 forms found in the DOMName: site-header-search-form-mobile — GET /en-us/search/
<form class="flex-grow-1" method="GET" role="search" id="ms--site-header-search-form-mobile" data-bi-name="site-header-search-form-mobile" name="site-header-search-form-mobile" aria-label="Search" action="/en-us/search/">
<div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
<div class="field-body control ">
<input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-header-search-autocomplete-input-mobile"
data-test-id="site-header-search-autocomplete-input-mobile" class="autocomplete-input input
width-full" type="search" name="terms" aria-expanded="false" aria-owns="ax-1-listbox" aria-controls="ax-1-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-header-search-autocomplete-input-mobile-description"
placeholder="Search" data-bi-name="site-header-search-autocomplete-input-mobile" pattern=".*">
<span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
<span hidden="" id="ms--site-header-search-autocomplete-input-mobile-description"> Suggestions will filter as you type </span>
</div>
<ul role="listbox" id="ax-1-listbox" data-test-id="site-header-search-autocomplete-input-mobile-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
</ul>
<!---->
</div>
<!-- mobile safari will not dispatch submit event unless there's a submit button that is not display:none -->
<button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button>
<input name="category" hidden="" value="">
</form>
Name: site-header-search-form — GET /en-us/search/
<form class="flex-grow-1" method="GET" role="search" id="ms--site-header-search-form" data-bi-name="site-header-search-form" name="site-header-search-form" aria-label="Search" action="/en-us/search/">
<div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
<div class="field-body control ">
<input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-header-search-autocomplete-input" data-test-id="site-header-search-autocomplete-input" class="autocomplete-input input input-sm
width-full" type="search" name="terms" aria-expanded="false" aria-owns="ax-0-listbox" aria-controls="ax-0-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-header-search-autocomplete-input-description"
placeholder="Search" data-bi-name="site-header-search-autocomplete-input" pattern=".*">
<span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
<span hidden="" id="ms--site-header-search-autocomplete-input-description"> Suggestions will filter as you type </span>
</div>
<ul role="listbox" id="ax-0-listbox" data-test-id="site-header-search-autocomplete-input-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
</ul>
<!---->
</div>
<!-- mobile safari will not dispatch submit event unless there's a submit button that is not display:none -->
<button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button>
<input name="category" hidden="" value="">
</form>
javascript:
<form action="javascript:" role="search" aria-label="Search" class="margin-bottom-xxs"><label class="visually-hidden" for="ax-2">Search</label>
<div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
<div class="field-body control has-icons-left">
<input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="ax-2" data-test-id="ax-2" class="autocomplete-input input input-sm
control has-icons-left
width-full" type="text" aria-expanded="false" aria-owns="ax-3-listbox" aria-controls="ax-3-listbox" aria-activedescendant="" aria-describedby="ms--ax-2-description" placeholder="Filter by title" pattern=".*">
<span aria-hidden="true" class="icon is-small is-left">
<span class="has-text-primary docon docon-filter-settings"></span>
</span>
<span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
<span hidden="" id="ms--ax-2-description"> Suggestions will filter as you type </span>
</div>
<ul role="listbox" id="ax-3-listbox" data-test-id="ax-2-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
</ul>
<!---->
</div>
</form>
Text Content
Skip to main content We use optional cookies to improve your experience on our websites, such as through social media connections, and to display personalized advertising based on your online activity. If you reject optional cookies, only cookies necessary to provide you the services will be used. You may change your selection by clicking “Manage Cookies” at the bottom of the page. Privacy Statement Third-Party Cookies Accept Reject Manage cookies MICROSOFT LEARN CHALLENGE Nov 23, 2024 – Jan 10, 2025 Build skills in the latest technologies and earn a digital badge by January 10! Register now Dismiss alert This browser is no longer supported. Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support. Download Microsoft Edge More info about Internet Explorer and Microsoft Edge Learn Suggestions will filter as you type Sign in * Profile * Settings Sign out Learn * Discover * Documentation In-depth articles on Microsoft developer tools and technologies * Training Personalized learning paths and courses * Credentials Globally recognized, industry-endorsed credentials * Q&A Technical questions and answers moderated by Microsoft * Code Samples Code sample library for Microsoft developer tools and technologies * Assessments Interactive, curated guidance and recommendations * Shows Thousands of hours of original programming from Microsoft experts Microsoft Learn for Organizations Boost your team's technical skills Access curated resources to upskill your team and close skills gaps. * Product documentation * ASP.NET * Azure * Dynamics 365 * Microsoft 365 * Microsoft Copilot * Microsoft Edge * Microsoft Entra * Microsoft Graph * Microsoft Intune * Microsoft Purview * Microsoft Teams * .NET * Power Apps * Power BI * Power Platform * PowerShell * SQL * Sysinternals * Visual Studio * Windows * Windows Server View all products Microsoft Learn for Organizations Boost your team's technical skills Access curated resources to upskill your team and close skills gaps. * Development languages * C++ * C# * DAX * Java * OData * OpenAPI * Power Query M * VBA Microsoft Learn for Organizations Boost your team's technical skills Access curated resources to upskill your team and close skills gaps. * Topics * Artificial intelligence * Compliance * DevOps * Platform engineering * Security Microsoft Learn for Organizations Boost your team's technical skills Access curated resources to upskill your team and close skills gaps. Suggestions will filter as you type Sign in * Profile * Settings Sign out Windows * Release health * Windows client * Windows client for IT pros * Deployment * Windows Autopilot * Windows Autopatch * Deploy hub * Security * Privacy * Client management * Configuration * Windows for Education * Troubleshooting * Application developers * Windows app development documentation * App developer tools * Windows App SDK * WinUI * MSIX * Windows Terminal * Windows AI * Windows Subsystem for Linux * Microsoft PowerToys * Platforms * Win32 apps * WinUI * WPF * Windows Forms * UWP * Web development on Windows * Windows for IoT * Mixed reality * Game development kit * Hardware developers * Hardware developer documentation * Windows Driver Kit (WDK) * WDK code samples * Hardware Lab Kit (HLK) * Assessment and Deployment Kit (ADK) * Debugging tools for Windows * Get started building devices * Windows Server * Windows for IoT * Windows Insider Program * Windows 365 * More * Release health * Windows client * Windows client for IT pros * Deployment * Windows Autopilot * Windows Autopatch * Deploy hub * Security * Privacy * Client management * Configuration * Windows for Education * Troubleshooting * Application developers * Windows app development documentation * App developer tools * Windows App SDK * WinUI * MSIX * Windows Terminal * Windows AI * Windows Subsystem for Linux * Microsoft PowerToys * Platforms * Win32 apps * WinUI * WPF * Windows Forms * UWP * Web development on Windows * Windows for IoT * Mixed reality * Game development kit * Hardware developers * Hardware developer documentation * Windows Driver Kit (WDK) * WDK code samples * Hardware Lab Kit (HLK) * Assessment and Deployment Kit (ADK) * Debugging tools for Windows * Get started building devices * Windows Server * Windows for IoT * Windows Insider Program * Windows 365 Table of contents Exit focus mode Search Suggestions will filter as you type * Windows development environment * Developer tools * Dev Home * Dev Drive * Windows Package Manager * Overview * Use the winget tool * Overview * configure command * download command * export command * features command * hash command * help command * import command * info command * install command * list command * pin command * search command * settings command * show command * source command * tab completion * uninstall command * upgrade command * validate command * Debugging and troubleshooting * WinGet Configuration * Submit packages * PowerToys * Windows Subsystem for Linux * Windows Terminal * Sudo for Windows * Mac to Windows guide * Keyboard shortcuts * Development paths Download PDF 1. Learn 2. Windows 1. Learn 2. Windows Read in English Save * Add to Collections * Add to Plan Table of contents Read in English Add to Collections Add to Plan Edit -------------------------------------------------------------------------------- SHARE VIA Facebook x.com LinkedIn Email -------------------------------------------------------------------------------- Print Table of contents UPGRADE COMMAND (WINGET) * Article * 07/31/2024 * 8 contributors Feedback IN THIS ARTICLE 1. Aliases 2. Usage 3. Arguments 4. Options 5. Using upgrade 6. Using list and upgrade 7. upgrade --all 8. upgrade --uninstall-previous Show 4 more The upgrade command of the winget tool upgrades the specified application. Optionally, you may use the list command to identify the application you want to upgrade. The upgrade command requires that you specify the exact string to upgrade. If there is any ambiguity, you will be prompted to further filter the upgrade command to an exact application. ALIASES The following aliases are available for this command: * update USAGE winget upgrade [[-q] <query> ...] [<options>] ARGUMENTS The following arguments are available. Expand table 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 help find the package you are upgrading. OPTIONS The options allow you to customize the upgrade experience to meet your needs. Expand table Option Description -m, --manifest Must be followed by the path to the manifest (YAML) file. You can use the manifest to run the upgrade experience from a local YAML file. --id Limits the upgrade 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 upgrade. If not specified, latest will upgrade the highest versioned application. -s, --source Restricts the search to the source name provided. Must be followed by the source name. -e, --exact Uses the exact string in the query, including checking for case-sensitivity. It will not use the default behavior of a substring. -i, --interactive Runs the installer in interactive mode. The default experience shows installer progress. -h, --silent Runs the installer in silent mode. This suppresses all UI. The default experience shows installer progress. --purge Deletes all files and directories in the package directory (portable) -o, --log Directs the logging to a log file. You must provide a path to a file that you have the write rights to. --custom Arguments to be passed on to the installer in addition to the defaults. --override A string that will be passed directly to the installer. -l, --location Location to upgrade to (if supported). --scope Select installed package scope filter (user or machine). a, --architecture Select the architecture to install. --installer-type Select the installer type to upgrade. See supported installer types for WinGet client. --locale Specifies which locale to use (BCP47 format). --ignore-security-hash Ignore the installer hash check failure. Not recommended. --allow-reboot Allows a reboot if applicable. --skip-dependencies Skips processing package dependencies and Windows features. --ignore-local-archive-malware-scan Ignore the malware scan performed as part of installing an archive type package from local manifest. --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. --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. -r, --recurse, --all Upgrade all installed packages to the latest version if available. -u, --unknown, --include-unknown Upgrade packages even if their current version cannot be determined. --pinned,--include-pinned Upgrade packages even if they have a non-blocking pin. --uninstall-previous Uninstall the previous version of the package during upgrade. Behavior will depend on the individual package. Some installers are designed to install new versions side-by-side. Some installers include a manifest that specifies “uninstallPrevious” so earlier versions are uninstalled without needing to use this command flag. In this case, using the winget upgrade --uninstall-previous command will tell WinGet to uninstall the previous version regardless of what is in the package manifest. If the package manifest does not include “uninstallPrevious” and the --uninstall-previous flag is not used, then the default behavior for the installer will apply. --force Direct run the command and continue with non security related issues. -?,--help Shows help about the selected 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 upgrades a specific version of an application. CMD Copy winget upgrade powertoys --version 0.15.2 The following example upgrades an application from its ID. CMD Copy winget upgrade --id Microsoft.PowerToys The following example shows upgrading all apps CMD Copy winget upgrade --all USING UPGRADE To identify which apps are in need of an update, simply use upgrade without any arguments to show all available upgrades. In the example below, you will see winget upgrade shows the user which apps have an available update. From the available updates, the user identifies that an update is available for JanDeDobbeleer.OhMyPosh and uses upgrade to update the application. USING LIST AND UPGRADE To search for an available update for a specific app, use to the list command. Once you have identified that an update is available for your specific app, use upgrade to install the latest. The example below shows the list command being used to identify that an update is available for Microsoft.WindowsTerminalPreview. The user then uses upgrade to update the application. UPGRADE --ALL upgrade --all will identify all the applications with upgrades available. When you run winget upgrade --all the Windows Package Manager will look for all applications that have updates available and attempt to install the updates. Note Some applications do not provide a version. They are always latest. Because the Windows Package Manager cannot identify if there is a newer version of the app, an upgrade will not be possible. UPGRADE --UNINSTALL-PREVIOUS upgrade --uninstall-previous will uninstall the previous version prior to installing the newer version of the package. When using --uninstall-previous, the behavior will depend on the individual package. Some installers are designed to install new versions side-by-side while other installers include a manifest that specifies uninstallPrevious as their default upgrade behavior (so earlier versions are uninstalled without needing to use the command flag). If the package manifest does not include uninstallPrevious as the upgrade behavior and the --uninstall-previous flag is not used with the upgrade command, then the default behavior for the installer will apply. Collaborate with us on GitHub The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide. Windows developer feedback Windows developer is an open source project. Select a link to provide feedback: Open a documentation issue Provide product feedback -------------------------------------------------------------------------------- ADDITIONAL RESOURCES -------------------------------------------------------------------------------- Training Module Explore the Windows Package Manager tool - Training Streamline the installation and maintenance of software on your computer by using Windows Package Manager. Explain the front-end components and commands, the Windows Package Manager repository, and how to contribute to the repository. English (United States) California Consumer Privacy Act (CCPA) Opt-Out Icon Your Privacy Choices Theme * Light * Dark * High contrast * Manage cookies * Previous Versions * Blog * Contribute * Privacy * Terms of Use * Trademarks * © Microsoft 2024 ADDITIONAL RESOURCES -------------------------------------------------------------------------------- Training Module Explore the Windows Package Manager tool - Training Streamline the installation and maintenance of software on your computer by using Windows Package Manager. Explain the front-end components and commands, the Windows Package Manager repository, and how to contribute to the repository. IN THIS ARTICLE English (United States) California Consumer Privacy Act (CCPA) Opt-Out Icon Your Privacy Choices Theme * Light * Dark * High contrast * Manage cookies * Previous Versions * Blog * Contribute * Privacy * Terms of Use * Trademarks * © Microsoft 2024