Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

Início Rápido de Configuração de Estado DesejadoDesired State Configuration Quick Start

Este exercício oferece instruções de como criar e aplicar uma configuração para a Configuração Estado Desejado (DSC) do início ao fim.This exercise walks through creating and applying a Desired State Configuration (DSC) configuration from start to finish. O exemplo que usaremos garante que o recurso Web-Server (IIS) do servidor esteja habilitado e que o conteúdo para um site "Hello World" simples esteja presente no diretório do intepub\wwwroot desse servidor.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.

Para obter uma visão geral sobre o que é a DSC e como ela funciona, confira Visão Geral da Configuração do Estado Desejado para Tomadores de Decisão.For an overview of what DSC is and how it works, see Desired State Configuration Overview for Decision Makers.

RequisitosRequirements

Para executar este exemplo, você precisará de um computador com o Windows Server 2012 ou posterior e o PowerShell 4.0 ou posterior.To run this example, you will need a computer running Windows Server 2012 or later and PowerShell 4.0 or later.

Gravar e posicionar o arquivo index.htmWrite and place the index.htm file

Primeiro, vamos criar o arquivo HTML que usaremos como o conteúdo do site.First, we'll create the HTML file that we will use as the website content.

Na pasta-raiz, crie uma pasta chamada test.In your root folder, create a folder named test.

Em um editor de texto, digite o texto a seguir:In a text editor, type the following text:

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

Salve-o como index.htm na pasta test que você criou anteriormente.Save this as index.htm in the test folder you created earlier.

Gravar a configuraçãoWrite the configuration

Uma Configuração DSC é uma função especial do PowerShell que define como você deseja configurar um ou mais computadores de destino (nós).A DSC configuration is a special PowerShell function that defines how you want to configure one or more target computers (nodes).

No ISE do PowerShell, digite o seguinte: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'
        }
    }
}

Salve o arquivo como WebsiteTest.ps1.Save the file as WebsiteTest.ps1.

Você pode ver que ele parece uma função do PowerShell, com a adição da palavra-chave Configuração usada antes do nome da função.You can see that it looks like a PowerShell function, with the addition of the keyword Configuration used before the name of the function.

O bloco especifica o nó de destino a ser configurado, neste caso localhost.The Node block specifies the target node to be configured, in this case localhost.

A configuração chama dois recursos, WindowsFeature e Arquivo.The configuration calls two resources, WindowsFeature and File. Os recursos fazem o trabalho de garantir que o nó de destino está no estado definido pela configuração.Resources do the work of ensuring that the target node is in the state defined by the configuration.

Compilar a configuraçãoCompile the configuration

Para que uma configuração DSC seja aplicada a um nó, ela deve primeiro ser compilada em um arquivo MOF.For a DSC configuration to be applied to a node, it must first be compiled into a MOF file. Para fazer isso, você deve executar a configuração como uma função.To do this, you run the configuration like a function. Em um console do PowerShell, navegue até a mesma pasta em que você salvou sua configuração e execute os seguintes comandos para compilar a configuração em um arquivo MOF: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

Isso gerará os seguintes resultados:This generates the following output:

Directory: C:\ConfigurationTest\WebsiteTest


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

A primeira linha torna a função de configuração disponível no console.The first line makes the configuration function available in the console. A segunda linha executa a configuração.The second line runs the configuration. O resultado é que uma nova pasta, chamada WebsiteTest, é criada como uma subpasta da pasta atual.The result is that a new folder, named WebsiteTest is created as a subfolder of the current folder. A pasta WebsiteTest contém um arquivo chamado localhost.mof.The WebsiteTest folder contains a file named localhost.mof. É o arquivo que pode ser aplicado ao nó de destino.It is this file that can then be applied to the target node.

Aplicar a configuraçãoApply the configuration

Agora que você tem o MOF compilado, é possível aplicar a configuração ao nó de destino (neste caso, o computador local) chamando o cmdlet Start-DscConfiguration.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.

O cmdlet Start-DscConfiguration indica ao Gerenciador de Configurações Local (LCM), qual é o mecanismo de DSC a aplicar à configuração.The Start-DscConfiguration cmdlet tells the Local Configuration Manager (LCM), which is the engine of DSC, to apply the configuration. O LCM realiza o trabalho de chamar os recursos de DSC para aplicar a configuração.The LCM does the work of calling the DSC resources to apply the configuration.

Em um console do PowerShell, navegue até a mesma pasta em que você salvou sua configuração e execute o mesmo comando:In a PowerShell console, navigate to the same folder where you saved your configuration and run the following command:

Start-DscConfiguration .\WebsiteTest

Testar a configuraçãoTest the configuration

Você pode chamar o cmdlet Get-DscConfigurationStatus para ver se a configuração foi bem-sucedida.You can call the Get-DscConfigurationStatus cmdlet to see whether the configuration succeeded.

Você também pode testar os resultados diretamente, neste caso, pesquisando o http://localhost/ em um navegador da Web.You can also test the results directly, in this case by browsing to http://localhost/ in a web browser. Você deve ver a página de HTML "Hello World" que criou como a primeira etapa deste exemplo.You should see the "Hello World" HTML page you created as the first step in this example.

Próximas etapasNext steps