From 8fb3142905a1c84a1b6f246258f923a299ec45b8 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 12:17:06 +0200 Subject: [PATCH 01/16] Add version -preview.11 --- docs/prerelease-changelog.md | 125 ++++++++++++++++++++++++++++++++++- 1 file changed, 123 insertions(+), 2 deletions(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index f257c74f0..faaf48196 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.8...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.11...main +## [v3.0.0-preview.11][release-v3.0.0-preview.11] - 2024-10-24 + +This section includes a summary of changes for the `preview.11` release. For the full list of changes +in this release, see the [diff on GitHub][compare-v3.0.0-preview.11]. + + +[release-v3.0.0-preview.11]: https://github.com/PowerShell/DSC/releases/tag/v3.0.0-preview.11 "Link to the DSC v3.0.0-preview.11 release on GitHub" +[compare-v3.0.0-preview.11]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.10...v3.0.0-preview.11 + +### Changed + +- Renamed the resource `kind` value `Import` to `Importer`. If your resource manifest sets the + `kind` property to `Import`, update it to `Importer`. + +
Related work items + + - Issues:[#436][#436]. + - PRs: [#552][#552] + +
+ +- Improved performance for the adapter lookup table used to resolve adapted resources, reducing + lookup overhead during operations. See also [dsc resource list][p10-aa]. + +
Related work items + + - Issues: _None_. + - PRs: [#568][#568] + +
+ +- `dsc` now returns a non-zero exit code when a requested resource isn't found, making failures + easier to detect in automation. + +
Related work items + + - Issues: _None_. + - PRs: [#561][#561] + +
+ +- Changed the Echo test resource to `Microsoft.DSC.Debug/Echo`. + +
Related work items + + - Issues: [#537][#537]. + - PRs: [#553][#553] + +
+ +### Added + +- Added example configurations for common Windows baselines to help users get started. + +
Related work items + + - Issues: _None_. + - PRs: [#572][#572] + +
+ +### Fixed + +- Class-based PowerShell DSC Resources no longer include hidden properties in their output. + +
Related work items + + - Issues: [#157][#157]. + - PRs: [#556][#556] + +
+ +- Improved trace messaging for the `Microsoft.Windows/Registry` resource, emitting messages at the + proper levels. + +
Related work items + + - Issues: _None_. + - PRs: [#555][#555] + +
+ +- Fixed input schema validation for the `Microsoft.Windows/RebootPending` resource. + +
Related work items + + - Issues: [#485][#485]. + - PRs: [#488][#488] + +
+ +- Fixed a regression in the PowerShell adapter `Test` operation. + +
Related work items + + - Issues: _None_. + - PRs: [#565][#565] + +
+ ## [v3.0.0-preview.10][release-v3.0.0-preview.10] - 2024-09-17 This section includes a summary of changes for the `preview.10` release. For the full list of changes @@ -1795,6 +1895,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#139]: https://github.com/PowerShell/DSC/issues/139 [#150]: https://github.com/PowerShell/DSC/issues/150 [#156]: https://github.com/PowerShell/DSC/issues/156 +[#157]: https://github.com/PowerShell/DSC/issues/157 [#158]: https://github.com/PowerShell/DSC/issues/158 [#159]: https://github.com/PowerShell/DSC/issues/159 [#162]: https://github.com/PowerShell/DSC/issues/162 @@ -1905,6 +2006,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#432]: https://github.com/PowerShell/DSC/issues/432 [#434]: https://github.com/PowerShell/DSC/issues/434 [#435]: https://github.com/PowerShell/DSC/issues/435 +[#436]: https://github.com/PowerShell/DSC/issues/436 [#438]: https://github.com/PowerShell/DSC/issues/438 [#439]: https://github.com/PowerShell/DSC/issues/439 [#441]: https://github.com/PowerShell/DSC/issues/441 @@ -1925,6 +2027,8 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#481]: https://github.com/PowerShell/DSC/issues/481 [#482]: https://github.com/PowerShell/DSC/issues/482 [#484]: https://github.com/PowerShell/DSC/issues/484 +[#485]: https://github.com/PowerShell/DSC/issues/485 +[#488]: https://github.com/PowerShell/DSC/issues/488 [#487]: https://github.com/PowerShell/DSC/issues/487 [#489]: https://github.com/PowerShell/DSC/issues/489 [#49]: https://github.com/PowerShell/DSC/issues/49 @@ -1938,7 +2042,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#503]: https://github.com/PowerShell/DSC/issues/503 [#504]: https://github.com/PowerShell/DSC/issues/504 [#505]: https://github.com/PowerShell/DSC/issues/505 -[#506]: https://github.com/PowerShell/DSC/issues/504 +[#506]: https://github.com/PowerShell/DSC/issues/506 [#509]: https://github.com/PowerShell/DSC/issues/509 [#511]: https://github.com/PowerShell/DSC/issues/511 [#512]: https://github.com/PowerShell/DSC/issues/512 @@ -1953,9 +2057,26 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#533]: https://github.com/PowerShell/DSC/issues/533 [#541]: https://github.com/PowerShell/DSC/issues/541 [#548]: https://github.com/PowerShell/DSC/issues/548 +[#549]: https://github.com/PowerShell/DSC/issues/549 +[#551]: https://github.com/PowerShell/DSC/issues/551 +[#552]: https://github.com/PowerShell/DSC/issues/552 +[#553]: https://github.com/PowerShell/DSC/issues/553 +[#555]: https://github.com/PowerShell/DSC/issues/555 +[#556]: https://github.com/PowerShell/DSC/issues/556 +[#561]: https://github.com/PowerShell/DSC/issues/561 +[#564]: https://github.com/PowerShell/DSC/issues/564 +[#565]: https://github.com/PowerShell/DSC/issues/565 +[#568]: https://github.com/PowerShell/DSC/issues/568 +[#572]: https://github.com/PowerShell/DSC/issues/572 +[#573]: https://github.com/PowerShell/DSC/issues/573 +[#577]: https://github.com/PowerShell/DSC/issues/577 [#57]: https://github.com/PowerShell/DSC/issues/57 [#70]: https://github.com/PowerShell/DSC/issues/70 [#73]: https://github.com/PowerShell/DSC/issues/73 [#75]: https://github.com/PowerShell/DSC/issues/75 [#89]: https://github.com/PowerShell/DSC/issues/89 [#98]: https://github.com/PowerShell/DSC/issues/98 +[#157]: https://github.com/PowerShell/DSC/issues/157 +[#436]: https://github.com/PowerShell/DSC/issues/436 +[#485]: https://github.com/PowerShell/DSC/issues/485 +[#537]: https://github.com/PowerShell/DSC/issues/537 From 3bf062ffba7cc8cc750dbdda137e76cc258142ec Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 12:26:40 +0200 Subject: [PATCH 02/16] Add version -preview.12 --- docs/prerelease-changelog.md | 117 ++++++++++++++++++++++++++++++++++- 1 file changed, 115 insertions(+), 2 deletions(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index faaf48196..07e38d85d 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -8,7 +8,7 @@ ms.date: 06/24/2024 # Changelog - + -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.11...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.12...main + + +## [v3.0.0-preview.12][release-v3.0.0-preview.12] - 2024-12-10 + +This section includes a summary of changes for the `preview.12` release. For the full list of changes +in this release, see the [diff on GitHub][compare-v3.0.0-preview.12]. + + +[release-v3.0.0-preview.12]: https://github.com/PowerShell/DSC/releases/tag/v3.0.0-preview.12 "Link to the DSC v3.0.0-preview.12 release on GitHub" +[compare-v3.0.0-preview.12]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.11...v3.0.0-preview.12 + +### Changed + +- Allow multiple `export` methods for class-based PSDSC resources in the PowerShell adapter. + +
Related work items + + - Issues: [#578][#578]. + - PRs: [#579][#579] + +
+ +- Change how to pass STDIN via the CLI and rename several arguments for consistency: + `--file -` indicates read-from-STDIN; `--format` is now `--output-format` (short `-o`); + `--document` is now `--input`; and the shorthand for `--trace-format` is now `-t`. + +
Related work items + + - Issues: [#588][#588]. + - PRs: [#601][#601] + +
+ +- Internationalization updates for resources and packaging tweaks: + - Make `Microsoft.DSC.Debug/dscecho` resource internationalization compliant. + - Internationalize `Microsoft.DSC.Transitional/RunCommandOnSet`. + +
Related work items + + - Issues: _None_. + - PRs: [#606][#606], [#608][#608] + +
+ +### Added + +- Add `--system-root` parameter to `dsc`, plus new configuration functions `systemRoot()` and + `path()` to support offline configuration scenarios and OS-appropriate path joining. + +
Related work items + + - Issues: [#534][#534]. + - PRs: [#589][#589] + +
+ +- Add DSC meta configuration support (settings/policy JSON files), including default and policy + settings files. + +
Related work items + + - Issues: [#282][#282]. + - PRs: [#574][#574] + +
+ +- Include the `Microsoft/OSInfo` resource in release packages. + +
Related work items + + - Issues: _None_. + - PRs: [#606][#606] + +
+ +### Fixed + +- Fix output of the `Microsoft.DSC/Assertion` resource when running `test` so it resembles a + configuration and add array comparison support to the synthetic diff. + +
Related work items + + - Issues: [#165][#165]. + - PRs: [#595][#595] + +
+ +- Fix VS Code settings for the `dscecho` resource to align with the renamed project. + +
Related work items + + - Issues: _None_. + - PRs: [#597][#597] + +
+ ## [v3.0.0-preview.11][release-v3.0.0-preview.11] - 2024-10-24 This section includes a summary of changes for the `preview.11` release. For the full list of changes @@ -2080,3 +2176,20 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#436]: https://github.com/PowerShell/DSC/issues/436 [#485]: https://github.com/PowerShell/DSC/issues/485 [#537]: https://github.com/PowerShell/DSC/issues/537 + +[#282]: https://github.com/PowerShell/DSC/issues/282 +[#534]: https://github.com/PowerShell/DSC/issues/534 +[#578]: https://github.com/PowerShell/DSC/issues/578 +[#588]: https://github.com/PowerShell/DSC/issues/588 +[#574]: https://github.com/PowerShell/DSC/pull/574 +[#579]: https://github.com/PowerShell/DSC/pull/579 +[#581]: https://github.com/PowerShell/DSC/pull/581 +[#587]: https://github.com/PowerShell/DSC/pull/587 +[#589]: https://github.com/PowerShell/DSC/pull/589 +[#595]: https://github.com/PowerShell/DSC/pull/595 +[#597]: https://github.com/PowerShell/DSC/pull/597 +[#601]: https://github.com/PowerShell/DSC/pull/601 +[#603]: https://github.com/PowerShell/DSC/pull/603 +[#606]: https://github.com/PowerShell/DSC/pull/606 +[#608]: https://github.com/PowerShell/DSC/pull/608 +[#609]: https://github.com/PowerShell/DSC/pull/609 From dd82dd2474d4fe5816ebf20390f37e3780ad099b Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 12:35:45 +0200 Subject: [PATCH 03/16] Add version -rc.1 --- docs/prerelease-changelog.md | 122 ++++++++++++++++++++++++++++++++++- 1 file changed, 120 insertions(+), 2 deletions(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 07e38d85d..83f696563 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -8,7 +8,7 @@ ms.date: 06/24/2024 # Changelog - + -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.12...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-rc.1...main +## [v3.0.0-rc.1][release-v3.0.0-rc.1] - 2025-02-06 +This section includes a summary of changes for the `rc.1` release. For the full list of changes +in this release, see the [diff on GitHub][compare-v3.0.0-rc.1]. + + +[release-v3.0.0-rc.1]: https://github.com/PowerShell/DSC/releases/tag/v3.0.0-rc.1 "Link to the DSC v3.0.0-rc.1 release on GitHub" +[compare-v3.0.0-rc.1]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.12...v3.0.0-rc.1 + +### Changed + +- Internationalize the `dsc` CLI. Localized user-facing strings and removed redundant prefixes + from some error messages. + +
Related work items + + - Issues: _None_. + - PRs: [#612][#612] + +
+ +- Change the behavior of `reference()` to use the raw output of a resource instead of the + DSC-decorated output. This makes configurations reusable across `get`, `test`, `set`, and + `export` operations. + +
Related work items + + - Issues: [#389][#389]. + - PRs: [#634][#634] + +
+ +- Ensure `systemRoot()` always includes a trailing path separator (and have `path()` adopt this + behavior). This aligns behavior across platforms and avoids path-join surprises on Windows. + +
Related work items + + - Issues: _None_. + - PRs: [#616][#616] + +
+ +- Update README to remove the outdated mention of a dependency on the PSDSC module. + +
Related work items + + - Issues: _None_. + - PRs: [#623][#623] + +
+ +### Added + +- Add support for the `contentVersion` property in configuration documents. If present in input, + the value is accepted but not validated; generated configurations (for example, `export`) set + `contentVersion` to `1.0.0`. + +
Related work items + + - Issues: _None_. + - PRs: [#621][#621] + +
+ +- Enable the `Microsoft.DSC/Include` resource to accept configuration and parameters as string + content with `configurationContent` and `parametersContent` (in addition to the existing + `configurationFile` and `parametersFile`). + +
Related work items + + - Issues: _None_. + - PRs: [#626][#626] + +
+ +- Support writing progress as JSON with a new `--progress-format` (`-p`) root option. When set to + `json`, progress messages are also emitted to STDERR as JSON objects. + +
Related work items + + - Issues: [#592][#592]. + - PRs: [#614][#614] + +
+ +### Fixed + +- Fix built-in resource and settings discovery when `dsc` is invoked via a symlink (for example, + when installed by WinGet), ensuring built-ins are found correctly. + +
Related work items + + - Issues: [#618][#618]. + - PRs: [#625][#625] + +
+ +- Fix table header resource IDs casing mismatch between code and localization file for consistent + table output. + +
Related work items + + - Issues: _None_. + - PRs: [#629][#629] + +
## [v3.0.0-preview.12][release-v3.0.0-preview.12] - 2024-12-10 @@ -2193,3 +2298,16 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#606]: https://github.com/PowerShell/DSC/pull/606 [#608]: https://github.com/PowerShell/DSC/pull/608 [#609]: https://github.com/PowerShell/DSC/pull/609 +[#612]: https://github.com/PowerShell/DSC/pull/612 +[#614]: https://github.com/PowerShell/DSC/pull/614 +[#616]: https://github.com/PowerShell/DSC/pull/616 +[#621]: https://github.com/PowerShell/DSC/pull/621 +[#623]: https://github.com/PowerShell/DSC/pull/623 +[#625]: https://github.com/PowerShell/DSC/pull/625 +[#626]: https://github.com/PowerShell/DSC/pull/626 +[#629]: https://github.com/PowerShell/DSC/pull/629 +[#631]: https://github.com/PowerShell/DSC/pull/631 +[#634]: https://github.com/PowerShell/DSC/pull/634 +[#389]: https://github.com/PowerShell/DSC/issues/389 +[#592]: https://github.com/PowerShell/DSC/issues/592 +[#618]: https://github.com/PowerShell/DSC/issues/618 From bb61d30ec2e0b7f6ab5559966d29ec9090e639aa Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 12:47:26 +0200 Subject: [PATCH 04/16] Add version v3.1.0-preview.1 --- docs/prerelease-changelog.md | 183 ++++++++++++++++++++++++++++++++--- 1 file changed, 169 insertions(+), 14 deletions(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 83f696563..e8be8ad18 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.0-rc.1...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.1...main + + +## [v3.1.0-preview.1][release-v3.1.0-preview.1] - 2025-03-18 + +This section includes a summary of changes for the `v3.1.0-preview.1` release. For the full list of +changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.1]. + + +[release-v3.1.0-preview.1]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.1 "Link to the DSC v3.1.0-preview.1 release on GitHub" +[compare-v3.1.0-preview.1]: https://github.com/PowerShell/DSC/compare/v3.0.0-rc.1...v3.1.0-preview.1 + +### Changed + +- Add object separators to YAML output (`---`) when multiple objects are emitted. + +
Related work items + + - Issues: [#628][#628]. + - PRs: [#635][#635] + +
+ +- Enhance progress output: improve JSON progress format, add `None` option, and refine the progress schema. + +
Related work items + + - Issues: _None_. + - PRs: [#644][#644] + +
+ +- Canonicalize casing across `dsc_lib` to ensure camelCase for property names and enum values; allow camelCase alias for the tracing `line_number` field. + +
Related work items + + - Issues: [#642][#642]. + - PRs: [#648][#648], [#645][#645] + +
+ +- Emit a warning during discovery if an executable referenced by a resource manifest can't be found. + +
Related work items + + - Issues: _None_. + - PRs: [#688][#688] + +
+ +- Improve tracing and ensure `_inDesiredState` aggregation is surfaced consistently in the PowerShell adapter. + +
Related work items + + - Issues: _None_. + - PRs: [#699][#699] + +
+ +### Added + +- Add `exporter` resource kind for generating complete resource instances as JSON Lines during export. + +
Related work items + + - Issues: [#515][#515]. + - PRs: [#682][#682] + +
+ +- Support passing input to direct resource `export` via CLI arguments. + +
Related work items + + - Issues: [#678][#678]. + - PRs: [#680][#680] + +
+ +- Preserve custom metadata when exporting a configuration. + +
Related work items + + - Issues: [#668][#668]. + - PRs: [#679][#679] + +
+ +### Fixed + +- Validate modules in the PowerShell adapter cache to address configuration size limits. + +
Related work items + + - Issues: [#640][#640]. + - PRs: [#647][#647] + +
+ +- Respect a resource-provided `_inDesiredState` value from `test` results instead of relying solely on diff. + +
Related work items + + - Issues: [#674][#674]. + - PRs: [#676][#676] + +
+ +- Allow resources in configuration documents to omit the `properties` object when not needed. + +
Related work items + + - Issues: _None_. + - PRs: [#675][#675] + +
+ +- Permit setting a Windows registry value with no data (use the `None` type) and improve related handling. + +
Related work items + + - Issues: [#683][#683]. + - PRs: [#684][#684] + +
+ +- Parse expressions correctly for `Group` resources (skip premature evaluation so the group can resolve within its scope). + +
Related work items + + - Issues: [#692][#692]. + - PRs: [#695][#695] + +
+ +- Ensure `RunCommandOnSet` works within configuration documents (adds `implementsPreTest` and tests). + +
Related work items + + - Issues: [#658][#658]. + - PRs: [#659][#659] + +
+ ## [v3.0.0-rc.1][release-v3.0.0-rc.1] - 2025-02-06 This section includes a summary of changes for the `rc.1` release. For the full list of changes @@ -2258,28 +2401,20 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#533]: https://github.com/PowerShell/DSC/issues/533 [#541]: https://github.com/PowerShell/DSC/issues/541 [#548]: https://github.com/PowerShell/DSC/issues/548 -[#549]: https://github.com/PowerShell/DSC/issues/549 -[#551]: https://github.com/PowerShell/DSC/issues/551 [#552]: https://github.com/PowerShell/DSC/issues/552 [#553]: https://github.com/PowerShell/DSC/issues/553 [#555]: https://github.com/PowerShell/DSC/issues/555 [#556]: https://github.com/PowerShell/DSC/issues/556 [#561]: https://github.com/PowerShell/DSC/issues/561 -[#564]: https://github.com/PowerShell/DSC/issues/564 [#565]: https://github.com/PowerShell/DSC/issues/565 [#568]: https://github.com/PowerShell/DSC/issues/568 [#572]: https://github.com/PowerShell/DSC/issues/572 -[#573]: https://github.com/PowerShell/DSC/issues/573 -[#577]: https://github.com/PowerShell/DSC/issues/577 [#57]: https://github.com/PowerShell/DSC/issues/57 [#70]: https://github.com/PowerShell/DSC/issues/70 [#73]: https://github.com/PowerShell/DSC/issues/73 [#75]: https://github.com/PowerShell/DSC/issues/75 [#89]: https://github.com/PowerShell/DSC/issues/89 [#98]: https://github.com/PowerShell/DSC/issues/98 -[#157]: https://github.com/PowerShell/DSC/issues/157 -[#436]: https://github.com/PowerShell/DSC/issues/436 -[#485]: https://github.com/PowerShell/DSC/issues/485 [#537]: https://github.com/PowerShell/DSC/issues/537 [#282]: https://github.com/PowerShell/DSC/issues/282 @@ -2288,16 +2423,12 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#588]: https://github.com/PowerShell/DSC/issues/588 [#574]: https://github.com/PowerShell/DSC/pull/574 [#579]: https://github.com/PowerShell/DSC/pull/579 -[#581]: https://github.com/PowerShell/DSC/pull/581 -[#587]: https://github.com/PowerShell/DSC/pull/587 [#589]: https://github.com/PowerShell/DSC/pull/589 [#595]: https://github.com/PowerShell/DSC/pull/595 [#597]: https://github.com/PowerShell/DSC/pull/597 [#601]: https://github.com/PowerShell/DSC/pull/601 -[#603]: https://github.com/PowerShell/DSC/pull/603 [#606]: https://github.com/PowerShell/DSC/pull/606 [#608]: https://github.com/PowerShell/DSC/pull/608 -[#609]: https://github.com/PowerShell/DSC/pull/609 [#612]: https://github.com/PowerShell/DSC/pull/612 [#614]: https://github.com/PowerShell/DSC/pull/614 [#616]: https://github.com/PowerShell/DSC/pull/616 @@ -2306,8 +2437,32 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#625]: https://github.com/PowerShell/DSC/pull/625 [#626]: https://github.com/PowerShell/DSC/pull/626 [#629]: https://github.com/PowerShell/DSC/pull/629 -[#631]: https://github.com/PowerShell/DSC/pull/631 [#634]: https://github.com/PowerShell/DSC/pull/634 [#389]: https://github.com/PowerShell/DSC/issues/389 [#592]: https://github.com/PowerShell/DSC/issues/592 [#618]: https://github.com/PowerShell/DSC/issues/618 +[#515]: https://github.com/PowerShell/DSC/issues/515 +[#628]: https://github.com/PowerShell/DSC/issues/628 +[#640]: https://github.com/PowerShell/DSC/issues/640 +[#642]: https://github.com/PowerShell/DSC/issues/642 +[#658]: https://github.com/PowerShell/DSC/issues/658 +[#668]: https://github.com/PowerShell/DSC/issues/668 +[#674]: https://github.com/PowerShell/DSC/issues/674 +[#678]: https://github.com/PowerShell/DSC/issues/678 +[#683]: https://github.com/PowerShell/DSC/issues/683 +[#692]: https://github.com/PowerShell/DSC/issues/692 +[#635]: https://github.com/PowerShell/DSC/pull/635 +[#644]: https://github.com/PowerShell/DSC/pull/644 +[#645]: https://github.com/PowerShell/DSC/pull/645 +[#647]: https://github.com/PowerShell/DSC/pull/647 +[#648]: https://github.com/PowerShell/DSC/pull/648 +[#659]: https://github.com/PowerShell/DSC/pull/659 +[#675]: https://github.com/PowerShell/DSC/pull/675 +[#676]: https://github.com/PowerShell/DSC/pull/676 +[#679]: https://github.com/PowerShell/DSC/pull/679 +[#680]: https://github.com/PowerShell/DSC/pull/680 +[#682]: https://github.com/PowerShell/DSC/pull/682 +[#684]: https://github.com/PowerShell/DSC/pull/684 +[#688]: https://github.com/PowerShell/DSC/pull/688 +[#695]: https://github.com/PowerShell/DSC/pull/695 +[#699]: https://github.com/PowerShell/DSC/pull/699 From 9378c2d973a4d4324395c525df8af4d80eccab4a Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 12:50:29 +0200 Subject: [PATCH 05/16] Add version v3.1.0-preview.2 --- docs/prerelease-changelog.md | 39 ++++++++++++++++++++++++++++++++++-- 1 file changed, 37 insertions(+), 2 deletions(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index e8be8ad18..b9b300390 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -8,7 +8,7 @@ ms.date: 06/24/2024 # Changelog - + -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.1...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.2...main +[release-v3.1.0-preview.2]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.2 "Link to the DSC v3.1.0-preview.2 release on GitHub" +[compare-v3.1.0-preview.2]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.1...v3.1.0-preview.2 + +### Changed + +- Enable using adapter resources without the adapter wrapper. + +
Related work items + + - Issues: [#693][#693]. + - PRs: [#720][#720] + +
+ +### Added + +- Add validation to check key-value pairs for class-based and script-based DSC resources. + +
Related work items + + - Issues: [#709][#709]. + - PRs: [#713][#713] + +
+ ## [v3.1.0-preview.1][release-v3.1.0-preview.1] - 2025-03-18 This section includes a summary of changes for the `v3.1.0-preview.1` release. For the full list of @@ -2451,6 +2482,8 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#678]: https://github.com/PowerShell/DSC/issues/678 [#683]: https://github.com/PowerShell/DSC/issues/683 [#692]: https://github.com/PowerShell/DSC/issues/692 +[#693]: https://github.com/PowerShell/DSC/issues/693 +[#709]: https://github.com/PowerShell/DSC/issues/709 [#635]: https://github.com/PowerShell/DSC/pull/635 [#644]: https://github.com/PowerShell/DSC/pull/644 [#645]: https://github.com/PowerShell/DSC/pull/645 @@ -2466,3 +2499,5 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#688]: https://github.com/PowerShell/DSC/pull/688 [#695]: https://github.com/PowerShell/DSC/pull/695 [#699]: https://github.com/PowerShell/DSC/pull/699 +[#713]: https://github.com/PowerShell/DSC/pull/713 +[#720]: https://github.com/PowerShell/DSC/pull/720 From 37ecf807b1085219b296d1a2f69ca5074ecb95eb Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 12:55:48 +0200 Subject: [PATCH 06/16] Add version v3.1.0-preview.3 --- docs/prerelease-changelog.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index b9b300390..cab973c5e 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -73,7 +73,35 @@ changes since the last release, see the [diff on GitHub][unreleased]. +## [v3.1.0-preview.3][release-v3.1.0-preview.3] - 2025-04-08 +This section includes a summary of changes for the `v3.1.0-preview.3` release. For the full list of +changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.3]. + + +[release-v3.1.0-preview.3]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.3 "Link to the DSC v3.1.0-preview.3 release on GitHub" +[compare-v3.1.0-preview.3]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.2...v3.1.0-preview.3 + +### Fixed + +- Fix `Assertion` resource to fail when test fails. + +
Related work items + + - Issues: [#731][#731]. + - PRs: [#736][#736] + +
+ +- Set `Bypass` execution policy when calling PowerShell from the adapter to avoid failures on + Windows with restricted execution policy. + +
Related work items + + - Issues: [#714][#714]. + - PRs: [#715][#715] + +
## [v3.1.0-preview.2][release-v3.1.0-preview.2] - 2025-04-01 @@ -2501,3 +2529,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#699]: https://github.com/PowerShell/DSC/pull/699 [#713]: https://github.com/PowerShell/DSC/pull/713 [#720]: https://github.com/PowerShell/DSC/pull/720 +[#714]: https://github.com/PowerShell/DSC/issues/714 +[#715]: https://github.com/PowerShell/DSC/pull/715 +[#731]: https://github.com/PowerShell/DSC/issues/731 +[#736]: https://github.com/PowerShell/DSC/pull/736 From b62f2b4e2102882f6cbc2c709a814ec2ac013ca7 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 13:02:02 +0200 Subject: [PATCH 07/16] Add version v3.1.0-preview.3 --- docs/prerelease-changelog.md | 55 +++++++++++++++++++++++++++++++++++- 1 file changed, 54 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index cab973c5e..1f60f8f62 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.2...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.4...main + + +## [v3.1.0-preview.4][release-v3.1.0-preview.4] - 2025-04-29 + +This section includes a summary of changes for the `v3.1.0-preview.4` release. For the full list of +changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.4]. + + +[release-v3.1.0-preview.4]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.4 "Link to the DSC v3.1.0-preview.4 release on GitHub" +[compare-v3.1.0-preview.4]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.3...v3.1.0-preview.4 + +### Added + +- Add credential support on PowerShell adapters to create PSCredential objects from input when the + target property expects a credential. + +
Related work items + + - Issues: [#328][#328]. + - PRs: [#758][#758] + +
+ +### Changed + +- Prefer Windows PowerShell modules first in the Windows PowerShell adapter by prepending the + Windows module path; add a warning when a resource isn't found (resource must be installed for + AllUsers). + +
Related work items + + - Issues: _None_. + - PRs: [#764][#764] + +
+ +### Fixed + +- Fix resource cache behavior when PowerShell modules are installed during a run so subsequent + modules aren't lost from the cache. + +
Related work items + + - Issues: [#745][#745]. + - PRs: [#748][#748] + +
+ ## [v3.1.0-preview.3][release-v3.1.0-preview.3] - 2025-04-08 This section includes a summary of changes for the `v3.1.0-preview.3` release. For the full list of @@ -2363,6 +2411,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#321]: https://github.com/PowerShell/DSC/issues/321 [#322]: https://github.com/PowerShell/DSC/issues/322 [#323]: https://github.com/PowerShell/DSC/issues/323 +[#328]: https://github.com/PowerShell/DSC/issues/328 [#329]: https://github.com/PowerShell/DSC/issues/329 [#333]: https://github.com/PowerShell/DSC/issues/333 [#334]: https://github.com/PowerShell/DSC/issues/334 @@ -2512,6 +2561,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#692]: https://github.com/PowerShell/DSC/issues/692 [#693]: https://github.com/PowerShell/DSC/issues/693 [#709]: https://github.com/PowerShell/DSC/issues/709 +[#745]: https://github.com/PowerShell/DSC/issues/745 [#635]: https://github.com/PowerShell/DSC/pull/635 [#644]: https://github.com/PowerShell/DSC/pull/644 [#645]: https://github.com/PowerShell/DSC/pull/645 @@ -2533,3 +2583,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#715]: https://github.com/PowerShell/DSC/pull/715 [#731]: https://github.com/PowerShell/DSC/issues/731 [#736]: https://github.com/PowerShell/DSC/pull/736 +[#748]: https://github.com/PowerShell/DSC/pull/748 +[#758]: https://github.com/PowerShell/DSC/pull/758 +[#764]: https://github.com/PowerShell/DSC/pull/764 From b50df4636ed3af8b8080ae7b70cdb184c4a55c2f Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 13:05:43 +0200 Subject: [PATCH 08/16] Add version v3.1.0-preview.5 --- docs/prerelease-changelog.md | 93 +++++++++++++++++++++++++++++++++++- 1 file changed, 92 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 1f60f8f62..6ad0e32be 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.4...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.5...main +[release-v3.1.0-preview.5]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.5 "Link to the DSC v3.1.0-preview.5 release on GitHub" +[compare-v3.1.0-preview.5]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.4...v3.1.0-preview.5 + +### Added + +- Add `equals()` configuration function for equality comparisons. + +
Related work items + + - Issues: [#767][#767]. + - PRs: [#770][#770] + +
+ +- Add `if()` configuration function for conditional selection. + +
Related work items + + - Issues: [#767][#767]. + - PRs: [#776][#776] + +
+ +- Add experimental `format()` configuration function for string formatting. Emits a warning when + used as it doesn't yet match all .NET format options. + +
Related work items + + - Issues: [#767][#767]. + - PRs: [#779][#779] + +
+ +- Add support for discovery extensions, including extension manifests and CLI support. + +
Related work items + + - Issues: [#681][#681]. + - PRs: [#760][#760] + +
+ +### Changed + +- For the Windows PowerShell adapter, remove PowerShell 7 paths from `PSModulePath` to avoid + discovering incompatible modules when running under PowerShell 7. + +
Related work items + + - Issues: [#707][#707]. + - PRs: [#777][#777] + +
+ +### Fixed + +- Add a null check in the PowerShell adapter when validating a property that may be `$null`. + +
Related work items + + - Issues: _None_. + - PRs: [#769][#769] + +
+ +- Fix adapter configuration `set` response mapping when using implicit PowerShell adapter wrapping + so `before_state` contains `resources` instead of `result`. + +
Related work items + + - Issues: _None_. + - PRs: [#774][#774] + +
+ ## [v3.1.0-preview.4][release-v3.1.0-preview.4] - 2025-04-29 This section includes a summary of changes for the `v3.1.0-preview.4` release. For the full list of @@ -2557,10 +2638,13 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#668]: https://github.com/PowerShell/DSC/issues/668 [#674]: https://github.com/PowerShell/DSC/issues/674 [#678]: https://github.com/PowerShell/DSC/issues/678 +[#681]: https://github.com/PowerShell/DSC/issues/681 [#683]: https://github.com/PowerShell/DSC/issues/683 [#692]: https://github.com/PowerShell/DSC/issues/692 [#693]: https://github.com/PowerShell/DSC/issues/693 +[#707]: https://github.com/PowerShell/DSC/issues/707 [#709]: https://github.com/PowerShell/DSC/issues/709 +[#767]: https://github.com/PowerShell/DSC/issues/767 [#745]: https://github.com/PowerShell/DSC/issues/745 [#635]: https://github.com/PowerShell/DSC/pull/635 [#644]: https://github.com/PowerShell/DSC/pull/644 @@ -2583,6 +2667,13 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#715]: https://github.com/PowerShell/DSC/pull/715 [#731]: https://github.com/PowerShell/DSC/issues/731 [#736]: https://github.com/PowerShell/DSC/pull/736 +[#760]: https://github.com/PowerShell/DSC/pull/760 +[#769]: https://github.com/PowerShell/DSC/pull/769 +[#770]: https://github.com/PowerShell/DSC/pull/770 +[#774]: https://github.com/PowerShell/DSC/pull/774 +[#776]: https://github.com/PowerShell/DSC/pull/776 +[#777]: https://github.com/PowerShell/DSC/pull/777 +[#779]: https://github.com/PowerShell/DSC/pull/779 [#748]: https://github.com/PowerShell/DSC/pull/748 [#758]: https://github.com/PowerShell/DSC/pull/758 [#764]: https://github.com/PowerShell/DSC/pull/764 From ce05d99fc01980c74b3dbf2980266ac2ec7ef677 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 13:13:11 +0200 Subject: [PATCH 09/16] Add version v3.1.0-preview.6 --- docs/prerelease-changelog.md | 106 ++++++++++++++++++++++++++++++++++- 1 file changed, 105 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 6ad0e32be..23a07d877 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.5...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.6...main +## [v3.1.0-preview.6][release-v3.1.0-preview.6] - 2025-05-22 +This section includes a summary of changes for the `v3.1.0-preview.6` release. For the full list of +changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6]. + + +[release-v3.1.0-preview.6]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.6 "Link to the DSC v3.1.0-preview.6 release on GitHub" +[compare-v3.1.0-preview.6]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.5...v3.1.0-preview.6 + +### Added + +- Experimental Appx resource discovery extension to discover resources packaged in Appx; also removes duplicate discoveries by type name and version. + +
Related work items + + - Issues: _None_. + - PRs: [#762][#762] + +
+ +- Add `table-no-truncate` format option to `dsc resource list` and `dsc extension list` to avoid truncating wide tables in narrow consoles. + +
Related work items + + - Issues: [#763][#763]. + - PRs: [#823][#823] + +
+ +### Changed + +- Windows PowerShell adapter: allow a workaround to detect class-based resources using type instances so class-based PSDSC resources are discoverable. + +
Related work items + + - Issues: [#798][#798]. + - PRs: [#797][#797] + +
+ +- WMI adapter: set execution policy to `Bypass` to align with PowerShell adapters and avoid failures under restricted policies. + +
Related work items + + - Issues: _None_. + - PRs: [#820][#820] + +
+ +### Fixed + +- Export adapted resources correctly by aligning `export` output to use the `result` property and fixing the test adapter. + +
Related work items + + - Issues: [#782][#782]. + - PRs: [#789][#789] + +
+ +- Windows PowerShell adapter caching: ensure full refresh when `PSModulePath` changes and on cold cache to avoid broken cache states from targeted refreshes. + +
Related work items + + - Issues: [#807][#807], [#745][#745]. + - PRs: [#787][#787] + +
+ +- Class-based detection: add validation ensuring the type instance has the `DscResource` attribute to avoid false positives for types with matching names. + +
Related work items + + - Issues: _None_. + - PRs: [#812][#812] + +
+ +- PowerShell adapter output: return enum string labels instead of integer values. + +
Related work items + + - Issues: [#791][#791]. + - PRs: [#800][#800] + +
## [v3.1.0-preview.5][release-v3.1.0-preview.5] - 2025-05-07 @@ -2677,3 +2762,22 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#748]: https://github.com/PowerShell/DSC/pull/748 [#758]: https://github.com/PowerShell/DSC/pull/758 [#764]: https://github.com/PowerShell/DSC/pull/764 +[#762]: https://github.com/PowerShell/DSC/pull/762 +[#763]: https://github.com/PowerShell/DSC/issues/763 +[#797]: https://github.com/PowerShell/DSC/pull/797 +[#798]: https://github.com/PowerShell/DSC/issues/798 +[#734]: https://github.com/PowerShell/DSC/pull/734 +[#717]: https://github.com/PowerShell/DSC/issues/717 +[#708]: https://github.com/PowerShell/DSC/issues/708 +[#819]: https://github.com/PowerShell/DSC/pull/819 +[#818]: https://github.com/PowerShell/DSC/issues/818 +[#820]: https://github.com/PowerShell/DSC/pull/820 +[#821]: https://github.com/PowerShell/DSC/pull/821 +[#782]: https://github.com/PowerShell/DSC/issues/782 +[#789]: https://github.com/PowerShell/DSC/pull/789 +[#807]: https://github.com/PowerShell/DSC/issues/807 +[#787]: https://github.com/PowerShell/DSC/pull/787 +[#812]: https://github.com/PowerShell/DSC/pull/812 +[#791]: https://github.com/PowerShell/DSC/issues/791 +[#800]: https://github.com/PowerShell/DSC/pull/800 +[#823]: https://github.com/PowerShell/DSC/pull/823 From 9dd62882bad83dade9a2c2e718dcb39b93e56497 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 13:17:54 +0200 Subject: [PATCH 10/16] Add version v3.1.0-preview.7 --- docs/prerelease-changelog.md | 99 +++++++++++++++++++++++++++++++++++- 1 file changed, 98 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 23a07d877..22df74bf9 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.6...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.7...main + + +## [v3.1.0-preview.7][release-v3.1.0-preview.7] - 2025-06-04 + +This section includes a summary of changes for the `v3.1.0-preview.7` release. For the full list of +changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.7]. + + +[release-v3.1.0-preview.7]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-preview.7 "Link to the DSC v3.1.0-preview.7 release on GitHub" +[compare-v3.1.0-preview.7]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.6...v3.1.0-preview.7 + +### Added + +- Windows PowerShell adapter: implement `export` capability to match the PowerShell adapter. + +
Related work items + + - Issues: [#811][#811]. + - PRs: [#848][#848] + +
+ +- Add `json-array` as a supported output format for `dsc resource get --all` to return a single JSON array instead of JSON Lines. + +
Related work items + + - Issues: [#813][#813]. + - PRs: [#861][#861] + +
+ +### Changed + +- Appx discovery extension: set execution policy to `Bypass` so it runs under restricted policies. + +
Related work items + + - Issues: _None_. + - PRs: [#850][#850] + +
+ +- Respect `DSC_RESOURCE_PATH` for executable lookup by aligning the process `PATH` to the same value so executable search is limited to `DSC_RESOURCE_PATH`. + +
Related work items + + - Issues: [#814][#814]. + - PRs: [#825][#825] + +
+ +### Fixed + +- Improve error message when duplicate resource names are detected during `set`. + +
Related work items + + - Issues: [#841][#841]. + - PRs: [#844][#844] + +
+ +- Windows registry resource: treat deleting a non-existing key/value as success instead of erroring. + +
Related work items + + - Issues: [#843][#843]. + - PRs: [#847][#847] + +
+ +- Windows PowerShell adapter: exclude hidden properties from output. + +
Related work items + + - Issues: [#832][#832]. + - PRs: [#855][#855] + +
+ ## [v3.1.0-preview.6][release-v3.1.0-preview.6] - 2025-05-22 This section includes a summary of changes for the `v3.1.0-preview.6` release. For the full list of @@ -2781,3 +2861,20 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#791]: https://github.com/PowerShell/DSC/issues/791 [#800]: https://github.com/PowerShell/DSC/pull/800 [#823]: https://github.com/PowerShell/DSC/pull/823 + +[#811]: https://github.com/PowerShell/DSC/issues/811 +[#813]: https://github.com/PowerShell/DSC/issues/813 +[#814]: https://github.com/PowerShell/DSC/issues/814 +[#830]: https://github.com/PowerShell/DSC/pull/830 +[#837]: https://github.com/PowerShell/DSC/pull/837 +[#838]: https://github.com/PowerShell/DSC/pull/838 +[#841]: https://github.com/PowerShell/DSC/issues/841 +[#843]: https://github.com/PowerShell/DSC/issues/843 +[#844]: https://github.com/PowerShell/DSC/pull/844 +[#847]: https://github.com/PowerShell/DSC/pull/847 +[#848]: https://github.com/PowerShell/DSC/pull/848 +[#850]: https://github.com/PowerShell/DSC/pull/850 +[#855]: https://github.com/PowerShell/DSC/pull/855 +[#861]: https://github.com/PowerShell/DSC/pull/861 +[#825]: https://github.com/PowerShell/DSC/pull/825 +[#832]: https://github.com/PowerShell/DSC/issues/832 From ad6322168eb59ec97343adab1fd69c402e8410a1 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 13:23:30 +0200 Subject: [PATCH 11/16] Add version v3.1.0-rc.1 --- docs/prerelease-changelog.md | 61 +++++++++++++++++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 22df74bf9..a0c08fe95 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.7...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-rc.1...main +[release-v3.1.0-rc.1]: https://github.com/PowerShell/DSC/releases/tag/v3.1.0-rc.1 "Link to the DSC v3.1.0-rc.1 release on GitHub" +[compare-v3.1.0-rc.1]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.7...v3.1.0-rc.1 + +### Added + +- Enable reading parameters from STDIN by allowing the parameters file name `-`. + +
Related work items + + - Issues: [#834][#834]. + - PRs: [#863][#863] + +
+ +- Add `pass-through` output format for `dsc resource get` to emit the resource's JSON without a DSC wrapper. + +
Related work items + + - Issues: _None_. + - PRs: [#862][#862] + +
+ +### Changed + +- Windows RebootPending resource: convert the pending reboot value to an object (removes a read-only property and keeps the field optional). + +
Related work items + + - Issues: [#858][#858]. + - PRs: [#859][#859] + +
+ +### Fixed + +- Fix regression in default output for `get --all` (ensure interactive default output is correct). + +
Related work items + + - Issues: [#866][#866]. + - PRs: [#875][#875] + +
+ ## [v3.1.0-preview.7][release-v3.1.0-preview.7] - 2025-06-04 This section includes a summary of changes for the `v3.1.0-preview.7` release. For the full list of @@ -2878,3 +2929,11 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#861]: https://github.com/PowerShell/DSC/pull/861 [#825]: https://github.com/PowerShell/DSC/pull/825 [#832]: https://github.com/PowerShell/DSC/issues/832 + +[#834]: https://github.com/PowerShell/DSC/issues/834 +[#858]: https://github.com/PowerShell/DSC/issues/858 +[#866]: https://github.com/PowerShell/DSC/issues/866 +[#862]: https://github.com/PowerShell/DSC/pull/862 +[#863]: https://github.com/PowerShell/DSC/pull/863 +[#875]: https://github.com/PowerShell/DSC/pull/875 +[#859]: https://github.com/PowerShell/DSC/pull/859 From d962f238ea812e681df6196946fac05f92880fb9 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 13:30:31 +0200 Subject: [PATCH 12/16] Add version v3.2.0-preview.1 --- docs/prerelease-changelog.md | 88 +++++++++++++++++++++++++++++++++++- 1 file changed, 87 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index a0c08fe95..1b78ba41e 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.0-rc.1...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.1...main +[release-v3.2.0-preview.1]: https://github.com/PowerShell/DSC/releases/tag/v3.2.0-preview.1 "Link to the DSC v3.2.0-preview.1 release on GitHub" +[compare-v3.2.0-preview.1]: https://github.com/PowerShell/DSC/compare/v3.1.0-preview.7...v3.2.0-preview.1 + +### Added + +- Add `sshdconfig` project providing resources to manage OpenSSH server configuration on Windows. + +
Related work items + + - Issues: _None_. + - PRs: [#869][#869] + +
+ +- Windows RebootPending resource: include pending reboot reason in the result output. + +
Related work items + + - Issues: _None_. + - PRs: [#873][#873] + +
+ +### Changed + +- Export output: surface `_kind`, `_securityContext`, and `_name` fields from resources during export. + +
Related work items + + - Issues: [#598][#598] + - PRs: [#884][#884] + +
+ +- Registry internals: separate shared helper into a library and refactor registry implementation. + +
Related work items + + - Issues: _None_. + - PRs: [#865][#865], [#892][#892] + +
+ +- WMI adapter refactor implementation. + +
Related work items + + - Issues: _None_. + - PRs: [#897][#897] + +
+ +### Fixed + +- Fix regression in default output for `get --all` (ensure interactive default output is correct). + +
Related work items + + - Issues: [#866][#866]. + - PRs: [#874][#874] + +
+ ## [v3.1.0-rc.1][release-v3.1.0-rc.1] - 2025-06-10 This section includes a summary of changes for the `rc.1` release. For the full list of changes @@ -2937,3 +3006,20 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#863]: https://github.com/PowerShell/DSC/pull/863 [#875]: https://github.com/PowerShell/DSC/pull/875 [#859]: https://github.com/PowerShell/DSC/pull/859 +[#869]: https://github.com/PowerShell/DSC/pull/869 +[#873]: https://github.com/PowerShell/DSC/pull/873 +[#884]: https://github.com/PowerShell/DSC/pull/884 +[#865]: https://github.com/PowerShell/DSC/pull/865 +[#892]: https://github.com/PowerShell/DSC/pull/892 +[#897]: https://github.com/PowerShell/DSC/pull/897 +[#891]: https://github.com/PowerShell/DSC/pull/891 +[#874]: https://github.com/PowerShell/DSC/pull/874 +[#901]: https://github.com/PowerShell/DSC/pull/901 +[#900]: https://github.com/PowerShell/DSC/pull/900 +[#886]: https://github.com/PowerShell/DSC/pull/886 +[#888]: https://github.com/PowerShell/DSC/pull/888 +[#899]: https://github.com/PowerShell/DSC/pull/899 +[#857]: https://github.com/PowerShell/DSC/pull/857 +[#598]: https://github.com/PowerShell/DSC/issues/598 +[#665]: https://github.com/PowerShell/DSC/issues/665 +[#539]: https://github.com/PowerShell/DSC/issues/539 From f8bae0264b545e43976f7d536060aac4a1fb93c1 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 15:29:00 +0200 Subject: [PATCH 13/16] Add remaining releases --- docs/prerelease-changelog.md | 235 ++++++++++++++++++++++++++++++++++- 1 file changed, 234 insertions(+), 1 deletion(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 1b78ba41e..60b03d056 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -46,7 +46,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.1...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.3...main +[release-v3.2.0-preview.3]: https://github.com/PowerShell/DSC/releases/tag/v3.2.0-preview.3 "Link to the DSC v3.2.0-preview.3 release on GitHub" +[compare-v3.2.0-preview.3]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.2...v3.2.0-preview.3 + +### Added + +- Add support for `secret()` function and "secret" extensions to retrieve secrets during configuration evaluation. + +
Related work items + + - Issues: [#685][#685] + - PRs: [#908][#908] + +
+ +- Add `dsc function list` subcommand to enumerate supported functions. + +
Related work items + + - Issues: _None_. + - PRs: [#959][#959] + +
+ +- Add `condition` support for resource instances within a configuration document. + +
Related work items + + - Issues: [#972][#972] + - PRs: [#978][#978] + +
+ +- Enable resources to return `_restartRequired` metadata that aggregates at the configuration result level. + +
Related work items + + - Issues: [#50][#50] + - PRs: [#975][#975] + +
+ +- Add remaining logical functions to the function library: `and`, `bool`, `false`, `true`, `not`, `or`. + +
Related work items + + - Issues: [#976][#976] + - PRs: [#979][#979] + +
+ +- Introduce inline script resources: `Microsoft.DSC.Transitional/PowerShellScript` and `Microsoft.DSC.Transitional/WindowsPowerShellScript`. + +
Related work items + + - Issues: [#885][#885] + - PRs: [#937][#937] + +
+ +- sshdconfig: add support for configuring a default shell on Windows. + +
Related work items + + - Issues: _None_. + - PRs: [#907][#907] + +
+ +- WMI adapter: add `set` capability for WMI-backed resources. + +
Related work items + + - Issues: [#475][#475] + - PRs: [#946][#946] + +
+ +### Changed + +- sshdconfig: add JSON tracing and update supported keyword constants. + +
Related work items + + - Issues: _None_. + - PRs: [#958][#958] + +
+ +### Fixed + +- Correct trace message to use `results` and emit JSON for function evaluation traces. + +
Related work items + + - Issues: _None_. + - PRs: [#955][#955] + +
+ +- Windows PowerShell adapter: suppress progress output. + +
Related work items + + - Issues: [#923][#923] + - PRs: [#964][#964] + +
+ +- Adapter capability discovery: fix discovery of capabilities in the PowerShell adapter and Windows PowerShell adapter. + +
Related work items + + - Issues: [#853][#853] + - PRs: [#876][#876], [#877][#877] + +
+ +## [v3.2.0-preview.2][release-v3.2.0-preview.2] - 2025-07-11 + +This section includes a summary of changes for the `v3.2.0-preview.2` release. For the full list of +changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.2]. + + +[release-v3.2.0-preview.2]: https://github.com/PowerShell/DSC/releases/tag/v3.2.0-preview.2 "Link to the DSC v3.2.0-preview.2 release on GitHub" +[compare-v3.2.0-preview.2]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.1...v3.2.0-preview.2 + +### Added + +- Enable resources to return metadata that DSC merges into the resource result output's `metadata`. + +
Related work items + + - Issues: [#467][#467] + - PRs: [#947][#947] + +
+ +### Changed + +- Rename `Microsoft.Windows/sshd_config` resource to `Microsoft/sshd_config` to reflect cross-platform scope. + +
Related work items + + - Issues: [#915][#915] + - PRs: [#932][#932] + +
+ +### Fixed + +- Fix default interactive output to use YAML for resource `get` results. + +
Related work items + + - Issues: [#918][#918] + - PRs: [#920][#920] + +
+ +- Fix property discovery for class-based resources in the Windows PowerShell adapter. + +
Related work items + + - Issues: [#878][#878] + - PRs: [#879][#879] + +
+ +- Remove UTF-8 BOM from files when reading to avoid mis-parsing content. + +
Related work items + + - Issues: [#829][#829] + - PRs: [#944][#944] + +
+ ## [v3.2.0-preview.1][release-v3.2.0-preview.1] - 2025-06-26 This section includes a summary of changes for the `v3.2.0-preview.1` release. For the full list of @@ -3023,3 +3206,53 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#598]: https://github.com/PowerShell/DSC/issues/598 [#665]: https://github.com/PowerShell/DSC/issues/665 [#539]: https://github.com/PowerShell/DSC/issues/539 + +[#467]: https://github.com/PowerShell/DSC/issues/467 +[#915]: https://github.com/PowerShell/DSC/issues/915 +[#918]: https://github.com/PowerShell/DSC/issues/918 +[#878]: https://github.com/PowerShell/DSC/issues/878 +[#829]: https://github.com/PowerShell/DSC/issues/829 +[#921]: https://github.com/PowerShell/DSC/issues/921 +[#914]: https://github.com/PowerShell/DSC/issues/914 +[#909]: https://github.com/PowerShell/DSC/issues/909 + +[#947]: https://github.com/PowerShell/DSC/pull/947 +[#932]: https://github.com/PowerShell/DSC/pull/932 +[#920]: https://github.com/PowerShell/DSC/pull/920 +[#879]: https://github.com/PowerShell/DSC/pull/879 +[#944]: https://github.com/PowerShell/DSC/pull/944 +[#935]: https://github.com/PowerShell/DSC/pull/935 +[#902]: https://github.com/PowerShell/DSC/pull/902 +[#916]: https://github.com/PowerShell/DSC/pull/916 +[#910]: https://github.com/PowerShell/DSC/pull/910 +[#927]: https://github.com/PowerShell/DSC/pull/927 +[#929]: https://github.com/PowerShell/DSC/pull/929 +[#939]: https://github.com/PowerShell/DSC/pull/939 +[#936]: https://github.com/PowerShell/DSC/pull/936 +[#919]: https://github.com/PowerShell/DSC/pull/919 + +[#685]: https://github.com/PowerShell/DSC/issues/685 +[#972]: https://github.com/PowerShell/DSC/issues/972 +[#50]: https://github.com/PowerShell/DSC/issues/50 +[#976]: https://github.com/PowerShell/DSC/issues/976 +[#885]: https://github.com/PowerShell/DSC/issues/885 +[#853]: https://github.com/PowerShell/DSC/issues/853 +[#923]: https://github.com/PowerShell/DSC/issues/923 +[#967]: https://github.com/PowerShell/DSC/issues/967 + +[#908]: https://github.com/PowerShell/DSC/pull/908 +[#959]: https://github.com/PowerShell/DSC/pull/959 +[#978]: https://github.com/PowerShell/DSC/pull/978 +[#975]: https://github.com/PowerShell/DSC/pull/975 +[#979]: https://github.com/PowerShell/DSC/pull/979 +[#937]: https://github.com/PowerShell/DSC/pull/937 +[#907]: https://github.com/PowerShell/DSC/pull/907 +[#946]: https://github.com/PowerShell/DSC/pull/946 +[#958]: https://github.com/PowerShell/DSC/pull/958 +[#971]: https://github.com/PowerShell/DSC/pull/971 +[#989]: https://github.com/PowerShell/DSC/pull/989 +[#955]: https://github.com/PowerShell/DSC/pull/955 +[#964]: https://github.com/PowerShell/DSC/pull/964 +[#969]: https://github.com/PowerShell/DSC/pull/969 +[#876]: https://github.com/PowerShell/DSC/pull/876 +[#877]: https://github.com/PowerShell/DSC/pull/877 From b3acce1d46892b206815437a46953b2fb0191a24 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 15:59:55 +0200 Subject: [PATCH 14/16] Update changelog --- CHANGELOG.md | 27 +++++- docs/prerelease-changelog.md | 174 +++++++++++++++++------------------ 2 files changed, 109 insertions(+), 92 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9d1093e7b..4b6ef80bd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -42,7 +42,7 @@ To see the changes for the earlier development of DSC before version `3.0.0`, se [m1]: https://keepachangelog.com/en/1.1.0/ [m2]: https://semver.org/spec/v2.0.0.html -[m3]: https://github.com/PowerShell/DSC/blob/main/CHANGELOG.md +[m3]: https://github.com/PowerShell/DSC/blob/main/docs/prerelease-changelog.md ## Unreleased @@ -50,7 +50,7 @@ This section includes a summary of user-facing changes since the last release. F changes since the last release, see the [diff on GitHub][unreleased]. -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.0.2...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.1.1...main +## [v3.1.1][release-v3.1.1] - 2025-07-14 + +This section includes a summary of changes for the `3.1.1` patch release. For the +full list of changes in this release, see the +[diff on GitHub][compare-v3.1.1]. + + +[release-v3.1.1]: https://github.com/PowerShell/DSC/releases/tag/v3.1.1 "Link to the DSC v3.1.1 release on GitHub" +[compare-v3.1.1]: https://github.com/PowerShell/DSC/compare/v3.1.0...v3.1.1 + +### Fixed + +- Backport: Fix default output to YAML when used interactively. + +
Related work items + + - Issues: [#918][#918] + - PRs: [#960][#960] + +
+ ## [v3.1.0][release-v3.1.0] - 2025-06-18 This section includes a summary of changes for the `3.1.0` release. For the full list of changes @@ -662,3 +683,5 @@ Version `3.0.0` is the first generally available release of DSC. [#862]: https://github.com/PowerShell/DSC/issues/862 [#834]: https://github.com/PowerShell/DSC/issues/834 [#863]: https://github.com/PowerShell/DSC/issues/863 +[#918]: https://github.com/PowerShell/DSC/issues/918 +[#960]: https://github.com/PowerShell/DSC/issues/960 \ No newline at end of file diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 60b03d056..591e38b44 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -86,7 +86,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3]. ### Added -- Add support for `secret()` function and "secret" extensions to retrieve secrets during configuration evaluation. +- Add support for `secret()` function and "secret" extensions to retrieve + secrets during configuration evaluation.
Related work items @@ -104,7 +105,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3].
-- Add `condition` support for resource instances within a configuration document. +- Add `condition` support for resource instances within a configuration + document.
Related work items @@ -113,7 +115,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3].
-- Enable resources to return `_restartRequired` metadata that aggregates at the configuration result level. +- Enable resources to return `_restartRequired` metadata that aggregates at the + configuration result level.
Related work items @@ -122,7 +125,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3].
-- Add remaining logical functions to the function library: `and`, `bool`, `false`, `true`, `not`, `or`. +- Add remaining logical functions to the function library: `and`, `bool`, + `false`, `true`, `not`, `or`.
Related work items @@ -131,7 +135,9 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3].
-- Introduce inline script resources: `Microsoft.DSC.Transitional/PowerShellScript` and `Microsoft.DSC.Transitional/WindowsPowerShellScript`. +- Introduce inline script resources: + `Microsoft.DSC.Transitional/PowerShellScript` and + `Microsoft.DSC.Transitional/WindowsPowerShellScript`.
Related work items @@ -171,7 +177,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3]. ### Fixed -- Correct trace message to use `results` and emit JSON for function evaluation traces. +- Correct trace message to use `results` and emit JSON for function evaluation + traces.
Related work items @@ -189,7 +196,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3].
-- Adapter capability discovery: fix discovery of capabilities in the PowerShell adapter and Windows PowerShell adapter. +- Adapter capability discovery: fix discovery of capabilities in the PowerShell + adapter and Windows PowerShell adapter.
Related work items @@ -200,8 +208,9 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.3]. ## [v3.2.0-preview.2][release-v3.2.0-preview.2] - 2025-07-11 -This section includes a summary of changes for the `v3.2.0-preview.2` release. For the full list of -changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.2]. +This section includes a summary of changes for the `v3.2.0-preview.2` release. +For the full list of changes in this release, see the +[diff on GitHub][compare-v3.2.0-preview.2]. [release-v3.2.0-preview.2]: https://github.com/PowerShell/DSC/releases/tag/v3.2.0-preview.2 "Link to the DSC v3.2.0-preview.2 release on GitHub" @@ -209,7 +218,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.2]. ### Added -- Enable resources to return metadata that DSC merges into the resource result output's `metadata`. +- Enable resources to return metadata that DSC merges into the resource result + output's `metadata`.
Related work items @@ -220,7 +230,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.2]. ### Changed -- Rename `Microsoft.Windows/sshd_config` resource to `Microsoft/sshd_config` to reflect cross-platform scope. +- Rename `Microsoft.Windows/sshd_config` resource to + `Microsoft/sshd_config` to reflect cross-platform scope.
Related work items @@ -240,7 +251,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.2].
-- Fix property discovery for class-based resources in the Windows PowerShell adapter. +- Fix property discovery for class-based resources in the Windows + PowerShell adapter.
Related work items @@ -269,7 +281,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.1]. ### Added -- Add `sshdconfig` project providing resources to manage OpenSSH server configuration on Windows. +- Add `sshdconfig` project providing resources to manage OpenSSH server + configuration on Windows.
Related work items @@ -278,7 +291,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.1].
-- Windows RebootPending resource: include pending reboot reason in the result output. +- `Microsoft.Windows/RebootPending` resource: include pending reboot reason in the result + output.
Related work items @@ -289,7 +303,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.1]. ### Changed -- Export output: surface `_kind`, `_securityContext`, and `_name` fields from resources during export. +- Export output: surface `_kind`, `_securityContext`, and `_name` fields from + resources during export.
Related work items @@ -298,7 +313,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.1].
-- Registry internals: separate shared helper into a library and refactor registry implementation. +- Registry internals: separate shared helper into a library and refactor + registry implementation.
Related work items @@ -318,7 +334,8 @@ changes in this release, see the [diff on GitHub][compare-v3.2.0-preview.1]. ### Fixed -- Fix regression in default output for `get --all` (ensure interactive default output is correct). +- Fix regression in default output for `get --all` (ensure interactive default + output is correct).
Related work items @@ -338,7 +355,8 @@ in this release, see the [diff on GitHub][compare-v3.1.0-rc.1]. ### Added -- Enable reading parameters from STDIN by allowing the parameters file name `-`. +- Enable reading parameters from STDIN by allowing the parameters file name + `-`.
Related work items @@ -347,7 +365,8 @@ in this release, see the [diff on GitHub][compare-v3.1.0-rc.1].
-- Add `pass-through` output format for `dsc resource get` to emit the resource's JSON without a DSC wrapper. +- Add `pass-through` output format for `dsc resource get` to emit the + resource's JSON without a DSC wrapper.
Related work items @@ -358,7 +377,8 @@ in this release, see the [diff on GitHub][compare-v3.1.0-rc.1]. ### Changed -- Windows RebootPending resource: convert the pending reboot value to an object (removes a read-only property and keeps the field optional). +- `Microsoft.Windows/RebootPending` resource: convert the pending reboot value to an + object (removes a read-only property and keeps the field optional).
Related work items @@ -369,7 +389,8 @@ in this release, see the [diff on GitHub][compare-v3.1.0-rc.1]. ### Fixed -- Fix regression in default output for `get --all` (ensure interactive default output is correct). +- Fix regression in default output for `get --all` (ensure interactive + default output is correct).
Related work items @@ -398,7 +419,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.7].
-- Add `json-array` as a supported output format for `dsc resource get --all` to return a single JSON array instead of JSON Lines. +- Add `json-array` as a supported output format for `dsc resource get --all` + to return a single JSON array instead of JSON Lines.
Related work items @@ -409,7 +431,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.7]. ### Changed -- Appx discovery extension: set execution policy to `Bypass` so it runs under restricted policies. +- Appx discovery extension: set execution policy to `Bypass` so it runs under + restricted policies.
Related work items @@ -418,7 +441,9 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.7].
-- Respect `DSC_RESOURCE_PATH` for executable lookup by aligning the process `PATH` to the same value so executable search is limited to `DSC_RESOURCE_PATH`. +- Respect `DSC_RESOURCE_PATH` for executable lookup by aligning the process + `PATH` to the same value so executable search is limited to + `DSC_RESOURCE_PATH`.
Related work items @@ -429,7 +454,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.7]. ### Fixed -- Improve error message when duplicate resource names are detected during `set`. +- Improve error message when duplicate resource names are detected during + `set`.
Related work items @@ -438,7 +464,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.7].
-- Windows registry resource: treat deleting a non-existing key/value as success instead of erroring. +- `Microsoft.Windows/Registry` resource: treat deleting a non-existing key/value as + success instead of erroring.
Related work items @@ -467,7 +494,9 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6]. ### Added -- Experimental Appx resource discovery extension to discover resources packaged in Appx; also removes duplicate discoveries by type name and version. +- Experimental Appx resource discovery extension to discover resources + packaged in Appx; also removes duplicate discoveries by type name and + version.
Related work items @@ -476,7 +505,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6].
-- Add `table-no-truncate` format option to `dsc resource list` and `dsc extension list` to avoid truncating wide tables in narrow consoles. +- Add `table-no-truncate` format option to `dsc resource list` and + `dsc extension list` to avoid truncating wide tables in narrow consoles.
Related work items @@ -487,7 +517,9 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6]. ### Changed -- Windows PowerShell adapter: allow a workaround to detect class-based resources using type instances so class-based PSDSC resources are discoverable. +- Windows PowerShell adapter: allow a workaround to detect class-based + resources using type instances so class-based PSDSC resources are + discoverable.
Related work items @@ -496,7 +528,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6].
-- WMI adapter: set execution policy to `Bypass` to align with PowerShell adapters and avoid failures under restricted policies. +- WMI adapter: set execution policy to `Bypass` to align with PowerShell + adapters and avoid failures under restricted policies.
Related work items @@ -507,7 +540,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6]. ### Fixed -- Export adapted resources correctly by aligning `export` output to use the `result` property and fixing the test adapter. +- Export adapted resources correctly by aligning `export` output to use the + `result` property and fixing the test adapter.
Related work items @@ -516,7 +550,9 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6].
-- Windows PowerShell adapter caching: ensure full refresh when `PSModulePath` changes and on cold cache to avoid broken cache states from targeted refreshes. +- Windows PowerShell adapter caching: ensure full refresh when + `PSModulePath` changes and on cold cache to avoid broken cache states from + targeted refreshes.
Related work items @@ -525,7 +561,9 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.6].
-- Class-based detection: add validation ensuring the type instance has the `DscResource` attribute to avoid false positives for types with matching names. +- Class-based detection: add validation ensuring the type instance has the + `DscResource` attribute to avoid false positives for types with matching + names.
Related work items @@ -635,8 +673,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.4]. ### Added -- Add credential support on PowerShell adapters to create PSCredential objects from input when the - target property expects a credential. +- Add credential support on PowerShell adapters to create PSCredential + objects from input when the target property expects a credential.
Related work items @@ -647,9 +685,9 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.4]. ### Changed -- Prefer Windows PowerShell modules first in the Windows PowerShell adapter by prepending the - Windows module path; add a warning when a resource isn't found (resource must be installed for - AllUsers). +- Prefer Windows PowerShell modules first in the Windows PowerShell adapter by + prepending the Windows module path; add a warning when a resource isn't + found (resource must be installed for AllUsers).
Related work items @@ -660,8 +698,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.4]. ### Fixed -- Fix resource cache behavior when PowerShell modules are installed during a run so subsequent - modules aren't lost from the cache. +- Fix resource cache behavior when PowerShell modules are installed during a + run so subsequent modules aren't lost from the cache.
Related work items @@ -690,8 +728,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.3].
-- Set `Bypass` execution policy when calling PowerShell from the adapter to avoid failures on - Windows with restricted execution policy. +- Set `Bypass` execution policy when calling PowerShell from the adapter to + avoid failures on Windows with restricted execution policy.
Related work items @@ -722,7 +760,8 @@ changes in this release, see the [diff on GitHub][compare-v3.1.0-preview.2]. ### Added -- Add validation to check key-value pairs for class-based and script-based DSC resources. +- Add validation to check key-value pairs for class-based and script-based DSC + resources.
Related work items @@ -2852,26 +2891,16 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [cmd]: ./docs/reference/cli/dsc.md -[cmd-completion]: ./docs/reference/cli/completer/command.md -[cmd-schema]: ./docs/reference/cli/schema/command.md -[cmd-c]: ./docs/reference/cli/config/command.md [cmd-cexport]: ./docs/reference/cli/config/export.md -[cmd-cget]: ./docs/reference/cli/config/get.md [cmd-cset]: ./docs/reference/cli/config/set.md -[cmd-ctest]: ./docs/reference/cli/config/test.md -[cmd-r]: ./docs/reference/cli/resource/command.md [cmd-rdelete]: ./docs/reference/cli/resource/delete.md [cmd-rexport]: ./docs/reference/cli/resource/export.md [cmd-rget]: ./docs/reference/cli/resource/get.md [cmd-rlist]: ./docs/reference/cli/resource/list.md -[cmd-rschema]: ./docs/reference/cli/resource/schema.md [cmd-rset]: ./docs/reference/cli/resource/set.md -[cmd-rtest]: ./docs/reference/cli/resource/test.md [cfuncs]: ./docs/reference/schemas/config/functions/overview.md [add()]: ./docs/reference/schemas/config/functions/add.md -[base64()]: ./docs/reference/schemas/config/functions/base64.md -[concat()]: ./docs/reference/schemas/config/functions/concat.md [createArray()]: ./docs/reference/schemas/config/functions/createArray.md [div()]: ./docs/reference/schemas/config/functions/div.md [envvar()]: ./docs/reference/schemas/config/functions/envvar.md @@ -2880,9 +2909,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [min()]: ./docs/reference/schemas/config/functions/min.md [mod()]: ./docs/reference/schemas/config/functions/mod.md [mul()]: ./docs/reference/schemas/config/functions/mul.md -[parameters()]: ./docs/reference/schemas/config/functions/parameters.md [reference()]: ./docs/reference/schemas/config/functions/reference.md -[resourceId()]: ./docs/reference/schemas/config/functions/resourceId.md [sub()]: ./docs/reference/schemas/config/functions/sub.md @@ -3149,13 +3176,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#763]: https://github.com/PowerShell/DSC/issues/763 [#797]: https://github.com/PowerShell/DSC/pull/797 [#798]: https://github.com/PowerShell/DSC/issues/798 -[#734]: https://github.com/PowerShell/DSC/pull/734 -[#717]: https://github.com/PowerShell/DSC/issues/717 -[#708]: https://github.com/PowerShell/DSC/issues/708 -[#819]: https://github.com/PowerShell/DSC/pull/819 -[#818]: https://github.com/PowerShell/DSC/issues/818 -[#820]: https://github.com/PowerShell/DSC/pull/820 -[#821]: https://github.com/PowerShell/DSC/pull/821 [#782]: https://github.com/PowerShell/DSC/issues/782 [#789]: https://github.com/PowerShell/DSC/pull/789 [#807]: https://github.com/PowerShell/DSC/issues/807 @@ -3168,9 +3188,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#811]: https://github.com/PowerShell/DSC/issues/811 [#813]: https://github.com/PowerShell/DSC/issues/813 [#814]: https://github.com/PowerShell/DSC/issues/814 -[#830]: https://github.com/PowerShell/DSC/pull/830 -[#837]: https://github.com/PowerShell/DSC/pull/837 -[#838]: https://github.com/PowerShell/DSC/pull/838 [#841]: https://github.com/PowerShell/DSC/issues/841 [#843]: https://github.com/PowerShell/DSC/issues/843 [#844]: https://github.com/PowerShell/DSC/pull/844 @@ -3195,41 +3212,22 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#865]: https://github.com/PowerShell/DSC/pull/865 [#892]: https://github.com/PowerShell/DSC/pull/892 [#897]: https://github.com/PowerShell/DSC/pull/897 -[#891]: https://github.com/PowerShell/DSC/pull/891 [#874]: https://github.com/PowerShell/DSC/pull/874 -[#901]: https://github.com/PowerShell/DSC/pull/901 -[#900]: https://github.com/PowerShell/DSC/pull/900 -[#886]: https://github.com/PowerShell/DSC/pull/886 -[#888]: https://github.com/PowerShell/DSC/pull/888 -[#899]: https://github.com/PowerShell/DSC/pull/899 -[#857]: https://github.com/PowerShell/DSC/pull/857 + [#598]: https://github.com/PowerShell/DSC/issues/598 -[#665]: https://github.com/PowerShell/DSC/issues/665 -[#539]: https://github.com/PowerShell/DSC/issues/539 [#467]: https://github.com/PowerShell/DSC/issues/467 [#915]: https://github.com/PowerShell/DSC/issues/915 [#918]: https://github.com/PowerShell/DSC/issues/918 [#878]: https://github.com/PowerShell/DSC/issues/878 [#829]: https://github.com/PowerShell/DSC/issues/829 -[#921]: https://github.com/PowerShell/DSC/issues/921 -[#914]: https://github.com/PowerShell/DSC/issues/914 -[#909]: https://github.com/PowerShell/DSC/issues/909 [#947]: https://github.com/PowerShell/DSC/pull/947 [#932]: https://github.com/PowerShell/DSC/pull/932 [#920]: https://github.com/PowerShell/DSC/pull/920 [#879]: https://github.com/PowerShell/DSC/pull/879 [#944]: https://github.com/PowerShell/DSC/pull/944 -[#935]: https://github.com/PowerShell/DSC/pull/935 -[#902]: https://github.com/PowerShell/DSC/pull/902 -[#916]: https://github.com/PowerShell/DSC/pull/916 -[#910]: https://github.com/PowerShell/DSC/pull/910 -[#927]: https://github.com/PowerShell/DSC/pull/927 -[#929]: https://github.com/PowerShell/DSC/pull/929 -[#939]: https://github.com/PowerShell/DSC/pull/939 -[#936]: https://github.com/PowerShell/DSC/pull/936 -[#919]: https://github.com/PowerShell/DSC/pull/919 +[#820]: https://github.com/PowerShell/DSC/pull/820 [#685]: https://github.com/PowerShell/DSC/issues/685 [#972]: https://github.com/PowerShell/DSC/issues/972 @@ -3238,7 +3236,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#885]: https://github.com/PowerShell/DSC/issues/885 [#853]: https://github.com/PowerShell/DSC/issues/853 [#923]: https://github.com/PowerShell/DSC/issues/923 -[#967]: https://github.com/PowerShell/DSC/issues/967 [#908]: https://github.com/PowerShell/DSC/pull/908 [#959]: https://github.com/PowerShell/DSC/pull/959 @@ -3249,10 +3246,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#907]: https://github.com/PowerShell/DSC/pull/907 [#946]: https://github.com/PowerShell/DSC/pull/946 [#958]: https://github.com/PowerShell/DSC/pull/958 -[#971]: https://github.com/PowerShell/DSC/pull/971 -[#989]: https://github.com/PowerShell/DSC/pull/989 [#955]: https://github.com/PowerShell/DSC/pull/955 [#964]: https://github.com/PowerShell/DSC/pull/964 -[#969]: https://github.com/PowerShell/DSC/pull/969 [#876]: https://github.com/PowerShell/DSC/pull/876 [#877]: https://github.com/PowerShell/DSC/pull/877 From eb31259e7f52b21d4154ac655294976e62d3c7f6 Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Tue, 19 Aug 2025 16:03:22 +0200 Subject: [PATCH 15/16] Remove whitespace --- CHANGELOG.md | 2 +- docs/prerelease-changelog.md | 8 -------- 2 files changed, 1 insertion(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4b6ef80bd..ddae90a13 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -684,4 +684,4 @@ Version `3.0.0` is the first generally available release of DSC. [#834]: https://github.com/PowerShell/DSC/issues/834 [#863]: https://github.com/PowerShell/DSC/issues/863 [#918]: https://github.com/PowerShell/DSC/issues/918 -[#960]: https://github.com/PowerShell/DSC/issues/960 \ No newline at end of file +[#960]: https://github.com/PowerShell/DSC/issues/960 diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 591e38b44..4c0134e5e 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -3100,7 +3100,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#89]: https://github.com/PowerShell/DSC/issues/89 [#98]: https://github.com/PowerShell/DSC/issues/98 [#537]: https://github.com/PowerShell/DSC/issues/537 - [#282]: https://github.com/PowerShell/DSC/issues/282 [#534]: https://github.com/PowerShell/DSC/issues/534 [#578]: https://github.com/PowerShell/DSC/issues/578 @@ -3184,7 +3183,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#791]: https://github.com/PowerShell/DSC/issues/791 [#800]: https://github.com/PowerShell/DSC/pull/800 [#823]: https://github.com/PowerShell/DSC/pull/823 - [#811]: https://github.com/PowerShell/DSC/issues/811 [#813]: https://github.com/PowerShell/DSC/issues/813 [#814]: https://github.com/PowerShell/DSC/issues/814 @@ -3198,7 +3196,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#861]: https://github.com/PowerShell/DSC/pull/861 [#825]: https://github.com/PowerShell/DSC/pull/825 [#832]: https://github.com/PowerShell/DSC/issues/832 - [#834]: https://github.com/PowerShell/DSC/issues/834 [#858]: https://github.com/PowerShell/DSC/issues/858 [#866]: https://github.com/PowerShell/DSC/issues/866 @@ -3213,22 +3210,18 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#892]: https://github.com/PowerShell/DSC/pull/892 [#897]: https://github.com/PowerShell/DSC/pull/897 [#874]: https://github.com/PowerShell/DSC/pull/874 - [#598]: https://github.com/PowerShell/DSC/issues/598 - [#467]: https://github.com/PowerShell/DSC/issues/467 [#915]: https://github.com/PowerShell/DSC/issues/915 [#918]: https://github.com/PowerShell/DSC/issues/918 [#878]: https://github.com/PowerShell/DSC/issues/878 [#829]: https://github.com/PowerShell/DSC/issues/829 - [#947]: https://github.com/PowerShell/DSC/pull/947 [#932]: https://github.com/PowerShell/DSC/pull/932 [#920]: https://github.com/PowerShell/DSC/pull/920 [#879]: https://github.com/PowerShell/DSC/pull/879 [#944]: https://github.com/PowerShell/DSC/pull/944 [#820]: https://github.com/PowerShell/DSC/pull/820 - [#685]: https://github.com/PowerShell/DSC/issues/685 [#972]: https://github.com/PowerShell/DSC/issues/972 [#50]: https://github.com/PowerShell/DSC/issues/50 @@ -3236,7 +3229,6 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#885]: https://github.com/PowerShell/DSC/issues/885 [#853]: https://github.com/PowerShell/DSC/issues/853 [#923]: https://github.com/PowerShell/DSC/issues/923 - [#908]: https://github.com/PowerShell/DSC/pull/908 [#959]: https://github.com/PowerShell/DSC/pull/959 [#978]: https://github.com/PowerShell/DSC/pull/978 From cb05c11237e4143676f10466f7e582e3f1d13b4c Mon Sep 17 00:00:00 2001 From: "G.Reijn" Date: Wed, 20 Aug 2025 12:31:23 +0200 Subject: [PATCH 16/16] Add latest reliease --- docs/prerelease-changelog.md | 149 ++++++++++++++++++++++++++++++++++- 1 file changed, 147 insertions(+), 2 deletions(-) diff --git a/docs/prerelease-changelog.md b/docs/prerelease-changelog.md index 4c0134e5e..ed03aa3b2 100644 --- a/docs/prerelease-changelog.md +++ b/docs/prerelease-changelog.md @@ -8,7 +8,7 @@ ms.date: 06/24/2024 # Changelog - + -[unreleased]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.3...main +[unreleased]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.4...main +[release-v3.2.0-preview.4]: https://github.com/PowerShell/DSC/releases/tag/v3.2.0-preview.4 "Link to the DSC v3.2.0-preview.4 release on GitHub" +[compare-v3.2.0-preview.4]: https://github.com/PowerShell/DSC/compare/v3.2.0-preview.3...v3.2.0-preview.4 + +### Added + +- Add comparison operators: `Less`, `LessOrEquals`, `Greater`, and + `GreaterOrEquals`. + +
Related work items + + - Issues: [#988][#988] + - PRs: [#990][#990], [#998][#998] + +
+ +- Add Bicep extension support to work with Bicep files. + +
Related work items + + - Issues: _None_. + - PRs: [#997][#997] + +
+ +- Add array functions: `contains()`, `union()`, `length()`, and `empty()`. + +
Related work items + + - Issues: _None_. + - PRs: [#1005][#1005], [#1039][#1039], [#1043][#1043] + +
+ +- Add string and utility functions: `string()`, `endsWith()`, `startsWith()`, + `uniqueString()`, and `utcNow()`. + +
Related work items + + - Issues: _None_. + - PRs: [#1040][#1040], [#1032][#1032], [#1045][#1045] + +
+ +### Changed + +- Align the `Resource` schema to match ARM conventions. + +
Related work items + + - Issues: [#980][#980] + - PRs: [#995][#995] + +
+ +- Improve duplicate resource error messages to include the resource type + name. + +
Related work items + + - Issues: [#1022][#1022] + - PRs: [#1029][#1029] + +
+ +- OSInfo: have export return `_name` for consistency with other resources. + +
Related work items + + - Issues: _None_. + - PRs: [#1038][#1038] + +
+ +- Secret extensions: require emitting the secret as plaintext to STDOUT with a + trailing newline (no JSON wrapper). Multiple lines to STDOUT is an error. + Also fix extensions that referenced the resource schema instead of the + extension schema, and reformat a use statement for readability. + +
Related work items + + - Issues: _None_. + - PRs: [#1046][#1046] + +
+ +- CLI/Adapters: treat a resource without `export` as usable with `get` when + listing or invoking. + +
Related work items + + - Issues: [#428][#428] + - PRs: [#1035][#1035] + +
+ +- Functions metadata: refactor how functions return metadata and include + return type information in listings. + +
Related work items + + - Issues: _None_. + - PRs: [#1028][#1028] + +
+ +### Fixed + +- Fix parsing so expressions aren't re-parsed when passed to adapted + resources. + +
Related work items + + - Issues: [#1024][#1024] + - PRs: [#1031][#1031] + +
+ ## [v3.2.0-preview.3][release-v3.2.0-preview.3] - 2025-07-19 This section includes a summary of changes for the `v3.2.0-preview.3` release. For the full list of @@ -3242,3 +3366,24 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#964]: https://github.com/PowerShell/DSC/pull/964 [#876]: https://github.com/PowerShell/DSC/pull/876 [#877]: https://github.com/PowerShell/DSC/pull/877 +[#428]: https://github.com/PowerShell/DSC/issues/428 +[#980]: https://github.com/PowerShell/DSC/issues/980 +[#988]: https://github.com/PowerShell/DSC/issues/988 +[#990]: https://github.com/PowerShell/DSC/pull/990 +[#995]: https://github.com/PowerShell/DSC/pull/995 +[#997]: https://github.com/PowerShell/DSC/pull/997 +[#998]: https://github.com/PowerShell/DSC/pull/998 +[#1005]: https://github.com/PowerShell/DSC/pull/1005 +[#1022]: https://github.com/PowerShell/DSC/issues/1022 +[#1024]: https://github.com/PowerShell/DSC/issues/1024 +[#1028]: https://github.com/PowerShell/DSC/pull/1028 +[#1029]: https://github.com/PowerShell/DSC/pull/1029 +[#1031]: https://github.com/PowerShell/DSC/pull/1031 +[#1032]: https://github.com/PowerShell/DSC/pull/1032 +[#1035]: https://github.com/PowerShell/DSC/pull/1035 +[#1038]: https://github.com/PowerShell/DSC/pull/1038 +[#1039]: https://github.com/PowerShell/DSC/pull/1039 +[#1040]: https://github.com/PowerShell/DSC/pull/1040 +[#1043]: https://github.com/PowerShell/DSC/pull/1043 +[#1045]: https://github.com/PowerShell/DSC/pull/1045 +[#1046]: https://github.com/PowerShell/DSC/pull/1046