Introdução ao Desired State Configuration (DSC) para Windows

  • Artigo

Este artigo explica como começar a utilizar o PowerShell Desired State Configuration (DSC) para Windows. Para obter informações gerais sobre o DSC, consulte Introdução ao Windows PowerShell Desired State Configuration.

Versões suportadas do sistema operativo Windows

Suporta as seguintes versões:

  • Windows Server 2022
  • Windows Server 2019
  • Windows Server 2016
  • Windows 11
  • Windows 10

O produto autónomo Microsoft Hyper-V Server não contém uma implementação de Desired State Configuration pelo que não pode geri-lo com o DSC do PowerShell ou Automatização do Azure State Configuration.

Instalar o DSC

A Desired State Configuration do PowerShell está incluída no Windows e atualizada através de Windows Management Framework. A versão mais recente é Windows Management Framework 5.1.

Nota

Não precisa de ativar a funcionalidade "DSC-Service" do Windows Server para gerir um computador com o DSC. Essa funcionalidade só é necessária ao criar uma instância do Windows Pull Server.

Utilizar o DSC para Windows

As secções seguintes explicam como criar e executar configurações de DSC em computadores Windows.

Criar um documento MOF de configuração

A palavra-chave Windows PowerShell Configuration é utilizada para criar uma configuração. Os passos seguintes descrevem a criação de um documento de configuração com Windows PowerShell.

Instalar um módulo que contém recursos do DSC

Windows PowerShell Desired State Configuration inclui módulos incorporados que contêm recursos de DSC. Também pode carregar módulos de origens externas, como o Galeria do PowerShell, com os cmdlets do PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Defina uma configuração e gere o documento de configuração:

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"

Aplicar a configuração ao computador

Nota

Para permitir a execução do DSC, o Windows tem de ser configurado para receber comandos remotos do PowerShell, mesmo quando está a executar uma localhost configuração. Para configurar o seu ambiente corretamente, apenas Set-WsManQuickConfig -Force num Terminal do PowerShell elevado.

Pode aplicar documentos de Configuração (ficheiros MOF) a um computador com o cmdlet Start-DscConfiguration .

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

Obter o estado atual da configuração

O cmdlet Get-DscConfiguration consulta o estado atual da máquina e devolve os valores atuais da configuração.

Get-DscConfiguration

O cmdlet Get-DscLocalConfigurationManager devolve a metaconfiguração atual aplicada à máquina.

Get-DscLocalConfigurationManager

Remover a configuração atual de um computador

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Configurar definições na Configuration Manager Local

Aplique um ficheiro MOF de Meta Configuration ao computador com o cmdlet Set-DSCLocalConfigurationManager . Requer o caminho para o MOF de Meta Configuração.

Set-DSCLocalConfigurationManager -Path 'c:\metaconfig\localhost.meta.mof' -Verbose

Windows PowerShell Desired State Configuration ficheiros de registo

Os registos do DSC são escritos no Registo de Eventos do Microsoft-Windows-Dsc/Operational Windows. Pode ativar outros registos para fins de depuração ao seguir os passos em Onde estão os Registos de Eventos do DSC.