diff --git a/reference/docs-conceptual/dsc/overview.md b/reference/docs-conceptual/dsc/overview.md index 1e548c08c044..f80d747cee84 100644 --- a/reference/docs-conceptual/dsc/overview.md +++ b/reference/docs-conceptual/dsc/overview.md @@ -1,18 +1,24 @@ --- -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 -title: PowerShell Desired State Configuration (DSC) +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: 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. +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: -- 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 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 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 @@ -20,15 +26,11 @@ 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