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

  • Artikel
  • 2 minuter för att läsa

Det här avsnittet 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 Windows operativsystem som stöds

Följande versioner stöds:

  • 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

SKU:n Microsoft Hyper-V Server fristående produkt innehåller inte någon implementering av Desired State Configuration så den kan inte hanteras 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 funktionen DSC-Windows Server för att hantera en dator med DSC. Den här funktionen behövs bara när du skapar en Windows pull-serverinstans.

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 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-cmdlets.

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 Windows konfigureras för att ta emot PowerShell-fjärrkommandon även när du kör en localhost konfiguration. För att enkelt konfigurera din miljö korrekt kör du bara Set-WsManQuickConfig -Force i en upphöjd PowerShell-terminal.

Konfigurationsdokument (MOF-filer) kan tillämpas på datorn med hjälp av cmdleten Start-DscConfiguration.

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

Hämta konfigurationens aktuella tillstånd

Cmdleten Get-DscConfiguration frågar efter 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 Konfigurationshanteraren

Tillämpa en MOF-fil för metakonfiguration på datorn med hjälp av cmdleten Set-DSCLocalConfigurationManager. Kräver sökvägen till Meta Configuration 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 i sökvägen Microsoft-Windows-Dsc/Operational . Ytterligare loggar för felsökning kan aktiveras genom att följa stegen i Where Are DSC Event Logs.