Partager via

Configurer un client Pull à l’aide d’ID de configuration dans PowerShell 4.0

S’applique à : Windows PowerShell 4.0, Windows PowerShell 5.0

Important

Le serveur Pull Server (Windows Feature DSC-Service) est un composant pris en charge de Windows Server, mais il n’est pas prévu d’offrir de nouvelles fonctionnalités ou capacités. nous aimerions que vous sachiez qu’une version plus récente de DSC est désormais généralement disponible, gérée par une fonctionnalité d’Azure Policy nommée configuration invité. Le service de configuration invité combine les fonctionnalités de l’extension DSC, de la configuration d’état d’Azure Automation et des fonctionnalités les plus fréquemment demandées à partir des commentaires des clients. La configuration invité inclut également la prise en charge des machines hybrides via des serveurs compatibles Arc.

Avant de configurer un client collecteur, vous devez configurer un serveur collecteur. Bien que cet ordre ne soit pas obligatoire, il facilite le dépannage et vous aide à vous assurer que l’inscription a réussi. Pour configurer un serveur collecteur, vous pouvez utiliser les guides suivants :

Chaque nœud cible peut être configuré pour télécharger des configurations, des ressources et même signaler son état. Les sections ci-dessous vous montrent comment configurer un client pull avec un partage SMB ou un serveur pull HTTP DSC. Lorsque le LCM du nœud est actualisé, il se connecte à l’emplacement configuré pour télécharger les configurations attribuées. Si les ressources requises n’existent pas sur le nœud, celui-ci les télécharge automatiquement à partir de l’emplacement configuré. Si le nœud est configuré avec un serveur de rapports, il signale l’état de l’opération.

Configurer le LCM du client pull

L’exécution de l’un des exemples ci-dessous crée un nouveau dossier de sortie nommé PullClientConfigID et y place un fichier MOF de métaconfiguration. Dans ce cas, le fichier de métaconfiguration MOF sera nommé localhost.meta.mof.

Pour appliquer la configuration, appelez l’applet de commande Set-DscLocalConfigurationManager , avec le chemin d’accès défini sur l’emplacement du fichier MOF de métaconfiguration. Par exemple:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.

Configuration ID

Les exemples ci-dessous définissent la propriété ConfigurationID du LCM sur un GUID qui avait été précédemment créé à cet effet. Le ConfigurationID est ce que le LCM utilise pour trouver la configuration appropriée sur le serveur collecteur. Le fichier MOF de configuration sur le serveur collecteur doit être nommé ConfigurationID.mof, où ConfigurationID est la valeur de la propriété ConfigurationID du LCM du nœud cible. Pour plus d’informations, consultez Publication de configurations sur un serveur collecteur (v4/v5).

Vous pouvez créer un Guid aléatoire à l’aide de l’exemple ci-dessous.

[System.Guid]::NewGuid()

Configurer un client Pull pour télécharger les configurations

Chaque client doit être configuré en mode Pull et disposer de l’URL du serveur pull où sa configuration est stockée. Pour ce faire, vous devez configurer le gestionnaire de configuration local (LCM) avec les informations nécessaires. Pour configurer le LCM, vous devez créer un type de configuration spécial, avec un bloc LocalConfigurationManager . Pour plus d’informations sur la configuration du LCM, consultez Configuration du gestionnaire de configuration local.

Serveur d’extraction HTTP DSC

Si le serveur collecteur est configuré en tant que service Web, vous définissez DownloadManagerName sur WebDownloadManager. WebDownloadManager nécessite que vous spécifiiez un ServerUrl pour la clé DownloadManagerCustomData. Vous pouvez également spécifier une valeur pour AllowUnsecureConnection, comme dans l’exemple ci-dessous. Le script suivant configure le LCM pour extraire les configurations d’un serveur nommé « PullServer ».

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24"
        RefreshMode = "PULL"
        DownloadManagerName = "WebDownloadManager"
        RebootNodeIfNeeded = $true
        RefreshFrequencyMins = 30
        ConfigurationModeFrequencyMins = 30
        ConfigurationMode = "ApplyAndAutoCorrect"
        DownloadManagerCustomData = @{
            ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"
            AllowUnsecureConnection = "TRUE"
        }
    }
}
PullClientConfigId -Output "."

SMB Partager

Si le serveur collecteur est configuré en tant que partage de fichiers SMB plutôt qu’en tant que service Web, vous définissez DownloadManagerName sur DscFileDownloadManager plutôt que sur WebDownLoadManager. Le DscFileDownloadManager nécessite que vous spécifiiez une propriété SourcePath dans le DownloadManagerCustomData. Le script suivant configure le LCM pour extraire les configurations d’un partage SMB nommé « SmbDscShare » sur un serveur nommé « CONTOSO-SERVER ».

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    }
}
PullClientConfigId -Output "."

Étapes suivantes

Une fois le client d’extraction configuré, vous pouvez utiliser les guides suivants pour effectuer les étapes suivantes :

Voir aussi

  • Last updated on