你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure Desired State Configuration 扩展版本历史记录

项目
10/22/2024

注意

Azure 自动化 State Configuration 将于 2027 年 9 月 30 日停用，请在该日期之前转换到 Azure 计算机配置。有关详细信息，请参阅博客文章公告。 Azure Machine Configuration 服务结合了 DSC 扩展、Azure Automation State Configuration 以及客户反馈中最常请求的功能。 Azure Machine Configuration 还包括通过已启用 Arc 的服务器提供的混合计算机支持。

注意

适用于 Linux 的 Azure Automation DSC 已于 2023 年 9 月 30 日停用。有关详细信息，请参阅公告。

已根据需要更新 Azure Desired State Configuration (DSC) VM 扩展，以支持 Azure、Windows Server 和 Windows Management Framework (WMF)（包含 Windows PowerShell）提供的增强功能和新功能。

本文介绍了 Azure DSC VM 扩展的各个版本及其支持的环境，并说明了新功能或变化。

支持的版本

警告

版本 2.4 至 2.13 使用 WMF 5.0 公共预览版，其签名证书在 2016 年 8 月过期。有关此问题的详细信息，请参阅以下博客文章。

版本 2.75

发布日期：2018 年 3 月 5 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Windows 客户端 7/8.1/10、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。

新功能：

在 GitHub 强制实施 TLS 1.2 后，便无法使用 Azure 市场提供的 DIY 资源管理器模板将 VM 加入到 Azure 自动化 State Configuration 中，也无法使用 DSC 扩展来检索 GitHub 上托管的任何配置。在部署扩展时，将返回类似于下面的错误：

{
    "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.\\\".\"
                } ]
            }
        }"
    }]
}

在新的扩展版本中，现已强制执行 TLS 1.2。部署扩展时，如果已在资源管理器模板中指定 AutoUpgradeMinorVersion = true，则该扩展将自动升级到 2.75。若要进行手动更新，请在资源管理器模板中指定 TypeHandlerVersion = 2.75。

版本 2.70 - 2.72

发布日期：2017 年 11 月 13 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Windows 客户端 7/8.1/10、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- 进行了 Bug 修复和改进，简化了在门户以及资源管理器模板中使用 Azure 自动化 State Configuration 的过程。有关详细信息，请参阅 DSC 扩展文档中的默认配置脚本。

版本 2.26

发布日期：2017 年 6 月 9 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Windows 客户端 7/8.1/10、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- 遥测改进。

版本 2.25

发布日期：2017 年 6 月 2 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Windows 客户端 7/8.1/10、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- 添加了多项 bug 修复和其他小的改进。

版本 2.24

发布日期：2017 年 4 月 13 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- 将 VM UUID 和 DSC 代理 ID 公开为扩展元数据。添加了其他小的改进。

版本 2.23

发布日期：2017 年 3 月 15 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- 添加了 Bug 修复和其他改进。

版本 2.22

发布日期：2017 年 2 月 8 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Nano Server
WMF 支持：WMF 5.1、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.1（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- DSC 扩展现在支持 WMF 5.1。
- 添加了其他小的改进。

版本 2.21

发布日期：2016 年 12 月 2 日
OS 支持：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Nano Server
WMF 支持：WMF 5.1 预览版、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注：此版本使用包括在 Windows Server 2016 中的 DSC；对于其他 Windows OS，它安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。对于 Nano Server，DSC 角色安装在 VM 上。
新功能：
- 现在可在 Nano Server 上使用 DSC 扩展。这一版主要更改了在 Nano Server 上运行扩展所需的代码。
- 添加了其他小的改进。

版本 2.20

发布日期：2016 年 8 月 2 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持：WMF 5.1 预览版、WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- 支持 WMF 5.1 预览版。此版本在首次发布时是一个可选升级，必须在资源管理器模板中指定 Wmfversion =“5.1PP”来安装 WMF 5.1 预览版。若 Wmfversion =“latest”，则仍安装 WMF 5.0 RTM。有关 WMF 5.1 预览版的详细信息，请参阅此博客。
- 添加了其他小的修复和改进。

