diff --git a/CHANGELOG.md b/CHANGELOG.md index fc5fd8937..f257c74f0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -73,6 +73,107 @@ changes since the last release, see the [diff on GitHub][unreleased]. +## [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 +in this release, see the [diff on GitHub][compare-v3.0.0-preview.10]. + + +[release-v3.0.0-preview.10]: https://github.com/PowerShell/DSC/releases/tag/v3.0.0-preview.10 "Link to the DSC v3.0.0-preview.10 release on GitHub" +[compare-v3.0.0-preview.10]: https://github.com/PowerShell/DSC/compare/v3.0.0-preview.9...v3.0.0-preview.10 + +### Changed + +- The WMI adapter now treats instance properties as query properties. Prior to this change, adapted + instances would return every property. Starting with this release, only properties defined in the + instance declaration are returned. If an instance property is defined with a value, the adapter + uses that property and value to filter the instance. + +
Related work items + + - Issues: [#475][#475]. + - PRs: [#548][#548] + +
+ +### Added + +- Added capability for users to specify expressions when indexing into arrays for configuration + functions. + +
Related work items + + - Issues: _None_. + - PRs: [#527][#527] + +
+ +- Added a lookup table to improve performance when invoking adapted resources. DSC uses this table + to avoid needing to enumerate all adapted resources for non-list operations where possible. For + more information, see [dsc resource list][p10-aa]. + +
Related work items + + - Issues: _None_. + - PRs: [#530][#530] + +
+ +### Fixed + +- Fixed a bug in the tree-sitter grammar preventing use of multiline strings and escaped single + quotes in configuration functions. + +
Related work items + + - Issues: [#518][#518] + - PRs: [#524][#524] + +
+ +- Fixed trace messaging for the `Microsoft.DSC/PowerShell` and `Microsoft.Windows/PowerShell` + adapters to correctly emit warning and error messages instead of emitting all messages as debug. + +
Related work items + + - Issues: _None_. + - PRs: [#528][#528] + +
+ +- Fixed error messages for the `Microsoft.DSC/PowerShell` and `Microsoft.Windows/PowerShell` + adapters to clarify the actual error instead of returning a generic message. + +
Related work items + + - Issues: [#516][#516] + - PRs: [#525][#525] + +
+ +- Fixed the check for caching in the `Microsoft.DSC/PowerShell` and `Microsoft.Windows/PowerShell` + adapters to check on whole seconds instead of fractional seconds, reducing the frequency of + unneccessary cache invalidation. + +
Related work items + + - Issues: _None_. + - PRs: [#533][#533] + +
+ +- Fixed behavior for built-in resources to correctly handle trace messaging for nested calls to + `dsc`. + +
Related work items + + - Issues: [#512][#512] + - PRs: [#541][#541] + +
+ +[p10-aa]: docs/reference/cli/resource/list.md#adapted-resource-cache + ## [v3.0.0-preview.9][release-v3.0.0-preview.9] - 2024-08-15 This section includes a summary of changes for the `preview.9` release. For the full list of changes @@ -1818,6 +1919,7 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#465]: https://github.com/PowerShell/DSC/issues/465 [#468]: https://github.com/PowerShell/DSC/issues/468 [#469]: https://github.com/PowerShell/DSC/issues/469 +[#475]: https://github.com/PowerShell/DSC/issues/475 [#477]: https://github.com/PowerShell/DSC/issues/477 [#480]: https://github.com/PowerShell/DSC/issues/480 [#481]: https://github.com/PowerShell/DSC/issues/481 @@ -1839,7 +1941,18 @@ For the full list of changes in this release, see the [diff on GitHub][compare-v [#506]: https://github.com/PowerShell/DSC/issues/504 [#509]: https://github.com/PowerShell/DSC/issues/509 [#511]: https://github.com/PowerShell/DSC/issues/511 +[#512]: https://github.com/PowerShell/DSC/issues/512 [#514]: https://github.com/PowerShell/DSC/issues/514 +[#516]: https://github.com/PowerShell/DSC/issues/516 +[#518]: https://github.com/PowerShell/DSC/issues/518 +[#524]: https://github.com/PowerShell/DSC/issues/524 +[#525]: https://github.com/PowerShell/DSC/issues/525 +[#527]: https://github.com/PowerShell/DSC/issues/527 +[#528]: https://github.com/PowerShell/DSC/issues/528 +[#530]: https://github.com/PowerShell/DSC/issues/530 +[#533]: https://github.com/PowerShell/DSC/issues/533 +[#541]: https://github.com/PowerShell/DSC/issues/541 +[#548]: https://github.com/PowerShell/DSC/issues/548 [#57]: https://github.com/PowerShell/DSC/issues/57 [#70]: https://github.com/PowerShell/DSC/issues/70 [#73]: https://github.com/PowerShell/DSC/issues/73 diff --git a/docs/reference/cli/resource/list.md b/docs/reference/cli/resource/list.md index 557222cb5..b4f1e3bee 100644 --- a/docs/reference/cli/resource/list.md +++ b/docs/reference/cli/resource/list.md @@ -33,6 +33,17 @@ the command includes the `RESOURCE_NAME` argument, DSC filters the list of disco before returning them. The **description** and **tags** options filter the results by the resource descriptions and tags. Filters are always applied after resource discovery. +### Adapted resource cache + +DSC maintains a cache of discovered adapted resources for performance optimization. The location of +the cache depends on the operating system, as shown in the following table. + +| Operating system | Cache path | +|:----------------:|:------------------------------------------------------| +| Linux | `%LOCALAPPDATA%\dsc\AdaptedResourcesLookupTable.json` | +| macOS | `~/.dsc/AdaptedResourcesLookupTable.json` | +| Windows | `~/.dsc/AdaptedResourcesLookupTable.json` | + ## Examples ### Example 1 - List all non-adapted resources