v3.3.0

[Mikey Lombardi (He/Him) (michaeltlombardi)]

What's changed

These release notes describe updates to DSC since the v3.3.0-rc.2 release.

This changelog includes the following sections:

• Added for changes that improve or add functionality without breaking existing usage.
• Fixed for changes that resolve a bug in existing behavior.
• Documentation for changes that only affect documentation.
• Maintenance for changes that affect the project or internals without changing the user experience.

Each section has one or more subsections describing the area that the change affects:

• CLI for changes that affect the user eperience when invoking dsc itself.
• Engine for changes that affect the DSC engine, configuration documents, and manifests.
• Resources for changes that affect specific DSC resources.
• Server for changes that affect DSC when running as a JSON-RPC/MCP server.
• Bicep extension for changes that affect the Bicep extension.

For the full changelog, see v3.3.0-rc.2...v3.3.0

Added

CLI

• (Rename version field for dsc resource * commands to required_version #1393) Rename --version to --required-version for resource commands by Mikey Lombardi (He/Him) (@michaeltlombardi) in (GH-1393) Rename --version to --required-version for resource commands #1610

Engine

• Add support to pass resource version to adapter by Steve Lee (@SteveL-MSFT) in Add support to pass resource version to adapter #1645
• feat: remove experimental flag format() by Gijs Reijn (@Gijsreyn) in feat: remove experimental flag format() #1648
• feat: implement export filter functionality for resource exports by Gijs Reijn (@Gijsreyn) in feat: implement export filter functionality for resource exports #1621
• Use JSON Schema defaults in synthetic test get_diff by Steve Lee (@SteveL-MSFT) in Use JSON Schema defaults in synthetic test get_diff #1670
• Ignore write-only properties in schema-aware diffs by Steve Lee (@SteveL-MSFT) in Ignore write-only properties in schema-aware diffs #1674
• Add support for adapted resource manifests to indicate required security context by Steve Lee (@SteveL-MSFT) in Add support for adapted resource manifests to indicate required security context #1701

Resources

• feat: Add --what-if for Microsoft.Windows/UpdateList by Gijs Reijn (@Gijsreyn) in feat: Add --what-if for Microsoft.Windows/UpdateList #1616
• (Microsoft.DSC.Transitional/*Script design #1563) Enhance the PSScript resources by Mikey Lombardi (He/Him) (@michaeltlombardi) in (GH-1563) Enhance the PSScript resources #1657
• Add scoped unspecified firewall rule handling and allow empty rules by Steve Lee (@SteveL-MSFT) in Add scoped unspecified firewall rule handling and allow empty rules #1671
• Update Firewall manifest to declare implementsPretest by Steve Lee (@SteveL-MSFT) in Update Firewall manifest to declare implementsPretest #1682
• Add Group Policy template adapter by Steve Lee (@SteveL-MSFT) in Add Group Policy template adapter #1686
• Add Windows environment variable resource by Steve Lee (@SteveL-MSFT) in Add Windows environment variable resource #1675
• Add Microsoft.Filesystem.File/Content resource by Steve Lee (@SteveL-MSFT) in Add Microsoft.Filesystem.File/Content resource #1676

Server

• (MCP server tools don't support what-if for set/delete operations #1696) Add --what-if in MCP server tools by Gijs Reijn (@Gijsreyn) in (GH-1696) Add --what-if in MCP server tools #1697

Bicep extension

• Fix bicep extension to require transport to be specified otherwise return error by Steve Lee (@SteveL-MSFT) in Fix bicep extension to require transport to be specified otherwise return error #1721

Fixed

Engine

• Fix nested diff w/ schema and schema cache miss by Steve Lee (@SteveL-MSFT) in Fix nested diff w/ schema and schema cache miss #1680

Resources

• fix: add support for preserving quoted group names in sshd_config by Gijs Reijn (@Gijsreyn) in fix: add support for preserving quoted group names in sshd_config #1639
• Fix registry resource what-if for non-existing key by Steve Lee (@SteveL-MSFT) in Fix registry resource what-if for non-existing key #1692

Documentation

• docs: add Microsoft.DSC/Include reference documentation by Gijs Reijn (@Gijsreyn) in docs: add Microsoft.DSC/Include reference documentation #1649
• (DOCS) Update changelog for 3.2.* releases by Mikey Lombardi (He/Him) (@michaeltlombardi) in (DOCS) Update changelog for 3.2.* releases #1578
• docs: Add reference documentation for Microsoft.OpenSSH.SSHD/Windows by Gijs Reijn (@Gijsreyn) in docs: Add reference documentation for Microsoft.OpenSSH.SSHD/Windows #934
• docs: Add extensions reference documentation by Gijs Reijn (@Gijsreyn) in docs: Add extensions reference documentation #1661
• docs: Sync fixes from Microsoft Learn by Gijs Reijn (@Gijsreyn) in docs: Sync fixes from Microsoft Learn #1664
• docs: Sync fixes from Microsoft Learn (part two) by Gijs Reijn (@Gijsreyn) in docs: Sync fixes from Microsoft Learn (part two) #1677

Maintenance

• Add code review instructions derived from PR feedback patterns by Steve Lee (@SteveL-MSFT) in Add code review instructions derived from PR feedback patterns #1646
• Fix clippy rule violation by Steve Lee (@SteveL-MSFT) in Fix clippy rule violation #1688
• Update dsc.exe to have single process exit point by Steve Lee (@SteveL-MSFT) in Update dsc.exe to have single process exit point #1693
• (Canonicalize dsc schema command  #538) Enhance schema export functionality and add error handling for duplicate paths by Gijs Reijn (@Gijsreyn) in (GH-538) Enhance schema export functionality and add error handling for duplicate paths #1672
• (Canonicalize dsc schema command  #538) Define transforms for Option<T> by Mikey Lombardi (He/Him) (@michaeltlombardi) in (GH-538) Define transforms for Option<T> #1702
• Pin GitHub Actions to full-length commit SHAs by Dan Fiedler (@danfiedler-msft) in Pin GitHub Actions to full-length commit SHAs #1710
• Localize dsc-lib tracing and standardize builds by Steve Lee (@SteveL-MSFT) in Localize dsc-lib tracing and standardize builds #1720
• Change copilot code review from instruciton to skill by Steve Lee (@SteveL-MSFT) in Change copilot code review from instruciton to skill #1718
• (MAINT) Always rebuild for updated translations by Mikey Lombardi (He/Him) (@michaeltlombardi) in (MAINT) Always rebuild for updated translations #1711
• (AI) Update schema guidance for code review by Mikey Lombardi (He/Him) (@michaeltlombardi) in (AI) Update schema guidance for code review #1715
• Update code coverage report to always add comment even if failures by Steve Lee (@SteveL-MSFT) in Update code coverage report to always add comment even if failures #1714
• (CI) Update Rust workflow for PR events by Mikey Lombardi (He/Him) (@michaeltlombardi) in (CI) Update Rust workflow for PR events #1719
• (Canonicalize dsc schema command  #538) Set URI and docs keywords for DscRepoSchema types by Mikey Lombardi (He/Him) (@michaeltlombardi) in (GH-538) Set URI and docs keywords for DscRepoSchema types #1699

New Contributors

• Dan Fiedler (@danfiedler-msft) made their first contribution in Pin GitHub Actions to full-length commit SHAs #1710

---

This discussion was created from the release v3.3.0.