From 7d69ef1f1dc30f61d19b3e7faa59e25e0bc20f67 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Tue, 18 Mar 2025 08:29:51 -0500 Subject: [PATCH 1/3] Update references to DSC --- reference/docs-conceptual/dsc/overview.md | 21 +++++++++--------- reference/index.yml | 26 +++++++++++------------ 2 files changed, 23 insertions(+), 24 deletions(-) diff --git a/reference/docs-conceptual/dsc/overview.md b/reference/docs-conceptual/dsc/overview.md index 1e548c08c044..057f227911e0 100644 --- a/reference/docs-conceptual/dsc/overview.md +++ b/reference/docs-conceptual/dsc/overview.md @@ -1,18 +1,22 @@ --- description: DSC is a management platform in PowerShell that enables you to manage your IT and development infrastructure with configuration as code. -ms.date: 02/02/2023 +ms.date: 03/18/2025 title: PowerShell Desired State Configuration (DSC) --- -# PowerShell Desired State Configuration (DSC) Overview +# Desired State Configuration (DSC) Overview DSC is a management platform in PowerShell that enables you to manage your IT and development infrastructure with configuration as code. There are three versions of DSC available: -- DSC 1.1 is the legacy version of DSC that originally shipped in Windows PowerShell 5.1. -- DSC 2.0 is the version of DSC that shipped in PowerShell 7. +- Microsoft DSC 3.0 is the new version of DSC. This version is a preview release that is still being + developed. Users working with non-Windows environments can expect cross-platform features in DSC + 3.0. DSC 3.0 is the version that is supported by the [machine configuration][01] feature of Azure + Automanage. + +- PowerShell DSC 2.0 is the version of DSC that shipped in PowerShell 7. With the release of PowerShell 7.2, the **PSDesiredStateConfiguration** module is no longer included in the PowerShell package. Separating DSC into its own module allows us to invest and @@ -20,15 +24,10 @@ There are three versions of DSC available: will enjoy the benefit of upgrading DSC without the need to upgrade PowerShell, accelerating the time to deployment of new DSC features. Users that want to continue using DSC v2 can download **PSDesiredStateConfiguration** 2.0.5 from the PowerShell Gallery. -- DSC 3.0 is the new version of DSC. This version is a preview release that is still being - developed. Users working with non-Windows environments can expect cross-platform features in DSC - 3.0. DSC 3.0 is the version that is supported by the [machine configuration][01] feature of Azure - Automanage. -The documentation for DSC has been moved to a new location so that we can manage the DSC -version-specific information separately from the versions of PowerShell. +- PowerShell DSC 1.1 is the legacy version of DSC that originally shipped in Windows PowerShell 5.1. -See the new documentation in [Desired State Configuration 2.0][02]. +For more information, see the [Desired State Configuration][02] overview article. [01]: /azure/governance/machine-configuration/overview [02]: /powershell/dsc/overview diff --git a/reference/index.yml b/reference/index.yml index cc46fe475973..8eff6eaa26e9 100644 --- a/reference/index.yml +++ b/reference/index.yml @@ -10,7 +10,7 @@ metadata: ms.collection: collection author: sdwheeler ms.author: sewhee - ms.date: 11/16/2023 + ms.date: 03/18/2025 # highlightedContent section (optional) # Maximum of 8 items @@ -18,7 +18,7 @@ highlightedContent: # itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new items: # Card - - title: Overview + - title: What is PowerShell? itemType: get-started url: /powershell/scripting/overview # Card @@ -61,7 +61,7 @@ productDirectory: text: What's new in PowerShell # Card 2 - title: PowerShell Utility modules - imageSrc: /media/common/ih_tools.svg + imageSrc: /media/common/i_tools.svg links: - url: /powershell/utility-modules/overview?view=ps-modules text: PowerShell utility modules @@ -74,17 +74,17 @@ productDirectory: - url: /powershell/utility-modules/secretmanagement/overview?view=ps-modules text: SecretManagement overview # Card 3 - - title: PowerShell DSC - imageSrc: /media/common/i_dev-ops.svg + - title: Desired State Configuration + imageSrc: /media/common/ih_tools.png links: - url: /powershell/scripting/dsc/overview - text: DSC Overview - - url: /powershell/dsc/overview?view=dsc-1.1 - text: DSC 1.1 in Windows PowerShell - - url: /powershell/dsc/overview?view=dsc-2.0 - text: DSC 2.0 + text: PowerShell DSC Overview - url: /powershell/dsc/overview?view=dsc-3.0 - text: DSC 3.0 (preview) + text: Microsoft DSC 3.0 + - url: /powershell/dsc/overview?view=dsc-2.0 + text: PowerShell DSC 2.0 + - url: /powershell/dsc/overview?view=dsc-1.1 + text: PowerShell DSC 1.1 - url: https://dsccommunity.org/ text: DSC Community # Card 4 @@ -94,8 +94,8 @@ productDirectory: - url: https://www.powershellgallery.com/ text: PowerShell Gallery - url: /powershell/gallery/overview - text: What is the PowerShell Gallery - - url: /powershell/gallery/concepts/publishing-guidelines + text: Package management for PowerShell + - url: /powershell/gallery/powershellget/overview text: Best practices - url: /powershell/gallery/faqs text: FAQs From f96ae0e9920feec2c2d4f553bcfea79fe4c018c5 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Tue, 18 Mar 2025 08:34:59 -0500 Subject: [PATCH 2/3] fix typo --- reference/docs-conceptual/dsc/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/docs-conceptual/dsc/overview.md b/reference/docs-conceptual/dsc/overview.md index 057f227911e0..4456131d5f68 100644 --- a/reference/docs-conceptual/dsc/overview.md +++ b/reference/docs-conceptual/dsc/overview.md @@ -6,8 +6,8 @@ title: PowerShell Desired State Configuration (DSC) # Desired State Configuration (DSC) Overview -DSC is a management platform in PowerShell that enables you to manage your IT and development -infrastructure with configuration as code. +DSC is a management platform that enables you to manage your IT and development infrastructure with +configuration as code. There are three versions of DSC available: From e013db3e86b427e69f660c18ca38fc6f19b551ea Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Tue, 18 Mar 2025 08:45:21 -0500 Subject: [PATCH 3/3] Update DSC descriptions --- reference/docs-conceptual/dsc/overview.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/reference/docs-conceptual/dsc/overview.md b/reference/docs-conceptual/dsc/overview.md index 4456131d5f68..f80d747cee84 100644 --- a/reference/docs-conceptual/dsc/overview.md +++ b/reference/docs-conceptual/dsc/overview.md @@ -1,7 +1,7 @@ --- -description: DSC is a management platform in PowerShell that enables you to manage your IT and development infrastructure with configuration as code. +description: DSC is a management platform that enables you to manage your IT and development infrastructure with configuration as code. ms.date: 03/18/2025 -title: PowerShell Desired State Configuration (DSC) +title: Desired State Configuration (DSC) --- # Desired State Configuration (DSC) Overview @@ -9,14 +9,16 @@ title: PowerShell Desired State Configuration (DSC) DSC is a management platform that enables you to manage your IT and development infrastructure with configuration as code. -There are three versions of DSC available: +There are four versions of DSC available: -- Microsoft DSC 3.0 is the new version of DSC. This version is a preview release that is still being - developed. Users working with non-Windows environments can expect cross-platform features in DSC - 3.0. DSC 3.0 is the version that is supported by the [machine configuration][01] feature of Azure - Automanage. +- **Microsoft DSC 3.0** is the new version of DSC. This version provides true cross-platform + support. It is a standalone product that's not dependent on PowerShell, however, you can still use + your existing PowerShell DSC resources. -- PowerShell DSC 2.0 is the version of DSC that shipped in PowerShell 7. +- **PowerShell DSC 3.0 (preview)** is the version of DSC supported by the + [Azure Machine Configuration][01] on Linux. + +- **PowerShell DSC 2.0** is the version of DSC that shipped in PowerShell 7. With the release of PowerShell 7.2, the **PSDesiredStateConfiguration** module is no longer included in the PowerShell package. Separating DSC into its own module allows us to invest and @@ -25,7 +27,8 @@ There are three versions of DSC available: to deployment of new DSC features. Users that want to continue using DSC v2 can download **PSDesiredStateConfiguration** 2.0.5 from the PowerShell Gallery. -- PowerShell DSC 1.1 is the legacy version of DSC that originally shipped in Windows PowerShell 5.1. +- **PowerShell DSC 1.1** is the legacy version of DSC that originally shipped in Windows PowerShell + 5.1. For more information, see the [Desired State Configuration][02] overview article.