Skip to content

Commit cef4401

Browse files
denelonmattwojo
andauthored
Update Configure command (#5543)
* Add configure image * Update configure.md * Update screenshot and date * Update metadata --------- Co-authored-by: Matt Wojciakowski <[email protected]>
1 parent 2f1e76a commit cef4401

File tree

2 files changed

+9
-8
lines changed

2 files changed

+9
-8
lines changed

hub/package-manager/winget/configure.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
---
22
title: configure Command
33
description: Uses a winget configuration file to begin setting up your Windows machine to a desired development environment state.
4-
ms.date: 05/23/2023
4+
ms.date: 07/16/2025
55
ms.topic: overview
6-
ms.localizationpriority: medium
76
---
87

98
# configure command (winget)
@@ -27,9 +26,11 @@ The following aliases are available for this command:
2726

2827
## Usage
2928

30-
`winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.yaml>`
29+
`winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.winget>`
3130

32-
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.
31+
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.
32+
33+
:::image type="content" source="./images/configure.png" alt-text="Screenshot listing winget configure command options." lightbox="./images/configure.png":::
3334

3435
## Arguments and options
3536

@@ -59,10 +60,10 @@ The following arguments are available:
5960
The `winget configure` command includes a number of subcommands, including:
6061

6162
- **`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.
62-
- `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>]`
63-
- `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>`.
64-
- `winget configure validate`: Validates a configuration file. Usage: `winget configure validate [-f] <file> [<options>]`.
65-
- `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>]`
63+
- **`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>]`
64+
- **`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>`.
65+
- **`winget configure validate`**: Validates a configuration file. Usage: `winget configure validate [-f] <file> [<options>]`.
66+
- **`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>]`
6667

6768
## Related topics
6869

105 KB
Loading

0 commit comments

Comments
 (0)