使用 Azure Desired State Configuration 延伸模組版本歷程記錄

注意

Azure 自動化 狀態設定 將於 2027 年 9 月 30 日淘汰，請依該日期轉換至 Azure 機器組態。 如需詳細資訊，請參閱 部落格文章 公告。 Azure Machine Configuration 服務結合 DSC 延伸模組、Azure 自動化狀態設定，以及客戶意見反應最常要求的功能。 Azure Machine Configuration 也包含混合機器支援 (透過已啟用 Arc 的伺服器提供)。

警告

Azure 自動化 DSC for Linux 已於 2023 年 9 月 30 日淘汰。 如需詳細資訊，請參閱公告。

Azure Desired State Configuration (DSC) VM 延伸模組會視需求進行更新，以支援 Azure、Windows Server，以及包含 Windows PowerShell 的 Windows Management Framework (WMF) 所帶來的改善與新功能。

本文提供有關各 Azure DSC VM 延伸模組版本的資訊、版本支援的環境，以及對新功能或變更的註解。

最新版本

2.83 版

• 發行日期：
  • 2021 年 2 月
• OS 支援：
  • Windows Server 2019
  • 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 Update
  • WMF 4.0
• 環境：
  • Azure
  • 由 21Vianet 營運的 Microsoft Azure
  • Azure Government
• 備註：此版本的 Windows VM 擴充功能附帶針對不帶正負號二進位檔的修正程式。

2.80 版

• 發行日期：
  • 2019 年 9 月 26 日 (Azure) | 2020 年 7 月 6 日 (21Vianet 操作的 Microsoft Azure) | 2020 年 7 月 20 日 (Azure Government)
• OS 支援：
  • Windows Server 2019
  • 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 Update
  • WMF 4.0
• 環境：
  • Azure
  • 由 21Vianet 營運的 Microsoft Azure
  • Azure Government
• 備註：此版本中包括下列新功能。

版本 2.76

• 發行日期：
  • 2018 年 5 月 9 日 (Azure) | 2018 年 6 月 21 日 (21Vianet 操作的 Microsoft Azure，Azure Government)
• 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 Update
  • WMF 4.0
• 環境：
  • Azure
  • 由 21Vianet 營運的 Microsoft Azure
  • Azure Government
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，DSC 角色會安裝到 VM 上。
• 新功能：
  • 已改進子狀態與其他次要 Bug 修正的延伸模組中繼資料。

支援的版本

警告

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 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，DSC 角色會安裝到 VM 上。
• 新功能：

  • 在 GitHub 強制執行 TLS 1.2 後，您已無法利用 Azure Marketplace 提供的自製資源管理員範本將 VM 導入 Azure 自動化狀態設定，或使用 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。 在部署延伸模組時，若您已在 Resource Manager 範本中指定 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 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，DSC 角色會安裝到 VM 上。
• 新功能：
  • 錯誤修正和改善項目，簡化入口網站中 Azure 自動化狀態設定的使用方式，並提供 Resource Manager 範本。 如需詳細資訊，請參閱 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 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，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 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，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 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，DSC 角色會安裝到 VM 上。
• 新功能：
  • 將 VM UUID 與 DSC 代理程式識別碼公開為延伸模組中繼資料。 同時新增其他小幅度改善項目。

2.23 版

• 發行日期：2017 年 3 月 15 日
• OS 支援：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Nano 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，DSC 角色會安裝到 VM 上。
• 新功能：
  • 新增錯誤修正與其他改善項目。

2.22 版

• 發行日期：2017 年 2 月 8 日
• OS 支援：Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 SP1、Nano 伺服器
• WMF 支援：WMF 5.1、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.1 (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，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 伺服器
• WMF 支援：WMF 5.1 Preview、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.0 RTM (安裝 WMF 需要重新開機)。 針對 Nano 伺服器，DSC 角色會安裝到 VM 上。
• 新功能：
  • DSC 延伸模組現可在 Nano 伺服器上使用。 此版本主要包含在 Nano 伺服器上執行延伸模組的程式碼變更。
  • 同時新增其他小幅度改善項目。

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 Preview、WMF 5.0 RTM、WMF 4.0 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 Technical Preview 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.0 RTM (安裝 WMF 需要重新開機)。
• 新功能：
  • WMF 5.1 Preview 的支援。 在首次發佈時，此版本是選用升級，且您必須在資源管理員範本中指定 Wmfversion = '5.1PP' 才能安裝 WMF 5.1 Preview。 指定 Wmfversion = 'latest' 仍會安裝 WMF 5.0 RTM。 如需 WMF 5.1 Preview 的詳細資訊，請參照此部落格。
  • 同時新增其他小幅度修正與改善項目。

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 Update、WMF 4.0
• 環境：Azure、21Vianet 操作的 Microsoft Azure、Azure Government
• 備註：此版本會使用 Windows Server 2016 Technical Preview 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.0 RTM (安裝 WMF 需要重新開機)。
• 新功能：
  • DSC 延伸模組現在可以在 21Vianet 操作的 Microsoft Azure 中使用。 此版本包含在 21Vianet 操作的 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 Update、WMF 4.0
• 環境：Azure
• 備註：此版本會使用 Windows Server 2016 Technical Preview 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.0 RTM (安裝 WMF 需要重新開機)。
• 新功能：
  • 在下載遙測 Hotfix (已知的 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 Update、WMF 4.0

• 環境：Azure

• 備註：此版本會使用 Windows Server 2016 Technical Preview 內附的 DSC；針對其他 Windows OS，則會安裝 Windows Management Framework 5.0 RTM (安裝 WMF 需要重新開機)。

• 新功能：

  • WMF 4.0 Update 的支援。 如需 WMF 4.0 Update 的詳細資訊，請參照此部落格。
  • 對在安裝 DSC 延伸模組期間，或在安裝延伸模組後套用 DSC 設定時發生的錯誤重試邏輯。 在本次變更中，若先前的安裝失敗或再次制定先前失敗的 DSC 設定，此延伸模組將會重試安裝最多三次，直到達到完成狀態 (成功/錯誤) 或收到新的要求。 若延伸模組的失敗原因是使用者設定/使用者輸入無效，則不會重試。 在此情況下，您必須以新要求叫用延伸模組並修正使用者設定。

  注意

  必須依賴 Azure VM 代理程式才能重試 DSC 延伸模組。 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 需要重新開機)。
• 新功能：
  • 對錯誤處理的改善與其他小幅度 Bug 修正項目。
  • 在 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 延伸模組的 Resource Manager 範本。
• 若想了解可使用 PowerShell DSC 來管理的其他功能和資源，請瀏覽 PowerShell 資源庫。
• 如需有關將敏感性參數傳遞到設定中的詳細資料，請參閱 使用 DSC 延伸模組處理常式來安全地管理認證。