Kom igång med Desired State Configuration (DSC) för Windows

Den här artikeln beskriver hur du kommer igång med PowerShell Desired State Configuration (DSC) för Windows. Allmän information om DSC finns i Kom igång med Windows PowerShell Desired State Configuration.

Versioner av Windows-operativsystem som stöds

Följande versioner stöds:

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

Den fristående Microsoft Hyper-V Server-produkten innehåller inte någon implementering av Desired State Configuration så du kan inte hantera den med hjälp av PowerShell DSC eller Azure Automation State Configuration.

Installera DSC

PowerShell Desired State Configuration ingår i Windows och uppdateras via Windows Management Framework. Den senaste versionen är Windows Management Framework 5.1.

Anteckning

Du behöver inte aktivera Windows Server-funktionen "DSC-Service" för att hantera en dator med DSC. Den funktionen behövs bara när du skapar en Windows Pull Server-instans.

Använda DSC för Windows

I följande avsnitt beskrivs hur du skapar och kör DSC-konfigurationer på Windows-datorer.

Skapa ett MOF-konfigurationsdokument

Nyckelordet Windows PowerShell Configuration används för att skapa en konfiguration. Följande steg beskriver hur du skapar ett konfigurationsdokument med hjälp av Windows PowerShell.

Installera en modul som innehåller DSC-resurser

Windows PowerShell Desired State Configuration innehåller inbyggda moduler som innehåller DSC-resurser. Du kan också läsa in moduler från externa källor, till exempel PowerShell-galleriet, med hjälp av PowerShellGet-cmdletar.

Install-Module 'PSDscResources' -Verbose

Definiera en konfiguration och generera konfigurationsdokumentet:

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"

Tillämpa konfigurationen på datorn

Anteckning

För att DSC ska kunna köras måste Windows konfigureras för att ta emot PowerShell-fjärrkommandon även när du kör en localhost konfiguration. För att konfigurera din miljö korrekt, bara Set-WsManQuickConfig -Force i en upphöjd PowerShell-terminal.

Du kan använda konfigurationsdokument (MOF-filer) på en dator med cmdleten Start-DscConfiguration .

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

Hämta konfigurationens aktuella tillstånd

Cmdleten Get-DscConfiguration frågar datorns aktuella status och returnerar de aktuella värdena för konfigurationen.

Get-DscConfiguration

Cmdleten Get-DscLocalConfigurationManager returnerar den aktuella metakonfigurationen som tillämpas på datorn.

Get-DscLocalConfigurationManager

Ta bort den aktuella konfigurationen från en dator

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Konfigurera inställningar i Lokal Configuration Manager

Använd en MOF-fil för metakonfiguration på datorn med hjälp av cmdleten Set-DSCLocalConfigurationManager . Kräver sökvägen till metakonfigurationens MOF.

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

Windows PowerShell Desired State Configuration loggfiler

Loggar för DSC skrivs till Windows-händelseloggen Microsoft-Windows-Dsc/Operational . Du kan aktivera andra loggar för felsökning genom att följa stegen i Where Are DSC Event Logs (Var är DSC-händelseloggar).