開始使用適用於 Windows 的 Desired State Configuration (DSC)

本文說明如何開始使用 PowerShell Desired State Configuration (DSC) for Windows。 如需 DSC 的一般資訊，請參閱開始使用 Windows PowerShell 預期狀態設定。

支援的 Windows 作業系統版本

下面是支援的版本：

• Windows Server 2022
• Windows Server 2019
• Windows Server 2016
• Windows 11
• Windows 10

Microsoft Hyper-V Server 獨立產品不包含 Desired State Configuration 實作，因此您無法使用 PowerShell DSC 或 Azure 自動化 狀態設定 來管理它。

安裝 DSC

PowerShell Desired State Configuration 包含在 Windows 中，而且透過 Windows Management Framework 來更新。 最新版本是 Windows Management Framework 5.1 \(英文\)。

注意

您不需要啟用 Windows Server 功能 'DSC-Service'，即可使用 DSC 管理計算機。 只有在建置 Windows 提取伺服器執行個體時，才需要該功能。

使用適用於 Windows 的 DSC

下列各節說明如何在 Windows 電腦上建立並執行 DSC 設定。

建立設定 MOF 文件

Windows PowerShell Configuration 關鍵字可用來建立設定。 下列步驟說明如何使用 Windows PowerShell 建立設定文件。

安裝包含 DSC 資源的模組

Windows PowerShell Desired State Configuration 包含內有 DSC 資源的內建模組。 您也可以使用 PowerShellGet Cmdlet，從外部來源 (例如，PowerShell 資源庫) 載入模組。

Install-Module 'PSDscResources' -Verbose

定義設定，然後產生設定文件：

Configuration EnvironmentVariable_Path
{
    param ()

    Import-DscResource -ModuleName 'PSDscResources'

    Node localhost
    {
        Environment CreatePathEnvironmentVariable
        {
            Name = 'TestPathEnvironmentVariable'
            Value = 'TestValue'
            Ensure = 'Present'
            Path = $true
            Target = @('Process', 'Machine')
        }
    }
}

EnvironmentVariable_Path -OutputPath:"./EnvironmentVariable_Path"

將設定套用至機器

注意

若要允許 DSC 執行，就必須將 Windows 設定成即使在您執行 localhost 設定時，也接收 PowerShell 遠端命令。 若要正確設定您的環境，請直接 Set-WsManQuickConfig -Force 在提升許可權的PowerShell終端機中。

您可以使用 Start-DscConfiguration Cmdlet，將設定檔 (MOF 檔案) 套用至計算機。

Start-DscConfiguration -Path 'C:\EnvironmentVariable_Path' -Wait -Verbose

取得設定的目前狀態

Get-DscConfiguration Cmdlet 會查詢機器的目前狀態，並傳回設定的目前值。

Get-DscConfiguration

Get-DscLocalConfigurationManager Cmdlet 會傳回套用至電腦的目前中繼設定。

Get-DscLocalConfigurationManager

將目前設定從電腦移除

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

設定本機 Configuration Manager 中的設定

使用 Set-DSCLocalConfigurationManager Cmdlet，將中繼設定 MOF 檔案套用至電腦。 需要中繼設定 MOF 路徑。

Set-DSCLocalConfigurationManager -Path 'c:\metaconfig\localhost.meta.mof' -Verbose

Windows PowerShell Desired State Configuration 記錄檔

DSC 的記錄會寫入 Microsoft-Windows-Dsc/Operational Windows 事件記錄檔。 您可以依照 DSC 事件記錄中的步驟，啟用其他記錄以進行偵錯。