Konfigurace DSC

  • Článek

Platí pro: PowerShell 7, funkce konfigurace počítače v Azure Automanage

Konfigurace DSC jsou skripty PowerShellu, které definují zvláštní druh příkazu. K definování konfigurace použijte klíčové slovo configurationPowerShellu .

Configuration MyDscConfiguration {
    Environment FirstEnvironmentVariable {
        Ensure = 'Present'
        Name   = 'Foo'
        Value  = 'Example'
    }

    Environment SecondEnvironmentVariable {
        Ensure = 'Present'
        Name   = 'Bar'
        Value  = 'Another'
    }
}

MyDscConfiguration

Uložte skript jako .ps1 soubor.

Syntaxe konfigurace

Konfigurační skript DSC se skládá z následujících částí:

  • Blok.Configuration Toto je vnější skriptovací blok. Definujete ho pomocí klíčového Configuration slova a zadáte název. V tomto případě je MyDscConfigurationnázev konfigurace DSC .
  • Jeden nebo více bloků prostředků DSC Tady konfigurace DSC definuje nastavení pro komponentu, kterou konfiguruje. V tomto případě existují dva bloky prostředků DSC. Oba používají Environment prostředek DSC.

Kompilace konfigurace

Než budete moct použít konfiguraci DSC, musíte ji zkompilovat do dokumentu MOF. Provedete to voláním konfigurace DSC, jako byste volali funkci PowerShellu. Poslední řádek příkladu, který obsahuje pouze název konfigurace DSC, provede konfiguraci DSC.

Poznámka

Pokud chcete volat konfiguraci DSC, musí být načtená v aktuálním oboru (stejně jako u jakékoli jiné funkce PowerShellu). Můžete to provést buď pomocí příkazu "dot-sourcing" skriptu, nebo spuštěním skriptu pomocí klávesy F5 nebo kliknutím na tlačítko Spustit skript ve VS Code. Pokud chcete vytvořit zdroj skriptu dot, spusťte příkaz . .\myConfig.ps1 , kde myConfig.ps1 je název souboru skriptu, který obsahuje vaši konfiguraci DSC.

Při volání konfigurace DSC:

  • Vytvoří složku v aktuálním adresáři se stejným názvem jako konfigurace DSC.
  • Vytvoří soubor s názvem localhost.mof v novém adresáři.

Poznámka

Soubor MOF obsahuje všechny informace o konfiguraci systému. Z tohoto důvodu je důležité ho udržovat v bezpečí.

Použití nových prostředků DSC v konfiguraci DSC

Pokud jste spustili předchozí příklady, možná jste si všimli, že jste dostali upozornění, že používáte prostředek, aniž byste ho explicitně importovali.

Pomocí rutiny Get-DscResource můžete určit, které prostředky jsou v systému nainstalované a dostupné pro použití. I když byly jejich moduly umístěny v $env:PSModulePath a jsou rozpoznány nástrojem Get-DscResource, stále je potřeba je načíst v rámci konfigurace DSC.

Import-DscResource je dynamické klíčové slovo, které lze rozpoznat pouze v rámci Configuration bloku. Není to rutina. Import-DscResource podporuje dva parametry:

  • ModuleName je doporučený způsob použití Import-DscResource. Přijímá název modulu, který obsahuje prostředky, které se mají importovat (a pole řetězců názvů modulů).
  • Název je název prostředku, který se má importovat. Toto není popisný název vrácený jako vlastnost Name návratového Get-DscResourceobjektu , ale název třídy použitý při definování schématu prostředků (vlastnost ResourceType objektu vráceného nástrojem Get-DscResource).

Další informace o použití Import-DSCResourcenajdete v tématu Použití import-DSCResource.

Důležité

V konfiguraci počítače existuje omezení, které brání prostředku DSC v používání rutin PowerShellu, které nejsou součástí samotného PowerShellu nebo modulu na Galerie prostředí PowerShell. Prostředky DSC, které používají rutiny z jednoho nebo více modulů Windows , nebudou v konfiguraci počítače fungovat.

Viz také