This post describes the requirements and usage and gives examples for the Windows PowerShell Desired State Configuration (DSC) VM extension handler for Azure. The VM Extension allows you to use Powershell Desired State Configuration to configure your Azure VMs. For more information about Powershell Desired State Configuration, see Introduction to Windows Powershell Desired State Configuration. For more details about this and other Azure VM extensions, see Azure VM Extensions and Features.
To use the Azure PowerShell DSC VM extension, you must install Azure PowerShell. In addition, The DSC extension handler has a dependency on Windows Management Framework v5. This is automatically installed by the extension handler. Today, Windows Management Framework v5 is only available for Windows 2012 R2, which means that currently the only Windows Server VM images that support the DSC VM extension handler is Windows 2012 R2 images.
Important Functionality :
The following table will help you navigate the documentation for DSC.
|Get Started with Windows PowerShell Desired State Configuration||Explains how to use Windows PowerShell extensions that are part of DSC to automate an example configuration.|
|Windows PowerShell Desired State Configuration Resources||Explains how to create custom resources for if your environment requires a type of configuration that is not provided by the built-in resources that come in DSC for performing basic configuration work.|
|Windows PowerShell Desired State Configuration Data||Demonstrates a structured way to separate the data used in configuration from the configuration logic. This provides modularity, which enables you reuse the data and the logic independently. It also makes it easier to update the data and logic when necessary.|
|Windows PowerShell Desired State Configuration Local Configuration Manager||Explains the DSC engine, which is available on all nodes (computers) and coordinates the reception and application of configuration data for each node.|
|Windows PowerShell Desired State Configuration Service||Explains the DSC Service, which includes the options to push configuration information to target nodes, or to have an environment where the nodes retrieve the information from a server that is set up for that purpose. The nodes can continue to update and maintain their state, based on the configuration information on that server. It is also possible to use such a server to distribute custom resources to the target nodes.|
|Windows PowerShell Desired State Configuration Troubleshooting Guidance||Provides several techniques you can use to troubleshoot your DSC configuration or to track the progress of its operations.|