Een configuratie schrijven, compileren en toepassen

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0

In deze oefening wordt van begin tot eind beschreven hoe u een DSC-configuratie (Desired State Configuration) maakt en toepast. In het volgende voorbeeld leert u hoe u een zeer eenvoudige configuratie schrijft en toepast. De configuratie zorgt ervoor dat er een "HelloWorld.txt" -bestand bestaat op uw lokale computer. Als u het bestand verwijdert, wordt het de volgende keer dat het bestand wordt bijgewerkt, opnieuw gemaakt.

Zie Overzicht van de gewenste statusconfiguratie voor ontwikkelaars voor een overzicht van wat DSC is en hoe het werkt.

Requirements

Als u dit voorbeeld wilt uitvoeren, hebt u een computer nodig waarop PowerShell 4.0 of hoger wordt uitgevoerd.

Schrijf de configuratie

Een DSC-configuratie is een speciale PowerShell-functie die definieert hoe u een of meer doelcomputers (knooppunten) wilt configureren.

Typ het volgende in de PowerShell ISE of een andere PowerShell-editor:

Configuration HelloWorld {

    # Import the module that contains the File resource.
    Import-DscResource -ModuleName PsDesiredStateConfiguration

    # The Node statement specifies which targets to compile MOF files for, when
    # this configuration is executed.
    Node 'localhost' {

        # The File resource can ensure the state of files, or copy them from a
        # source to a destination with persistent updates.
        File HelloWorld {
            DestinationPath = "C:\Temp\HelloWorld.txt"
            Ensure = "Present"
            Contents   = "Hello World from DSC!"
        }
    }
}

 Configuration HelloWorld {

  # Import the module that contains the File resource.
  Import-DscResource -ModuleName PsDesiredStateConfiguration
  Import-DscResource -ModuleName xWebAdministration

Sla het bestand op als "HelloWorld.ps1".

Het definiëren van een configuratie is als het definiëren van een functie. Het knooppuntblok specificeert het doelknooppunt dat moet worden geconfigureerd, in dit geval localhost.

De configuratie roept één resource aan, de File resource. Resources zorgen ervoor dat het doelknooppunt zich in de status bevindt die door de configuratie is gedefinieerd.

De configuratie compileren

Om een DSC-configuratie op een knooppunt toe te passen, moet deze eerst worden gecompileerd in een MOF-bestand. Door de configuratie uit te voeren, zoals een functie, wordt één .mof bestand gecompileerd voor elke Node die door het Node blok is gedefinieerd. Om de configuratie uit te voeren, moet u uw HelloWorld.ps1 script in het huidige bereik plaatsen. Zie about_Scripts voor meer informatie.

Dot source uw HelloWorld.ps1 script door te typen in het pad waar u het hebt opgeslagen, na de . (punt, spatie). U kunt dan uw configuratie uitvoeren door deze als een functie aan te roepen. U kunt ook de configuratiefunctie onder aan het script aanroepen, zodat u geen dot-source hoeft te gebruiken.

. C:\Scripts\HelloWorld.ps1
HelloWorld

Hiermee wordt de volgende uitvoer gegenereerd:

Directory: C:\Scripts\HelloWorld


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        3/13/2017   5:20 PM           2746 localhost.mof

De configuratie toepassen

Nu u de gecompileerde MOF hebt, kunt u de configuratie toepassen op het doelknooppunt (in dit geval de lokale computer) door de cmdlet Start-DscConfiguration aan te roepen.

De Start-DscConfiguration cmdlet geeft opdracht aan de Local Configuration Manager (LCM), de engine van DSC, om de configuratie toe te passen. Het LCM doet het werk van het aanroepen van de DSC-bronnen om de configuratie toe te passen.

Gebruik de onderstaande code om de Start-DSCConfiguration cmdlet uit te voeren. Geef het mappad op waar uw localhost.mof is opgeslagen naar de parameter Pad . De Start-DSCConfiguration cmdlet doorzoekt de opgegeven map voor <computername>.mof bestanden. De Start-DSCConfiguration cmdlet probeert elk .mof bestand dat wordt gevonden toe te passen op het computername bestand dat is opgegeven door de bestandsnaam ("localhost", "server01", "dc-02", enz.).

Start-DscConfiguration -Path C:\Scripts\HelloWorld -Verbose -Wait

Test de configuratie

Zodra de Start-DSCConfiguration cmdlet is voltooid, ziet u een HelloWorld.txt bestand op de locatie die u hebt opgegeven. U kunt de inhoud verifiëren met de cmdlet Get-Content .

U kunt de huidige status ook testen met Test-DSCConfiguration.

De uitvoer moet zijn True of het knooppunt momenteel voldoet aan de toegepaste configuratie.

Test-DSCConfiguration

True

Get-Content -Path C:\Temp\HelloWorld.txt

Hello World from DSC!

De configuratie opnieuw toepassen

Als u wilt zien dat uw configuratie opnieuw wordt toegepast, kunt u het tekstbestand verwijderen dat door uw configuratie is gemaakt. Gebruik de Start-DSCConfiguration cmdlet met de -UseExisting parameter. De -UseExisting parameter geeft Start-DSCConfiguration de opdracht om het bestand "current.mof" opnieuw toe te passen, dat de meest recent toegepaste configuratie vertegenwoordigt.

Remove-Item -Path C:\Temp\HelloWorld.txt

Volgende stappen

• Meer informatie over DSC-configuraties vindt u op DSC-configuraties.
• Bekijk welke DSC-bronnen beschikbaar zijn en hoe u aangepaste DSC-bronnen kunt maken bij DSC-bronnen.
• Zoek DSC-configuraties en -resources in de PowerShell-galerie.