diff --git a/dsc/TOC.md b/dsc/TOC.md index abd927c7a952..8c98a6a13541 100644 --- a/dsc/TOC.md +++ b/dsc/TOC.md @@ -158,6 +158,8 @@ # [Using DSC on Microsoft Azure](azureDsc.md) +## [DSC Extension History](azureDscexthistory.md) + # DSC MOF Reference ## [MSFT_DSCLocalConfigurationManager class](msft-dsclocalconfigurationmanager.md) diff --git a/dsc/azureDsc.md b/dsc/azureDsc.md index 28e88a4e9ee7..d630fdfb1f3c 100644 --- a/dsc/azureDsc.md +++ b/dsc/azureDsc.md @@ -8,23 +8,24 @@ title: Using DSC on Microsoft Azure # Using DSC on Microsoft Azure Desired State Configuration (DSC) is supported in Microsoft Azure through the -[Azure Desired State Configuration extension handler](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-extensions-dsc-overview) and through -[Azure Automation DSC](https://docs.microsoft.com/azure/automation/automation-dsc-overview). +[Azure Desired State Configuration extension handler](/azure/virtual-machines/virtual-machines-windows-extensions-dsc-overview) and through +[Azure Automation DSC](/azure/automation/automation-dsc-overview). ## Azure Desired State Configuration extension handler The Azure DSC extension allows VMs hosted in Microsoft Azure to be managed with DSC. For more information, see the following topics: -- [Azure Desired State Configuration extension handler](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-extensions-dsc-overview) -- [Windows VMSS and Desired State Configuration with Azure Resource Manager templates](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-extensions-dsc-template) -- [Passing credentials to the Azure DSC extension handler](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-extensions-dsc-credentials) +- [Azure Desired State Configuration extension handler](/azure/virtual-machines/virtual-machines-windows-extensions-dsc-overview) +- [Windows VMSS and Desired State Configuration with Azure Resource Manager templates](/azure/virtual-machines/virtual-machines-windows-extensions-dsc-template) +- [Passing credentials to the Azure DSC extension handler](/azure/virtual-machines/virtual-machines-windows-extensions-dsc-credentials) +- [Azure Desired State Configuration extension history](azureDscexthistory.md) ## Azure Automation DSC -The [Azure Automation service](https://azure.microsoft.com/services/automation/) allows you to manage DSC configurations, resources, and managed nodes from within Azure. For +The [Azure Automation service](/services/automation/) allows you to manage DSC configurations, resources, and managed nodes from within Azure. For more information, see the following topics: -- [Azure Automation DSC](https://docs.microsoft.com/azure/automation/automation-dsc-overview) -- [Getting started with Azure Automation DSC](https://docs.microsoft.com/azure/automation/automation-dsc-getting-started) -- [Onboarding machines for management by Azure Automation DSC](https://docs.microsoft.com/azure/automation/automation-dsc-onboarding) +- [Azure Automation DSC](/azure/automation/automation-dsc-overview) +- [Getting started with Azure Automation DSC](/azure/automation/automation-dsc-getting-started) +- [Onboarding machines for management by Azure Automation DSC](/azure/automation/automation-dsc-onboarding) diff --git a/dsc/azureDscexthistory.md b/dsc/azureDscexthistory.md new file mode 100644 index 000000000000..a38dab48aa19 --- /dev/null +++ b/dsc/azureDscexthistory.md @@ -0,0 +1,251 @@ +--- +description: Learn about the version history for the Desired State Configuration (DSC) extension in Azure. +ms.date: 2018-03-14 +ms.topic: conceptual +keywords: dsc, powershell, azure, extension +title: Azure DSC Extension Version History +author: DCtheGeek +ms.author: dacoulte +--- +# Azure Desired State Configuration extension version history + +The Azure Desired State Configuration (DSC) VM Extension is updated as-needed to support enhancements and new capabilities delivered by Azure, Windows Server, and the Windows Management Framework (WMF) that includes Windows PowerShell. + +This article will provide information about each version of the Azure DSC VM Extension, what it environments it supports, and comments and remarks on new features or changes. + +## Latest Versions + +### Version 2.75 + +- **Release date:** + - March 5, 2018 +- **OS support:** + - Windows Server 2016 + - Windows Server 2012 R2 + - Windows Server 2012 + - Windows Server 2008 R2 SP1 + - Windows Client 7/8.1/10 + - Nano Server +- **WMF support:** + - WMF 5.1 + - WMF 5.0 RTM + - WMF 4.0 Update + - WMF 4.0 +- **Environment:** + - Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - After Github's recent move to TLS 1.2, you can't onboard a VM to Azure Automation DSC using DIY Resource Manager templates available on Azure Marketplace or use DSC extension to get any config hosted on Github. You will see an error similar to the following while deploying the extension: + + ```json + { + "code": "DeploymentFailed", + "message": "At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-debug for usage details.", + "details": [{ + "code": "Conflict", + "message": "{ + \"status\": \"Failed\", + \"error\": { + \"code\": \"ResourceDeploymentFailure\", + \"message\": \"The resource operation completed with terminal provisioning state 'Failed'.\", + \"details\": [ { + \"code\": \"VMExtensionProvisioningError\", + \"message\": \"VM has reported a failure when processing extension 'Microsoft.Powershell.DSC'. + Error message: \\\"The DSC Extension failed to execute: Error downloading + https://github.com/Azure/azure-quickstart-templates/raw/master/dsc-extension-azure-automation-pullserver/UpdateLCMforAAPull.zip + after 29 attempts: The request was aborted: Could not create SSL/TLS secure channel..\\nMore information about the failure can + be found in the logs located under 'C:\\\\WindowsAzure\\\\Logs\\\\Plugins\\\\Microsoft.Powershell.DSC\\\\2.74.0.0' on the VM.\\\".\" + } ] + } + }" + }] + } + ``` + + - In the new extension version, TLS 1.2 is now enforced. While deploying the extension if you already had the AutoUpgradeMinorVersion = true in the Resource Manager template, then the extension will get autoupgraded to 2.75. For manual updates, specify `TypeHandlerVersion = 2.75` in your Resource Manager template. + +### Version 2.19 + +- **Release date:** + - June 3, 2016 +- **OS support:** + - Windows Server 2016 Technical Preview + - Windows Server 2012 R2 + - Windows Server 2012 + - Windows Server 2008 R2 SP1 +- **WMF support:** + - WMF 5.0 RTM + - WMF 4.0 Update + - WMF 4.0 +- **Environment:** + - Azure + - Azure China + - Azure Government +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - The DSC Extension is now on boarded to Azure China. This version primarily contains fixes for running the Extension on Azure China. + +## Supported Versions + +> [!WARNING] +> Versions 2.4 through 2.13 use WMF 5.0 Public Preview whose signing certificates expired in August 2016. For more information about this issue, see [blog post](https://blogs.msdn.microsoft.com/powershell/2016/05/24/azure-dsc-extension-versions-2-4-up-to-2-13-will-retire-in-august/). + +### Version 2.70 - 2.72 + +- **Release date:** November 13, 2017 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server +- **WMF support:** WMF 5.1, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - Bug fixes & improvements that simplifies using DSC Azure Automation through the portal UI as well as Resource Manager template. For more information, see [Default Configuration Script](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/extensions-dsc-overview#default-configuration-script) in the DSC Extension documentation. + +### Version 2.26 + +- **Release date:** June 9, 2017 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server +- **WMF support:** WMF 5.1, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - Telemetry improvements. + +### Version 2.25 + +- **Release date:** June 2, 2017 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server +- **WMF support:** WMF 5.1, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - Several bug fixes and other minor improvements were added. + +### Version 2.24 + +- **Release date:** April 13, 2017 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server +- **WMF support:** WMF 5.1, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - Exposes VM UUID & DSC Agent ID as extension metadata. Other minor improvements were added. + +### Version 2.23 + +- **Release date:** March 15, 2017 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server +- **WMF support:** WMF 5.1, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - Lots of bug fixes and other improvements were added. + +### Version 2.22 + +- **Release date:** February 8, 2017 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server +- **WMF support:** WMF 5.1, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.1](https://blogs.msdn.microsoft.com/powershell/2016/12/06/wmf-5-1-releasing-january-2017/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - The DSC Extension now has support for WMF 5.1. + - Minor other improvements were added. + +### Version 2.21 + +- **Release date:** December 2, 2016 +- **OS support:** Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server +- **WMF support:** WMF 5.1 Preview, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). For Nano, DSC role is installed on the VM. +- **New features:** + - The DSC Extension is now available on Nano Server. This version primarily contains code changes for running the Extension on Nano server. + - Minor other improvements were added. + +### Version 2.20 + +- **Release date:** August 2, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.1 Preview, WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - Support for WMF 5.1 Preview. When first published, this version was an optional upgrade and you had to specify Wmfversion = ‘5.1PP’ in Resource Manager templates to install WMF 5.1 preview. Wmfversion = ‘latest’ still installs the [WMF 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/). For more information on WMF 5.1 preview, see [this blog]( https://blogs.msdn.microsoft.com/powershell/2016/07/16/announcing-windows-management-framework-wmf-5-1-preview/). + - Minor other fixes and improvements were added. + +### Version 2.19 + +- **Release date:** June 3, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure, Azure China, Azure Government +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - The DSC Extension is now on boarded to Azure China. This version primarily contains fixes for running the Extension on Azure China. + +### Version 2.18 + +- **Release date:** June 3, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - Make telemetry non-blocking when an error occurs during telemetry hotfix download (known Azure DNS issue) or during install. + - Fix for the intermittent issue where extension stops processing configuration after a reboot. This was causing the DSC Extension to remain in ‘transitioning’ state. + - Minor other fixes and improvements were added. + +### Version 2.17 + +- **Release date:** April 26, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.0 RTM, WMF 4.0 Update, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - Support for WMF 4.0 Update. For more information on WMF 4.0 Update, see [this blog](https://blogs.msdn.microsoft.com/powershell/2016/01/19/windows-management-framework-wmf-4-0-update-now-available-for-windows-server-2012-windows-server-2008-r2-sp1-and-windows-7-sp1/). + - Retry logic on errors that occur during the DSC Extension install or while applying a DSC configuration post extension install. As a part of this change, the extension will retry the installation if a previous install failed or re-enact a DSC configuration that had previously failed, for a maximum three times until it reaches the completion state (Success/Error) or if a new request comes. If the extension fails due to invalid user settings/user input, it does not retry. In this case, the extension needs to be invoked again with a new request and correct user settings. Note: The DSC Extension is dependent on the Azure VM agent for the retries. Azure VM agent invokes the extension with the last failed request until it reaches a success or error state. + +### Version 2.16 + +- **Release date:** April 21, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.0 RTM, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - Improvement in Error Handling and other minor bug fixes. + - New property in DSC Extension settings. ‘ForcePullAndApply’ in AdvancedOptions is added to enable the DSC Extension enact DSC configurations when the refresh mode is Pull (as opposed to the default Push mode). For more information, please refer to [this blog](https://blogs.msdn.microsoft.com/powershell/2016/02/26/arm-dsc-extension-settings/) to get more information on the DSC Extension settings. + +### Version 2.15 + +- **Release date:** March 14, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.0 RTM, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - In extension version 2.14, changes to install WMF RTM were included. While upgrading from extension version 2.13.2.0 to 2.14.0.0, you may notice that some DSC cmdlets fail or your configuration fails with an error – ‘No Instance found with given property values’. For more information, see the [DSC release notes](https://msdn.microsoft.com/en-us/powershell/wmf/limitation_dsc). The workarounds for these issues have been added in 2.15 version. + - Unfortunately, if you have already installed version 2.14 and are running into one of the above two issues, you will need to perform these steps manually. In an elevated PowerShell session: + - `Remove-Item -Path $env:SystemRoot\system32\Configuration\DSCEngineCache.mof` + - `mofcomp $env:windir\system32\wbem\DscCoreConfProv.mof` + +### Version 2.14 + +- **Release date:** February 25, 2016 +- **OS support:** Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1 +- **WMF support:** WMF 5.0 RTM, WMF 4.0 +- **Environment:** Azure +- **Remarks:** This version uses DSC as included in Windows Server 2016 Technical Preview; for other Windows OSes, it installs the [Windows Management Framework 5.0 RTM](https://blogs.msdn.microsoft.com/powershell/2015/12/16/windows-management-framework-wmf-5-0-rtm-is-now-available/) (installing WMF requires a reboot). +- **New features:** + - Uses WMF RTM. + - Enables data collection in order to improve the quality of the DSC Extension. For more information, see [the blog](https://blogs.msdn.microsoft.com/powershell/2016/02/02/azure-dsc-extension-data-collection-2/). + - Provides an updated settings format for the extension in a Resource Manager template. For more information, see [the blog](https://blogs.msdn.microsoft.com/powershell/2016/02/26/arm-dsc-extension-settings/). + - Bug fixes and other enhancements. + +## Next steps + +- For more information about PowerShell DSC, go to the [PowerShell documentation center](overview.md). +- Examine the [Resource Manager template for the DSC extension](/azure/virtual-machines/windows/extensions-dsc-template). +- For more functionality that you can manage by using PowerShell DSC, and for more DSC resources, browse the [PowerShell gallery](https://www.powershellgallery.com/packages?q=DscResource&x=0&y=0). +- For details about passing sensitive parameters into configurations, see [Manage credentials securely with the DSC extension handler](/azure/virtual-machines/windows/extensions-dsc-credentials). \ No newline at end of file