Kullanmaya başlayın için Desired State Configuration (DSC) ile Windows

  • Makale
  • Okumak için 2 dakika

Bu konu başlığında, powershell için PowerShell Desired State Configuration (DSC) kullanmaya Windows. DSC hakkında genel bilgi için bkz. Başlarken ile Windows PowerShell Desired State Configuration.

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 Server 2012R2
  • Windows Server 2012
  • Windows Server 2008 R2 SP1
  • Windows 11
  • Windows 10
  • Windows 8.1
  • Windows 7

Microsoft Hyper-V Server tek başına ürün sku'su bir Desired State Configuration uygulaması içermez, bu nedenle PowerShell DSC veya Azure Otomasyonu State Configuration.

DSC'yi Yükleme

PowerShell Desired State Configuration, Windows ve Windows Management Framework. En son sürüm 5.1 Windows Management Framework sürümüdür.

Not

DSC kullanarak bir makineyi yönetmek Windows Sunucu özelliği 'DSC-Service' özelliğini etkinleştirmeniz gerek değildir. Bu özellik yalnızca çekme sunucusu örneği Windows gereklidir.

Windows için DSC kullanma

Aşağıdaki bölümlerde, farklı bilgisayarlarda DSC yapılandırmaları oluşturma ve Windows açıklanmaktadır.

Yapılandırma MOF belgesi oluşturma

Yapılandırma Windows PowerShell Configuration anahtar sözcüğü kullanılır. Aşağıdaki adımlarda, bir yapılandırma belgesinin Windows PowerShell.

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

Windows PowerShell Desired State Configuration DSC kaynaklarını içeren yerleşik modüller içerir. Ayrıca, PowerShellGet cmdlet'lerini kullanarak PowerShell Galerisi gibi dış kaynaklardan modüller de yükleysiniz.

Install-Module 'PSDscResources' -Verbose

Yapılandırma tanımlama ve yapılandırma belgesini oluşturma

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 Windows, yapılandırma çalıştırıldığında bile PowerShell uzak komutlarını alacak şekilde yapılandırılması localhost gerekir. Ortamınızı kolayca doğru şekilde yapılandırmak için yükseltilmiş bir Set-WsManQuickConfig -Force PowerShell Terminali'ni çalıştırmanız gerekir.

Yapılandırma belgeleri (MOF dosyaları), Start-DscConfiguration cmdlet'i kullanılarak makineye uygulanabilir.

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

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

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ırmasını döndürür.

Get-DscLocalConfigurationManager

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

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Yerel Ayarlar'da ayarları Yapılandırma Yöneticisi

Set-DSCLocalConfigurationManager cmdlet'ini kullanarak makineye bir Meta Yapılandırma MOF dosyası uygulama. Meta Yapılandırma MOF yolunu gerektirir.

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

Windows PowerShell Desired State Configuration günlük dosyaları

DSC günlükleri yolundaki Windows Günlüğü'ne Microsoft-Windows-Dsc/Operational yazılır. Hata ayıklama amacıyla ek günlükler, DSC Olay Günlükleri nerededir? adımlarını takip eden etkinleştirilebilir.