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

發行項
03/22/2024

注意

啟用自動化狀態設定之前，希望您知道較新版的 DSC 現在已正式推出，由 Azure 原則的來賓設定功能所管理。來賓設定服務結合 DSC 延伸模組、Azure 自動化狀態設定，以及客戶意見反應最常要求的功能。來賓設定也包含透過已啟用 Arc 的伺服器的混合式電腦支援。

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

本文提供有關各 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 伺服器
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 延伸模組處理常式來安全地管理認證。