Configuration du LCM dans PowerShell 4.0

S’applique à : Windows PowerShell 4.0

Pour plus d’informations sur Windows PowerShell 5.0 et versions ultérieures, consultez Configuration du Gestionnaire de configuration local.

Le Gestionnaire de configuration local est le moteur de configuration de l’état souhaité (DSC) de Windows PowerShell. Il s’exécute sur tous les nœuds cibles et est responsable de l’appel des ressources de configuration incluses dans un script de configuration DSC. Cette rubrique répertorie les propriétés du Gestionnaire de configuration local et décrit comment vous pouvez modifier les paramètres du Gestionnaire de configuration local sur un nœud cible.

Propriétés du gestionnaire de configuration local

La liste suivante répertorie les propriétés du Gestionnaire de configuration local que vous pouvez définir ou récupérer.

• AllowModuleOverwrite : contrôle si les nouvelles configurations téléchargées à partir du service de configuration sont autorisées à remplacer les anciennes sur le nœud cible. Les valeurs possibles sont True et False.
• CertificateID : empreinte numérique d’un certificat utilisé pour sécuriser les informations d’identification transmises dans une configuration. Pour plus d’informations, consultez Vous souhaitez sécuriser les informations d’identification dans la configuration de l’état souhaité de Windows PowerShell ?.
• ConfigurationID : indique un GUID utilisé pour obtenir un fichier de configuration particulier à partir d’un service d’extraction. Le GUID garantit que le fichier de configuration correct est accessible.
• ConfigurationMode : spécifie comment le gestionnaire de configuration local applique réellement la configuration aux nœuds cibles. Il peut prendre les valeurs suivantes :
  • ApplyOnly : avec cette option, DSC applique la configuration et ne fait rien d’autre à moins qu’une nouvelle configuration ne soit détectée, soit en envoyant une nouvelle configuration directement au nœud cible, soit si vous vous connectez à un service d’extraction et que DSC découvre une nouvelle configuration lorsqu’il vérifie auprès du service d’extraction. Si la configuration du nœud cible dérive, aucune action n’est entreprise.
  • ApplyAndMonitor : avec cette option (qui est la valeur par défaut), DSC applique toutes les nouvelles configurations, qu’elles soient envoyées par vous directement au nœud cible ou découvertes sur un service d’extraction. Par la suite, si la configuration du nœud cible s’écarte du fichier de configuration, DSC signale l’écart dans les journaux. Pour plus d’informations sur la journalisation DSC, reportez-vous à la section Utilisation des journaux d’événements pour diagnostiquer les erreurs dans la configuration de l’état souhaité.
  • ApplyAndAutoCorrect : avec cette option, DSC applique toutes les nouvelles configurations, qu’elles soient envoyées par vous directement au nœud cible ou découvertes sur un service d’extraction. Par la suite, si la configuration du nœud cible s’écarte du fichier de configuration, DSC signale l’écart dans les journaux, puis tente d’ajuster la configuration du nœud cible pour la mettre en conformité avec le fichier de configuration.
• ConfigurationModeFrequencyMins : Représente la fréquence (en minutes) à laquelle l’application en arrière-plan de DSC tente d’implémenter la configuration actuelle sur le nœud cible. La valeur par défaut est 15. Cette valeur peut être définie conjointement avec RefreshMode. Lorsque RefreshMode est défini sur PULL, le nœud cible contacte le service de configuration à un intervalle défini par RefreshFrequencyMins et télécharge la configuration actuelle. Quelle que soit la valeur RefreshMode, à l’intervalle défini par ConfigurationModeFrequencyMins, le moteur de cohérence applique la dernière configuration téléchargée sur le nœud cible. RefreshFrequencyMins doit être défini sur un multiple entier de ConfigurationModeFrequencyMins.
• Informations d’identification : indique les informations d’identification (comme pour Get-Credential) requises pour accéder aux ressources distantes, par exemple pour contacter le service de configuration.
• DownloadManagerCustomData : Représente un tableau qui contient des données personnalisées spécifiques au gestionnaire de téléchargement.
• DownloadManagerName : Indique le nom du gestionnaire de téléchargement de configuration et de module.
• RebootNodeIfNeeded : définissez cette option $true pour permettre aux ressources de redémarrer le nœud à l’aide de l’indicateur $global:DSCMachineStatus . Sinon, vous devrez redémarrer manuellement le nœud pour toute configuration qui l’exige. La valeur par défaut est $false. Pour utiliser ce paramètre lorsqu’une condition de redémarrage est exécutée par quelque chose d’autre que DSC (tel que Windows Installer), combinez ce paramètre avec le module xPendingReboot .
• RefreshFrequencyMins : utilisé lorsque vous avez configuré un service d’extraction. Représente la fréquence (en minutes) à laquelle le Gestionnaire de configuration local contacte un service d’extraction pour télécharger la configuration actuelle. Cette valeur peut être définie conjointement avec ConfigurationModeFrequencyMins. Lorsque RefreshMode est défini sur PULL, le nœud cible contacte le service d’extraction à un intervalle défini par RefreshFrequencyMins et télécharge la configuration actuelle. À l’intervalle défini par ConfigurationModeFrequencyMins, le moteur de cohérence applique ensuite la dernière configuration téléchargée au nœud cible. Si RefreshFrequencyMins n’est pas défini sur un multiple entier de ConfigurationModeFrequencyMins, le système l’arrondit à la supérieure. La valeur par défaut est 30.
• RefreshMode : les valeurs possibles sont Push (par défaut) et Pull. Dans la configuration « push », vous devez placer un fichier de configuration sur chaque nœud cible, à l’aide de n’importe quel ordinateur client. En mode « pull », vous devez configurer un service d’extraction pour que le Gestionnaire de configuration local puisse contacter et accéder aux fichiers de configuration.

Exemple de mise à jour des paramètres du Gestionnaire de configuration locale

Vous pouvez mettre à jour les paramètres Local Configuration Manager d’un nœud cible en incluant un bloc LocalConfigurationManager à l’intérieur du bloc de nœud dans un script de configuration, comme illustré dans l’exemple suivant.

Configuration ExampleConfig
{
    Node "Server001"
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called
# Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

L’exécution du script dans l’exemple précédent génère un fichier MOF qui spécifie et stocke les paramètres souhaités. Pour appliquer les paramètres, vous pouvez utiliser l’applet de commande Set-DscLocalConfigurationManager , comme illustré dans l’exemple suivant.

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

Pour afficher les paramètres actuels du Gestionnaire de configuration locale, vous pouvez utiliser l’applet de commande Get-DscLocalConfigurationManager . Si vous appelez cette applet de commande sans paramètres, elle obtient par défaut les paramètres du Gestionnaire de configuration local pour le nœud sur lequel vous l’exécutez. Pour spécifier un autre nœud, utilisez le paramètre CimSession avec cette applet de commande.