Windows için Desired State Configuration (DSC) kullanmaya başlama

  • Makale

Bu makalede, Windows için PowerShell Desired State Configuration (DSC) kullanmaya başlama açıklanmaktadır. DSC hakkında genel bilgi için bkz. Windows PowerShell Desired State Configuration kullanmaya başlama.

Desteklenen Windows işletim sistemi sürümleri

Aşağıdaki sürümler desteklenir:

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

Microsoft Hyper-V Server tek başına ürünü, Desired State Configuration uygulamasını içermediğinden PowerShell DSC veya Azure Otomasyonu State Configuration kullanarak yönetemezsiniz.

DSC'yi yükleme

PowerShell Desired State Configuration Windows'a dahildir ve Windows Management Framework aracılığıyla güncelleştirilir. En son sürüm Windows Management Framework 5.1'dir.

Not

DSC kullanarak bir makineyi yönetmek için 'DSC-Service' Windows Server özelliğini etkinleştirmeniz gerekmez. Bu özellik yalnızca bir Windows Pull Server örneği oluştururken gereklidir.

Windows için DSC kullanma

Aşağıdaki bölümlerde Windows bilgisayarlarda DSC yapılandırmalarının nasıl oluşturulacağı ve çalıştıracağı açıklanmaktadır.

Yapılandırma MOF belgesi oluşturma

Windows PowerShell Configuration anahtar sözcüğü yapılandırma oluşturmak için kullanılır. Aşağıdaki adımlarda Windows PowerShell kullanılarak yapılandırma belgesi oluşturma işlemi açıklanmaktadır.

DSC kaynaklarını içeren bir modül yükleme

Windows PowerShell Desired State Configuration, DSC kaynaklarını içeren yerleşik modülleri içerir. PowerShellGet cmdlet'lerini kullanarak PowerShell Galerisi gibi dış kaynaklardan da modül yükleyebilirsiniz.

Install-Module 'PSDscResources' -Verbose

Yapılandırma tanımlayın ve yapılandırma belgesini oluşturun:

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"

Yapılandırmayı makineye uygulama

Not

DSC'nin çalışmasına izin vermek için, windows'un bir yapılandırma çalıştırırken bile PowerShell uzak komutlarını alacak şekilde yapılandırılması localhost gerekir. Ortamınızı doğru yapılandırmak için, yalnızca Set-WsManQuickConfig -Force yükseltilmiş bir PowerShell Terminalinde.

Start-DscConfiguration cmdlet'i ile bir makineye Yapılandırma belgeleri (MOF dosyaları) uygulayabilirsiniz.

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

Yapılandırmanın geçerli durumunu alma

Get-DscConfiguration cmdlet'i makinenin geçerli durumunu sorgular ve yapılandırma için geçerli değerleri döndürür.

Get-DscConfiguration

Get-DscLocalConfigurationManager cmdlet'i makineye uygulanan geçerli meta yapılandırmayı döndürür.

Get-DscLocalConfigurationManager

Geçerli yapılandırmayı makineden kaldırma

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Yerel Configuration Manager ayarları yapılandırma

Set-DSCLocalConfigurationManager cmdlet'ini kullanarak makineye meta yapılandırma MOF dosyası uygulayın. Meta Yapılandırma MOF yolunu gerektirir.

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

Günlük dosyalarını Windows PowerShell Desired State Configuration

DSC günlükleri Windows Olay Günlüğü'ne Microsoft-Windows-Dsc/Operational yazılır. DSC Olay Günlükleri Nerede? bölümündeki adımları izleyerek diğer günlükleri hata ayıklama amacıyla etkinleştirebilirsiniz.