Začínáme s Desired State Configuration (DSC) pro Windows

  • Článek

Tento článek vysvětluje, jak začít používat PowerShell Desired State Configuration (DSC) pro Windows. Obecné informace o DSC najdete v tématu Začínáme s Windows PowerShell Desired State Configuration.

Podporované verze operačního systému Windows

Podporují se následující verze:

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

Samostatný produkt Microsoft Hyper-V Server neobsahuje implementaci Desired State Configuration, takže ho nemůžete spravovat pomocí PowerShell DSC nebo Azure Automation State Configuration.

Instalace DSC

PowerShell Desired State Configuration je součástí Windows a aktualizuje se prostřednictvím Windows Management Framework. Nejnovější verze je Windows Management Framework 5.1.

Poznámka

Abyste mohli spravovat počítač pomocí DSC, nemusíte povolovat funkci DSC-Service systému Windows Server. Tato funkce je potřeba jenom při vytváření instance Windows Pull Serveru.

Použití DSC pro Windows

Následující části vysvětlují, jak vytvořit a spustit konfigurace DSC na počítačích s Windows.

Vytvoření dokumentu MOF konfigurace

Klíčové slovo Windows PowerShell Configuration slouží k vytvoření konfigurace. Následující postup popisuje vytvoření dokumentu konfigurace pomocí Windows PowerShell.

Instalace modulu obsahujícího prostředky DSC

Windows PowerShell Desired State Configuration obsahuje integrované moduly obsahující prostředky DSC. Moduly můžete také načíst z externích zdrojů, jako je Galerie prostředí PowerShell, pomocí rutin PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Definujte konfiguraci a vygenerujte dokument konfigurace:

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"

Použití konfigurace na počítač

Poznámka

Aby bylo možné spustit DSC, musí být systém Windows nakonfigurovaný tak, aby přijímal vzdálené příkazy PowerShellu localhost , i když spouštíte konfiguraci. Pokud chcete správně nakonfigurovat prostředí, stačí Set-WsManQuickConfig -Force v terminálu PowerShellu se zvýšenými oprávněními.

Dokumenty konfigurace (soubory MOF) můžete na počítač použít pomocí rutiny Start-DscConfiguration .

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

Získání aktuálního stavu konfigurace

Rutina Get-DscConfiguration se dotazuje na aktuální stav počítače a vrátí aktuální hodnoty pro konfiguraci.

Get-DscConfiguration

Rutina Get-DscLocalConfigurationManager vrátí aktuální metakonfiguraci použitou na počítač.

Get-DscLocalConfigurationManager

Odebrání aktuální konfigurace z počítače

The Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Konfigurace nastavení v místním Configuration Manager

Použijte k počítači soubor MOF metakonfigurace pomocí rutiny Set-DSCLocalConfigurationManager . Vyžaduje cestu k moF meta configuration.

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

Windows PowerShell Desired State Configuration souborů protokolů

Protokoly pro DSC se zapisují do Microsoft-Windows-Dsc/Operational protokolu událostí systému Windows. Další protokoly pro účely ladění můžete povolit podle kroků v tématu Kde jsou protokoly událostí DSC.