Prendre en main la fonctionnalité DSC (Desired State Configuration) pour Windows

Cet article explique comment commencer à utiliser PowerShell Desired State Configuration (DSC) pour Windows. Pour obtenir des informations générales sur DSC, consultez Prendre en main la fonctionnalité DSC (Desired State Configuration) Windows PowerShell.

Versions du système d’exploitation Windows prises en charge

Les versions suivantes sont prises en charge :

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

Le produit autonome Microsoft Hyper-V Server ne contient pas d’implémentation de Desired State Configuration, vous ne pouvez donc pas la gérer à l’aide de PowerShell DSC ou de Azure Automation State Configuration.

Installation de DSC

La fonctionnalité Desired State Configuration de PowerShell est incluse dans Windows et mise à jour par le biais de Windows Management Framework. La version la plus récente est Windows Management Framework 5.1.

Notes

Vous n’avez pas besoin d’activer la fonctionnalité Windows Server « DSC-Service » pour gérer une machine à l’aide de DSC. Cette fonctionnalité est uniquement nécessaire lors de la création d’une instance de serveur Pull Windows.

Utilisation de DSC pour Windows

Les sections suivantes expliquent comment créer et exécuter des configurations DSC sur les ordinateurs Windows.

Création d’un document MOF de configuration

Le mot clé Windows PowerShell Configuration permet de créer une configuration. Suivez les étapes décrites ci-dessous pour créer un document de configuration à l’aide de Windows PowerShell.

Installer un module contenant des ressources DSC

La fonctionnalité Desired State Configuration de Windows PowerShell inclut des modules intégrés contenant des ressources DSC. Vous pouvez également charger des modules à partir de sources externes, telles que PowerShell Gallery, à l’aide des cmdlets PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Définissez une configuration et créez le document de configuration :

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"

Appliquer la configuration à l’ordinateur

Notes

Pour permettre l’exécution de DSC, Windows doit être configuré pour recevoir des commandes à distance PowerShell, même lorsque vous exécutez une configuration localhost. Pour configurer votre environnement correctement, simplement Set-WsManQuickConfig -Force dans un terminal PowerShell avec élévation de privilèges.

Vous pouvez appliquer des documents de configuration (fichiers MOF) à une machine avec l’applet de commande Start-DscConfiguration .

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

Obtient l’état actuel de la configuration

La cmdlet Get-DscConfiguration interroge l’état actuel de l’ordinateur et retourne les valeurs actuelles de la configuration.

Get-DscConfiguration

La cmdlet Get-DscLocalConfigurationManager retourne la méta-configuration actuelle appliquée à l’ordinateur.

Get-DscLocalConfigurationManager

Supprimer la configuration actuelle d’un ordinateur

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Configurer les paramètres dans le Configuration Manager Manager local

Appliquez un fichier MOF de méta-configuration à l’ordinateur à l’aide de la cmdlet Set-DSCLocalConfigurationManager. Doit spécifier le chemin du fichier MOF de métaconfiguration.

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

Fichiers journaux de la fonctionnalité Desired State Configuration de Windows PowerShell

Les journaux d’activité DSC sont écrits dans le Microsoft-Windows-Dsc/Operational journal des événements Windows. Vous pouvez activer d’autres journaux à des fins de débogage en suivant les étapes décrites dans Où sont les journaux d’événements DSC.