Introducción a la configuración de estado deseado (DSC) para Windows

En este artículo se explica cómo empezar a usar PowerShell Desired State Configuration (DSC) para Windows. Para obtener información general sobre DSC, consulte Introducción a la configuración de estado deseado de Windows PowerShell.

Versiones de sistema operativo Windows compatibles

Las versiones compatibles son las siguientes:

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

El producto independiente Microsoft Hyper-V Server no contiene una implementación de Desired State Configuration para que no pueda administrarlo mediante DSC o Azure Automation State Configuration de PowerShell.

Instalación de DSC

La configuración de estado deseado de PowerShell se incluye en Windows y se actualiza a través de Windows Management Framework. La versión más reciente es Windows Management Framework 5.1.

Nota

No es necesario habilitar la característica de Windows Server "DSC-Service" para administrar una máquina mediante DSC. Esta característica solo es necesaria al crear una instancia de servidor de extracción de Windows.

Uso de DSC para Windows

En las siguientes secciones se explica cómo crear y ejecutar configuraciones DSC en equipos Windows.

Creación de un documento MOF de configuración

Se utiliza la palabra clave de PowerShell Configuration a fin de crear una configuración. En los pasos siguientes se describe la creación de un documento de configuración con Windows PowerShell.

Instalación de un módulo con recursos de DSC

La configuración de estado deseado de Windows PowerShell incluye módulos integrados con recursos de DSC. También puede cargar módulos desde orígenes externos como la Galería de PowerShell, mediante los cmdlet PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Defina una configuración y genere el documento de configuración:

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"

Aplicación de la configuración a la máquina

Nota

Para permitir la ejecución de DSC, Windows debe configurarse para recibir comandos remotos de PowerShell incluso cuando se ejecuta una configuración localhost. Para configurar el entorno correctamente, solo Set-WsManQuickConfig -Force en un terminal de PowerShell con privilegios elevados.

Puede aplicar documentos de configuración (archivos MOF) a una máquina con el cmdlet Start-DscConfiguration .

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

Obtención del estado actual de la configuración

El cmdlet Get-DscConfiguration consulta el estado actual de la máquina y devuelve los valores actuales de la configuración.

Get-DscConfiguration

El cmdlet Get-DscLocalConfigurationManager devuelve la metaconfiguración actual aplicada a la máquina.

Get-DscLocalConfigurationManager

Eliminación de la configuración actual de una máquina

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Definición de configuración en el Administrador de configuración local

Aplique un archivo MOF de metaconfiguración a la máquina mediante el cmdlet Set-DSCLocalConfigurationManager. Requiere la ruta de acceso al MOF de metaconfiguración.

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

Archivos de registro de configuración de estado deseado de Windows PowerShell

Los registros de DSC se escriben en el Microsoft-Windows-Dsc/Operational registro de eventos de Windows. Para habilitar otros registros con fines de depuración, siga los pasos descritos en Where Are DSC Event Logs (Dónde están los registros de eventos de DSC).