Merge pull request #5669 from MicrosoftDocs/main

Auto Publish – main to live - 2025-08-07 05:00 UTC

Author: learn-build-service-prod[bot]

hub/package-manager/winget/configure.md

@@ -1,9 +1,8 @@
 ---
 title: configure Command
 description: Uses a winget configuration file to begin setting up your Windows machine to a desired development environment state.
-ms.date: 05/23/2023
+ms.date: 07/16/2025
 ms.topic: overview
-ms.localizationpriority: medium
 ---
 
 # configure command (winget)
@@ -27,9 +26,11 @@ The following aliases are available for this command:
 
 ## Usage
 
-`winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.yaml>`
+`winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.winget>`
 
-Once you have identified the winget configuration file that you are interested in using, confirmed the safety and trustworthiness of that file, and downloaded the file to your local machine, you can use the `winget configure` command to initiate the set up of your configuration.
+Once you have identified the WinGet configuration file that you are interested in using, confirmed the safety and trustworthiness of that file, and downloaded the file to your local machine, you can use the `winget configure` command to initiate the set up of your configuration.
+
+:::image type="content" source="./images/configure.png" alt-text="Screenshot listing winget configure command options." lightbox="./images/configure.png":::
 
 ## Arguments and options
 
@@ -59,10 +60,10 @@ The following arguments are available:
 The `winget configure` command includes a number of subcommands, including:
 
 - **`winget configure show`**: Displays the details of a configuration file. Usage: `winget configure show -f <file>`. Running the command: `winget configuration show configuration.dsc.yaml` will display the details of the configuration in the current working directory.
-- `winget configure list`: Shows the high level details for configurations that have been applied to the system. This data can then be used with other `configure` commands to get more details. Usage: `winget configure list [<options>]`
-- `winget configure test`: Checks the system against the desired state, displaying whether the current system state conforms with the desired state defined in the associated configuration file. Usage: `winget configure test -f <file>`.
-- `winget configure validate`: Validates a configuration file. Usage: `winget configure validate [-f] <file> [<options>]`.
-- `winget configure export`: Exports configuration resources to a configuration file. When used with `--all`, exports all package configurations. When used with `--packageId`, exports a WinGetPackage resource of the given package identifier. When used with `--module` and `--resource`, exports the settings of the specified resource. If the output configuration file already exists, appends the exported configuration resources. Usage: `winget configure export -o <output file> [<options>]`
+- **`winget configure list`**: Shows the high level details for configurations that have been applied to the system. This data can then be used with other `configure` commands to get more details. Usage: `winget configure list [<options>]`
+- **`winget configure test`**: Checks the system against the desired state, displaying whether the current system state conforms with the desired state defined in the associated configuration file. Usage: `winget configure test -f <file>`.
+- **`winget configure validate`**: Validates a configuration file. Usage: `winget configure validate [-f] <file> [<options>]`.
+- **`winget configure export`**: Exports configuration resources to a configuration file. When used with `--all`, exports all package configurations. When used with `--packageId`, exports a WinGetPackage resource of the given package identifier. When used with `--module` and `--resource`, exports the settings of the specified resource. If the output configuration file already exists, appends the exported configuration resources. Usage: `winget configure export -o <output file> [<options>]`
 
 ## Related topics
 

hub/package-manager/winget/download.md

@@ -1,7 +1,7 @@
 ---
 title: winget download command
 description: Downloads an installer for a package.
-ms.date: 07/07/2025
+ms.date: 07/18/2025
 ms.topic: how-to
 ms.custom: sfi-ga-nochange
 ---
@@ -77,35 +77,35 @@ 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](./troubleshooting.md#scope-for-specific-user-vs-machine-wide).|
-| **-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. |
+| **`-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](./troubleshooting.md#scope-for-specific-user-vs-machine-wide).|
+| **`-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