Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

Desired State Configuration snel startenDesired State Configuration Quick Start

In deze oefening helpt bij het maken en toepassen van een configuratie Desired State Configuration (DSC) van begin tot eind.This exercise walks through creating and applying a Desired State Configuration (DSC) configuration from start to finish. In het voorbeeld we gebruiken zorgt ervoor dat een server heeft de Web-Server (IIS)-functie ingeschakeld en de inhoud voor een eenvoudige 'Hallo wereld'-website is aanwezig in de intepub\wwwroot map van die server.The example we'll use ensures that a server has the Web-Server (IIS) feature enabled, and that the content for a simple "Hello World" website is present in the intepub\wwwroot directory of that server.

Zie voor een overzicht van DSC en hoe het werkt Desired Configuration overzicht voor besluitvormers.For an overview of what DSC is and how it works, see Desired State Configuration Overview for Decision Makers.

VereistenRequirements

U voert dit voorbeeld, moet u een computer met WindowsServer 2012 of later en PowerShell 4.0 of hoger.To run this example, you will need a computer running Windows Server 2012 or later and PowerShell 4.0 or later.

Schrijven en plaats het bestand index.htmWrite and place the index.htm file

Eerst maakt de HTML-bestand dat wordt gebruikt als de inhoud van de website.First, we'll create the HTML file that we will use as the website content.

Maak een map met de naam in de hoofdmap, test.In your root folder, create a folder named test.

Typ de volgende tekst in een teksteditor:In a text editor, type the following text:

<head></head>
<body>
<p>Hello World!</p>
</body>

Opslaan als index.htm in de test map die u eerder hebt gemaakt.Save this as index.htm in the test folder you created earlier.

Schrijven van de configuratieWrite the configuration

Een DSC-configuratie is een speciale PowerShell-functie die hoe u aangeeft een of meer doelcomputers (knooppunten) configureren.A DSC configuration is a special PowerShell function that defines how you want to configure one or more target computers (nodes).

In de PowerShell ISE, typ het volgende:In the PowerShell ISE, type the following:

Configuration WebsiteTest {

    # Import the module that contains the resources we're using.
    Import-DscResource -ModuleName PsDesiredStateConfiguration

    # The Node statement specifies which targets this configuration will be applied to.
    Node 'localhost' {

        # The first resource block ensures that the Web-Server (IIS) feature is enabled.
        WindowsFeature WebServer {
            Ensure = "Present"
            Name   = "Web-Server"
        }

        # The second resource block ensures that the website content copied to the website root folder.
        File WebsiteContent {
            Ensure = 'Present'
            SourcePath = 'c:\test\index.htm'
            DestinationPath = 'c:\inetpub\wwwroot'
        }
    }
}

Sla het bestand als WebsiteTest.ps1.Save the file as WebsiteTest.ps1.

U kunt zien dat het lijkt erop dat een functie PowerShell met de toevoeging van het sleutelwoord configuratie gebruikt vóór de naam van de functie.You can see that it looks like a PowerShell function, with the addition of the keyword Configuration used before the name of the function.

De knooppunt blok Hiermee geeft u het doelknooppunt te configureren in dit geval localhost.The Node block specifies the target node to be configured, in this case localhost.

De configuratie van de twee roept resources, WindowsFeature en bestand.The configuration calls two resources, WindowsFeature and File. Resources doen het werk om ervoor te zorgen dat het doelknooppunt de status is gedefinieerd door de configuratie heeft.Resources do the work of ensuring that the target node is in the state defined by the configuration.

De configuratie compilerenCompile the configuration

Voor een DSC-configuratie op een knooppunt moet worden toegepast, moet deze eerst worden gecompileerd naar een MOF-bestand.For a DSC configuration to be applied to a node, it must first be compiled into a MOF file. Om dit te doen, moet u de configuratie zoals een functie uitvoeren.To do this, you run the configuration like a function. Navigeer naar dezelfde map waarin u de configuratie hebt opgeslagen in een PowerShell-console en voer de volgende opdrachten voor het compileren van de configuratie naar een MOF-bestand:In a PowerShell console, navigate to the same folder where you saved your configuration and run the following commands to compile the configuration into a MOF file:

. .\WebsiteTest.ps1
WebsiteTest

Hiermee wordt de volgende uitvoer gegenereerd:This generates the following output:

Directory: C:\ConfigurationTest\WebsiteTest


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

De eerste regel wordt de configuratie-functie beschikbaar in de console.The first line makes the configuration function available in the console. De tweede regel wordt uitgevoerd voor de configuratie.The second line runs the configuration. Het resultaat is dat er een nieuwe map met de naam WebsiteTest gemaakt als een submap van de huidige map.The result is that a new folder, named WebsiteTest is created as a subfolder of the current folder. De WebsiteTest map bevat een bestand met de naam localhost.mof.The WebsiteTest folder contains a file named localhost.mof. Het is dit bestand die vervolgens kan worden toegepast op het doelknooppunt.It is this file that can then be applied to the target node.

De configuratie toepassenApply the configuration

Nu dat u de gecompileerde MOF hebt, kunt u de configuratie toepassen op het doelknooppunt (in dit geval de lokale computer) door het aanroepen van de Start DscConfiguration cmdlet.Now that you have the compiled MOF, you can apply the configuration to the target node (in this case, the local computer) by calling the Start-DscConfiguration cmdlet.

De Start-DscConfiguration cmdlet vertelt de lokale Configuration Manager (LCM), dit is de engine van DSC toepassen van de configuratie.The Start-DscConfiguration cmdlet tells the Local Configuration Manager (LCM), which is the engine of DSC, to apply the configuration. De LCM komt het werk van het aanroepen van de DSC-resources als de configuratie wilt toepassen.The LCM does the work of calling the DSC resources to apply the configuration.

Navigeer naar dezelfde map waarin u de configuratie hebt opgeslagen in een PowerShell-console en voer de volgende opdracht:In a PowerShell console, navigate to the same folder where you saved your configuration and run the following command:

Start-DscConfiguration .\WebsiteTest

Test de configuratieTest the configuration

U kunt aanroepen de Get-DscConfigurationStatus cmdlet om te controleren of de configuratie is voltooid.You can call the Get-DscConfigurationStatus cmdlet to see whether the configuration succeeded.

U kunt ook de resultaten testen rechtstreeks in dit geval door te bladeren naar http://localhost/ in een webbrowser.You can also test the results directly, in this case by browsing to http://localhost/ in a web browser. Als de eerste stap in dit voorbeeld ziet u de 'Hallo wereld' HTML-pagina die u hebt gemaakt.You should see the "Hello World" HTML page you created as the first step in this example.

Volgende stappenNext steps