版本 2.19

发布日期： 2016 年 6 月 3 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持： WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure、由世纪互联运营的 Microsoft Azure、Azure 政府
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- DSC 扩展现已在由世纪互联运营的 Microsoft Azure 中提供。此版本包含有关在由世纪互联运营的 Microsoft Azure 上运行扩展的修补程序。

版本 2.18

发布日期： 2016 年 6 月 3 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持： WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- 当遥测修补程序下载（已知 Azure DNS 问题）或安装期间出现错误时不阻止遥测。
- 修复了扩展在重启后停止处理配置的间歇性问题。这将导致 DSC 扩展仍然处于“正在转换”状态。
- 添加了其他小的修复和改进。

版本 2.17

发布日期：2016 年 4 月 26 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持： WMF 5.0 RTM、WMF 4.0 更新、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- 支持 WMF 4.0 更新。有关 WMF 4.0 更新的详细信息，请参阅此博客。
- 针对在 DSC 扩展安装期间或在扩展安装后应用 DSC 配置时出现的错误的重试逻辑。作为此更改的一部分，如果之前安装失败或重新执行之前失败的 DSC 配置，则扩展将至多重试安装三次，直到达到完成状态（成功/错误）或传入新请求。如果扩展因无效的用户设置/用户输入失败，则不会重试。在这种情况下，需要使用新的请求和正确的用户设置再次调用扩展。
注意

DSC 扩展依赖于 Azure VM 代理进行重试。 Azure VM 代理使用最后失败的请求调用扩展，直到达到成功或错误状态。

版本 2.16

发布日期：2016 年 4 月 21 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持：WMF 5.0 RTM、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- 错误处理改进和其他细微缺陷修复。
- DSC 扩展设置中的新属性。已添加 AdvancedOptions 中的 ForcePullAndApply，以便使 DSC 扩展在刷新模式为请求（与默认的推送模式相反）时执行 DSC 配置。有关 DSC 扩展设置的详细信息，请参阅此博客。

版本 2.15

发布日期：2016 年 3 月 14 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持：WMF 5.0 RTM、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- 在扩展版本 2.14 中，包括了对安装 WMF RTM 的更改。从扩展版本 2.13.2.0 升级到 2.14.0.0 时，你可能会注意到某些 DSC cmdlet 失败或配置失败，并出现错误“未找到含给定属性值的实例”。有关详细信息，请参阅 DSC 发行说明。 2.15 版中已添加这些问题的解决方法。
- 如果你已安装版本 2.14 且遇到上述两个问题之一，则需要手动执行这些步骤。在提升的 PowerShell 会话中运行以下命令：
  - Remove-Item -Path $env:SystemRoot\system32\Configuration\DSCEngineCache.mof
  - mofcomp $env:windir\system32\wbem\DscCoreConfProv.mof

版本 2.14

发布日期：2016 年 2 月 25 日
OS 支持： Windows Server 2016 Technical Preview、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1
WMF 支持：WMF 5.0 RTM、WMF 4.0
环境：Azure
备注： 此版本使用 Windows Server 2016 Technical Preview 中随附的 DSC；对于其他 Windows OS，它会安装 Windows Management Framework 5.0 RTM（安装 WMF 需要重启）。
新功能：
- 使用 WMF RTM。
- 启用数据收集，以提高 DSC 扩展的质量。有关详细信息，请参阅这篇博客文章。
- 在资源管理器模板中为扩展提供更新的设置格式。有关详细信息，请参阅这篇博客文章。
- Bug 修复和其他增强功能。

后续步骤

有关 PowerShell DSC 的详细信息，请查看 PowerShell 文档中心。
查看适用于 DSC 扩展的资源管理器模板。
若要查看可使用 PowerShell DSC 进行管理的其他功能和资源，请浏览 PowerShell 库。
有关将敏感参数传入配置的详细信息，请参阅使用 DSC 扩展处理程序安全管理凭据。

通过