Aan de slag met PowerShell Desired State ConfigurationGetting Started with PowerShell Desired State Configuration

Deze handleiding wordt beschreven hoe u begint met het maken van PowerShell Desired State Configuration documenten en toegepast op computers.This guide describes how to begin creating PowerShell Desired State Configuration documents and apply them to machines. Er wordt vanuit gegaan enigszins bekend bent met PowerShell-cmdlets, modules en -functies.It assumes basic familiarity with PowerShell cmdlets, modules, and functions.

Een configuratie makenCreate a Configuration

Configuraties zijn documenten die worden beschreven van een omgeving.Configurations are documents that describe an environment. Omgevingen bestaan uit 'knooppunten', die meestal worden virtuele of fysieke machines.Environments consist of "nodes", which are commonly virtual or physical machines.

Configuraties kunnen worden geleverd in verschillende vormen.Configurations can come in a variety of forms. De eenvoudigste manier om te maken van een nieuwe configuratie is een ps1-bestand (PowerShell-script) te maken.The easiest way to create a new configuration is to create a .ps1 (PowerShell script) file. U doet dit door uw keuze-editor te openen.To do this, open your editor of choice. De PowerShell ISE is een goede keuze, omdat deze DSC systeemeigen begrijpt.The PowerShell ISE is a good choice, since it understands DSC natively. De volgende opslaan als een PS1:Save the following as a PS1:

configuration MyFirstConfiguration
{
    Import-DscResource -Name WindowsFeature

    Node localhost
    {
        WindowsFeature IIS
        {
            Name = "IIS"

        }

    }

}

Onderdelen van een configuratieParts of a Configuration

Configuratie is een sleutelwoord die is toegevoegd aan PowerShell 4.0.Configuration is a keyword that has been added to PowerShell 4.0. Dit geeft aan dat een speciaal type van de PowerShell-functie die wordt gebruikt door Desired State Configuration.It signifies a special kind of PowerShell function used by Desired State Configuration. In dit voorbeeld is de functie myFirstConfiguration naam.In this example, the function is named myFirstConfiguration.

De volgende regel wordt een importinstructie, vergelijkbaar met het importeren van een module.The next line is an import statement, similar to importing a module. Dit zal later worden besproken.It will be discussed later on.

'Knooppunt' definieert de naam van de machine die deze configuratie wordt toegepast."Node" defines the machine name this configuration will act on. Hoewel deze configuratie lokaal bewerkt wordt, kunnen configuraties externe knooppunten bereiken en configureren.Although this configuration is edited locally, configurations can reach out to remote nodes and configure them.

Knooppunten kunnen namen voor machines of IP-adressen zijn.Nodes can be machine names or IP addresses. U kunt meerdere knooppunten in een configuratie voor één document hebben.You can have multiple nodes in a single configuration document. Met behulp van configuratiegegevens, u kunt ook van toepassing op meerdere knooppunten dezelfde configuratie hebben.Using configuration data, you can also have the same configuration apply to multiple nodes. Het knooppunt is in dit geval 'localhost' - wat betekent de lokale computer dat.In this case, the node is "localhost" - which means the local computer.

Het volgende item is een resource.The next item is a resource. Resources zijn de bouwstenen van configuraties.Resources are building blocks of configurations. Elke bron is een module die de logica van de implementatie van een enkele aspect van een machine definieert.Each resource is a module that defines the implementation logic of a single aspect of a machine. U kunt elke resource weergeven op uw computer door te voeren Get-DscResource in PowerShell.You can view every resource on your machine by running Get-DscResource in PowerShell. Resources moet aanwezig zijn op de lokale computer en geïmporteerd voordat ze kunnen worden gebruikt in een configuratie met importeren DscResource die zich op de tweede regel met deze configuratie.Resources must be present on the local machine and imported before they can be used in a configuration with Import-DscResource which is on the second line of this configuration.

Een configuratie vast te stellenEnacting a Configuration

Als het bovenstaande script is opgeslagen en worden uitgevoerd, wordt geen uitvoer geproduceerd.If the script above is saved and run, no output will be produced. Dit is omdat een configuratie alleen een functie is en het bovenstaande script heeft de functie gedefinieerd, maar nog niet uitvoeren.This is because a configuration is just a function, and the script above has defined the function but not yet run it. Nadat de functie is gedefinieerd, moet worden aangeroepen:After the function is defined, it must be invoked:

myFirstConfiguration

Tijdens de uitvoering van functies van de configuratie van de configuratie valideren is geldig.When executed, configuration functions validate the configuration is valid. Er is geen syntaxisfouten, resources moet alle verplichte parameters gedefinieerd en alle resources moeten worden geïmporteerd voordat wordt uitgevoerd.It should have no syntax errors, resources should have all mandatory parameters defined, and all resources should be imported before execution.

Zodra de configuratie wordt uitgevoerd, wordt een map gemaakt met de naam van de configuratie die een . MOF-bestand voor elk knooppunt in de configuratie.Once the configuration is executed, it creates a folder with the name of the configuration containing a .MOF file for every node in the configuration. De. MOF-bestand is een op standaarden gebaseerde management-indeling die wordt gebruikt door PowerShell DSC om te communiceren via het netwerk.The .MOF file is a standards-based management format which is used by PowerShell DSC to communicate over the network.

Op te nemen in de configuratie:To enact the configuration:

Start-DscConfiguration -Path ./myFirstConfiguration

Hiermee maakt u een PowerShell-taak die gezocht naar de knooppunten in de configuratie en configureert u deze.This creates a PowerShell job that reaches out to the nodes in the configuration and configures them. Als de uitvoer van de taak wilt weergeven, gebruikt - wachttijd.To see the output of the job, use -Wait.

Start-DscConfiguration -Path ./myFirstConfiguration -Wait