Skip to content

Commit 83defb6

Browse files
committed
Make WinGet Configuration stable feature in docs
1 parent 1d73bc2 commit 83defb6

File tree

4 files changed

+8
-37
lines changed

4 files changed

+8
-37
lines changed

hub/package-manager/configuration/check.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: How to check a WinGet Configuration
3-
description: Learn how to check a WinGet Configuration.
3+
description: Learn how to check a WinGet Configuration.
44
ms.date: 05/23/2023
55
ms.topic: overview
66
---

hub/package-manager/configuration/create.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: How to author a WinGet Configuration file
3-
description: Learn how to create a WinGet Configuration.
3+
description: Learn how to create a WinGet Configuration.
44
ms.date: 05/23/2023
55
ms.topic: overview
66
---
@@ -16,12 +16,9 @@ To create a WinGet Configuration file:
1616
5. Determine the directives and settings needed for each configuration resource.
1717
6. Determine the dependencies for each resource.
1818

19-
> [!IMPORTANT]
20-
> WinGet Configuration is currently in preview. To use a WinGet Configuration file with the [`winget configure` command](../winget/configure.md), you must first [enable the experimental configuration feature](index.md#enable-the-winget-configuration-experimental-configuration-preview-feature).
21-
2219
## File format
2320

24-
Windows Package Manager uses manifests (YAML files) to locate and install packages for Windows users. WinGet Configuration files use the same YAML style format, adding a JSON schema specification to help define the structure and validation of the file. To further assist in detecting whether the format of your WinGet Configuration file is valid, we recomend using [Visual Studio Code](https://code.visualstudio.com/download) with the [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) by RedHat to support proper syntax, help detect any formatting errors, provide hover support and auto-completion (when linked to the JSON schema file), and ensure valid formatting.
21+
Windows Package Manager uses manifests (YAML files) to locate and install packages for Windows users. WinGet Configuration files use the same YAML style format, adding a JSON schema specification to help define the structure and validation of the file. To further assist in detecting whether the format of your WinGet Configuration file is valid, we recommend using [Visual Studio Code](https://code.visualstudio.com/download) with the [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) by RedHat to support proper syntax, help detect any formatting errors, provide hover support and auto-completion (when linked to the JSON schema file), and ensure valid formatting.
2522

2623
### File naming convention
2724

hub/package-manager/configuration/index.md

Lines changed: 4 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: WinGet Configuration
3-
description: WinGet Configuration uses the winget configure command, PowerShell, and a YAML-formatted configuration file listing all of the software versions, packages, tools, and settings required to achieve the set up the desired state of the development environment on your Windows machine. Minimizing manual project setup and onboarding to a single command that is reliable and repeatable.
3+
description: WinGet Configuration uses the winget configure command, PowerShell, and a YAML-formatted configuration file listing all of the software versions, packages, tools, and settings required to achieve the set up the desired state of the development environment on your Windows machine. Minimizing manual project setup and onboarding to a single command that is reliable and repeatable.
44
ms.date: 07/10/2023
55
ms.topic: overview
66
---
@@ -13,9 +13,6 @@ Using a WinGet Configuration file, you can consolidate manual machine setup and
1313
- [PowerShell Desired State Configuration (DSC)](/powershell/dsc/overview) to automate the configuration of your Windows operating system.
1414
- The Windows Package Manager [`winget configure` command](../winget/configure.md) to initiate the configuration process.
1515

16-
> [!IMPORTANT]
17-
> WinGet Configuration is currently in preview. To use a WinGet Configuration file with the [`winget configure` command](../winget/configure.md), you must first [enable the experimental configuration feature](#enable-the-winget-configuration-experimental-configuration-preview-feature).
18-
1916
## Benefits for machine setup and project onboarding
2017

2118
The benefits of using a WinGet Configuration file include:
@@ -33,27 +30,7 @@ To set up your machine using a WinGet Configuration file, you can:
3330

3431
1. [Install Dev Home](../../dev-home/index.md), go to **Machine configuration**, select **Configuration file**, and choose the WinGet configuration file that you would like to use. (To create a configuration file, see [How to author a WinGet Configuration file](create.md)).
3532

36-
2. Use [winget configure](../winget/configure.md) in the command line. To use the `winget configure` command, you must be running the preview version of Windows Package Manager and must first [enable the Experimental feature](#enable-the-winget-configuration-experimental-configuration-preview-feature).
37-
38-
## Enable the WinGet Configuration experimental configuration preview feature
39-
40-
In order to use a WinGet Configuration file with the [`winget configure` command](../winget/configure.md):
41-
42-
1. Confirm you're running the [Preview version of WinGet](../winget/index.md#install-winget-preview-version-developers-only).
43-
44-
2. Enter the command: `winget features` to display a list of available experimental features.
45-
46-
3. Enter the command: `winget settings` to open the WinGet Settings file in your default text editor. The WinGet Settings file uses a JSON format.
47-
48-
4. In your WinGet Settings JSON file, enter:
49-
50-
```json
51-
"experimentalFeatures": {
52-
"configuration": true
53-
}
54-
```
55-
56-
Features may be managed by your workplace group policy, potentially blocking your ability to use experimental features. You can use the `winget --info` command to view any policies in effect on your system.
33+
2. Use [winget configure](../winget/configure.md) in the command line. To use the `winget configure` command, you must be running WinGet version [v1.6.2631 or later](https://github.com/microsoft/winget-cli/releases).
5734

5835
## WinGet Configuration FAQs
5936

@@ -100,7 +77,7 @@ We recommend ALWAYS validating the integrity of a WinGet Configuration file befo
10077

10178
### Where can I find sample WinGet Configuration files?
10279

103-
For WinGet Configuration file samples, see [Sample configuration.dsc.yaml files](https://gist.github.com/denelon/dc646f538b4ffd6993878cf545c7918f).
80+
For WinGet Configuration file samples, see [Sample configuration.dsc.yaml files](https://github.com/microsoft/devhome/tree/main/sampleConfigurations).
10481

10582
### When will WinGet configuration move from a preview to a stable feature?
10683

@@ -114,7 +91,7 @@ The [PowerShell Gallery](https://www.powershellgallery.com/packages) hosts hundr
11491

11592
### Can I set up a policy to block the use of WinGet Configuration files in my organization?
11693

117-
[Group Policy Objects](/microsoft-365/compliance/device-onboarding-gp) are available for disabling all experimental features. New Group Policy Objects will be created for more fine-grained control before WinGet configuration is shipped as a stable product.
94+
Yes. [Group Policy Objects](/microsoft-365/compliance/device-onboarding-gp) **EnableWindowsPackageManagerConfiguration** and **EnableWindowsPackageManagerConfigurationExplanation** can be utilized for disabling WinGet Configuration feature in your organization.
11895

11996
## Troubleshooting WinGet Configurations
12097

hub/package-manager/winget/configure.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,13 @@ ms.localizationpriority: medium
1010

1111
The **configure** command of the [winget](./index.md) tool uses a [WinGet Configuration file](../configuration/index.md) to begin setting up your Windows machine to a desired development environment state.
1212

13-
> [!IMPORTANT]
14-
> WinGet Configuration is currently in preview. To use a WinGet Configuration file with the [`winget configure` command](../winget/configure.md), you must first [enable the experimental configuration feature](../configuration/index.md#enable-the-winget-configuration-experimental-configuration-preview-feature).
15-
1613
> [!WARNING]
1714
> Do not run a WinGet Configuration file without first reviewing the contents of the file and verifying the credibility of the related resources. See [How to check the trustworthiness of a WinGet Configuration file](../configuration/check.md).
1815
1916
## Prerequisites
2017

2118
- Windows 10 RS5 or later, and Windows 11.
22-
- Winget version v1.5.1572 or later.
19+
- WinGet version [v1.6.2631 or later](https://github.com/microsoft/winget-cli/releases).
2320

2421
## Usage
2522

0 commit comments

Comments
 (0)