Introducción a la configuración de estado deseado (DSC) para WindowsGet started with Desired State Configuration (DSC) for Windows

En este tema se ofrece una introducción al uso de la configuración de estado deseado (DSC) de PowerShell para Windows.This topic explains how to get started using PowerShell Desired State Configuration (DSC) for Windows. Para obtener información general sobre DSC, consulte Introducción a la configuración de estado deseado de Windows PowerShell.For general information about DSC, see Get Started with Windows PowerShell Desired State Configuration.

Versiones de sistemas operativos Windows compatiblesSupported Windows operation system versions

Las versiones compatibles son las siguientes:The following versions are supported:

  • Windows Server 2019Windows Server 2019
  • Windows Server 2016Windows Server 2016
  • Windows Server 2012 R2Windows Server 2012R2
  • Windows Server 2012Windows Server 2012
  • Windows Server 2008 R2 SP1Windows Server 2008 R2 SP1
  • Windows 10Windows 10
  • Windows 8.1Windows 8.1
  • Windows 7Windows 7

La referencia de almacén del producto independiente de Microsoft Hyper-V Server no contiene una implementación de la configuración de estado deseado, por lo que ni DSC de PowerShell ni la configuración de estado de Azure Automation pueden administrarla.The Microsoft Hyper-V Server standalone product sku doesn't contain an implementation of Desired State Configuration so it cannot be managed by PowerShell DSC or Azure Automation State Configuration.

Instalación de DSCInstalling DSC

La configuración de estado deseado de PowerShell se incluye en Windows y se actualiza a través de Windows Management Framework.PowerShell Desired State Configuration is included in Windows and updated through Windows Management Framework. La versión más reciente es Windows Management Framework 5.1.The latest version is 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.You do not need to enable the Windows Server feature 'DSC-Service' to manage a machine using DSC. Esta característica solo es necesaria al crear una instancia de servidor de extracción de Windows.That feature is only needed when building a Windows Pull Server instance.

Uso de DSC para WindowsUsing DSC for Windows

En las siguientes secciones se explica cómo crear y ejecutar configuraciones DSC en equipos Windows.The following sections explain how to create and run DSC configurations on Windows computers.

Creación de un documento MOF de configuraciónCreating a configuration MOF document

Se utiliza la palabra clave de PowerShell Configuration a fin de crear una configuración.The Windows PowerShell Configuration keyword is used to create a configuration. En los pasos siguientes se describe la creación de un documento de configuración con Windows PowerShell.The following steps describe the creation of a configuration document using Windows PowerShell.

Defina una configuración y genere el documento de configuración:Define a configuration and generate the configuration document:

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:"C:\EnvironmentVariable_Path"

Instalación de un módulo con recursos de DSCInstall a module containing DSC resources

La configuración de estado deseado de Windows PowerShell incluye módulos integrados con recursos de DSC.Windows PowerShell Desired State Configuration includes built-in modules containing DSC resources. También puede cargar módulos desde orígenes externos como la Galería de PowerShell, mediante los cmdlet PowerShellGet.You can also load modules from external sources such as the PowerShell Gallery, using the PowerShellGet cmdlets.

Install-Module 'PSDscResources' -Verbose

Aplicación de la configuración a la máquinaApply the configuration to the machine

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.To allow DSC to run, Windows needs to be configured to receive PowerShell remote commands even when you're running a localhost configuration. Para configurar correctamente el entorno, solo tiene que ejecutar Set-WsManQuickConfig -Force en un terminal de PowerShell con privilegios elevados.To easily configure your environment correctly, just run Set-WsManQuickConfig -Force in an elevated PowerShell Terminal.

Los documentos de configuración (archivos MOF) se pueden aplicar a la máquina mediante el cmdlet Start-DscConfiguration.Configuration documents (MOF files) can be applied to the machineusing the Start-DscConfiguration cmdlet.

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

Obtención del estado actual de la configuraciónGet the current state of the configuration

El cmdlet Get-DscConfiguration consulta el estado actual de la máquina y devuelve los valores actuales de la configuración.The Get-DscConfiguration cmdlet queries the current status of the machine and returns the current values for the configuration.

Get-DscConfiguration

El cmdlet Get-DscLocalConfigurationManager devuelve la metaconfiguración actual aplicada a la máquina.The Get-DscLocalConfigurationManager cmdlet returns the current meta-configuration applied to the machine.

Get-DscLocalConfigurationManager

Eliminación de la configuración actual de una máquinaRemove the current configuration from a machine

Remove-DscConfigurationDocumentThe Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Definición de configuración en el Administrador de configuración localConfigure settings in Local Configuration Manager

Aplique un archivo MOF de metaconfiguración a la máquina mediante el cmdlet Set-DSCLocalConfigurationManager.Apply a Meta Configuration MOF file to the machine using the Set-DSCLocalConfigurationManager cmdlet. Requiere la ruta de acceso al MOF de metaconfiguración.Requires the path to the Meta Configuration MOF.

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

Archivos de registro de configuración de estado deseado de Windows PowerShellWindows PowerShell Desired State Configuration log files

Los registros para DSC se escriben en el registro de eventos de Windows en la ruta de acceso Microsoft-Windows-Dsc/Operational.Logs for DSC are written to Windows Event Log in the path Microsoft-Windows-Dsc/Operational. Se pueden habilitar registros adicionales con fines de depuración siguiendo los pasos en ¿Dónde se encuentran los registros de eventos de DSC?Additional logs for debugging purposes can be enabled following the steps in Where Are DSC Event Logs.