Mulai menggunakan Desired State Configuration (DSC) untuk Windows

Artikel ini menjelaskan cara mulai menggunakan PowerShell Desired State Configuration (DSC) untuk Windows. Untuk informasi umum tentang DSC, lihat Mulai menggunakan Windows PowerShell Desired State Configuration.

Versi sistem operasi Windows yang didukung

Versi berikut ini mendukung:

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

Produk mandiri Microsoft Hyper-V Server tidak berisi implementasi Desired State Configuration sehingga Anda tidak dapat mengelolanya menggunakan PowerShell DSC atau Azure Automation State Configuration.

Menginstal DSC

Konfigurasi Status yang Diinginkan PowerShell disertakan dalam Windows dan diperbarui melalui Windows Management Framework. Versi terbaru Windows Management Framework 5.1.

Catatan

Anda tidak perlu mengaktifkan fitur Windows Server 'DSC-Service' untuk mengelola komputer menggunakan DSC. Fitur tersebut hanya diperlukan saat membuat instans Windows Pull Server.

Menggunakan DSC untuk Windows

Bagian berikut menjelaskan cara membuat dan menjalankan konfigurasi DSC di komputer Windows.

Membuat dokumen MOF konfigurasi

Kata kunci Windows PowerShell Configuration digunakan untuk membuat konfigurasi. Langkah-langkah berikut menjelaskan pembuatan dokumen konfigurasi menggunakan Windows PowerShell.

Menginstal modul yang berisi sumber daya DSC

Windows PowerShell Desired State Configuration mencakup modul bawaan yang berisi sumber daya DSC. Anda juga dapat memuat modul dari sumber eksternal seperti Galeri PowerShell, menggunakan cmdlet PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Tentukan konfigurasi dan buat dokumen konfigurasi:

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"

Menerapkan konfigurasi ke komputer

Catatan

Untuk mengizinkan DSC berjalan, Windows perlu dikonfigurasi untuk menerima perintah jarak jauh PowerShell bahkan saat Anda menjalankan localhost konfigurasi. Untuk mengonfigurasi lingkungan Anda dengan benar, cukup Set-WsManQuickConfig -Force di Terminal PowerShell yang ditingkatkan.

Anda dapat menerapkan dokumen Konfigurasi (file MOF) ke komputer dengan cmdlet Start-DscConfiguration .

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

Mendapatkan status konfigurasi saat ini

Cmdlet Get-DscConfiguration meminta status komputer saat ini dan mengembalikan nilai saat ini untuk konfigurasi.

Get-DscConfiguration

Cmdlet Get-DscLocalConfigurationManager mengembalikan meta-configuration saat ini yang diterapkan ke komputer.

Get-DscLocalConfigurationManager

Menghapus konfigurasi saat ini dari komputer

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Mengonfigurasi pengaturan di Configuration Manager Lokal

Terapkan file MOF Konfigurasi Meta ke komputer menggunakan cmdlet Set-DSCLocalConfigurationManager . Memerlukan jalur ke MOF Konfigurasi Meta.

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

Windows PowerShell file log Konfigurasi Status yang Diinginkan

Log untuk DSC ditulis ke Microsoft-Windows-Dsc/Operational Log Peristiwa Windows. Anda dapat mengaktifkan log lain untuk tujuan penelusuran kesalahan dengan mengikuti langkah-langkah di Where Are DSC Event Logs.