A Windows Desired State Configuration (DSC) használatának első lépései

Ez a cikk bemutatja, hogyan kezdheti meg a Windows PowerShell Desired State Configuration (DSC) használatát. A DSC-vel kapcsolatos általános információkért lásd: Első lépések a Windows PowerShell Desired State Configuration.

Támogatott Windows operációsrendszer-verziók

Az alábbi verziók támogatottak:

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

A Microsoft Hyper-V Server önálló terméke nem tartalmazza a Desired State Configuration implementációját, így nem kezelheti a PowerShell DSC vagy Azure Automation State Configuration használatával.

A DSC telepítése

A PowerShell-Desired State Configuration a Windows tartalmazza, és Windows Management Framework frissítve. A legújabb verzió Windows Management Framework 5.1.

Megjegyzés

Nem kell engedélyeznie a "DSC-Service" Windows Server szolgáltatást a gépek DSC használatával történő kezeléséhez. Erre a funkcióra csak Windows Pull Server-példány létrehozásakor van szükség.

A DSC használata Windowshoz

Az alábbi szakaszok ismertetik, hogyan hozhat létre és futtathat DSC-konfigurációkat Windows rendszerű számítógépeken.

Konfigurációs MOF-dokumentum létrehozása

A Windows PowerShell Configuration kulcsszóval hozhat létre konfigurációt. Az alábbi lépések egy konfigurációs dokumentum létrehozását ismertetik Windows PowerShell használatával.

DSC-erőforrásokat tartalmazó modul telepítése

Windows PowerShell Desired State Configuration DSC-erőforrásokat tartalmazó beépített modulokat tartalmaz. A modulokat külső forrásokból, például a PowerShell-galéria is betöltheti a PowerShellGet parancsmagok használatával.

Install-Module 'PSDscResources' -Verbose

Adjon meg egy konfigurációt, és hozza létre a konfigurációs dokumentumot:

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"

A konfiguráció alkalmazása a gépre

Megjegyzés

A DSC futtatásának engedélyezéséhez a Windowst úgy kell konfigurálni, hogy távoli PowerShell-parancsokat fogadjon még akkor is, ha ön konfigurációt localhost futtat. A környezet megfelelő konfigurálásához csak Set-WsManQuickConfig -Force egy emelt szintű PowerShell-terminálban.

A Start-DscConfiguration parancsmaggal konfigurációs dokumentumokat (MOF-fájlokat) alkalmazhat egy számítógépre.

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

A konfiguráció aktuális állapotának lekérése

A Get-DscConfiguration parancsmag lekérdezi a gép aktuális állapotát, és visszaadja a konfiguráció aktuális értékeit.

Get-DscConfiguration

A Get-DscLocalConfigurationManager parancsmag a gépre alkalmazott aktuális metakonfigurációt adja vissza.

Get-DscLocalConfigurationManager

Az aktuális konfiguráció eltávolítása egy gépről

A Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Beállítások konfigurálása a Helyi Configuration Manager

Metakonfigurációs MOF-fájl alkalmazása a gépre a Set-DSCLocalConfigurationManager parancsmaggal. A metakonfigurációs MOF elérési útját igényli.

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

Windows PowerShell Desired State Configuration naplófájlok

A DSC naplói a Microsoft-Windows-Dsc/Operational Windows eseménynaplójába lesznek írva. Az egyéb naplókat hibakeresési célokra a Where Are DSC Event Logs (Hol vannak a DSC-eseménynaplók) című témakörben ismertetett lépések végrehajtásával engedélyezheti.