Configurer un client Pull à l’aide des noms de configuration dans PowerShell 5.0 et versions ultérieures

S’applique à : Windows PowerShell 5.0

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 :

• Configuration d’un serveur collecteur DSC SMB
• Configurer un serveur HTTP Pull Server DSC

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é PullClientConfigName 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 .\PullClientConfigName –Verbose.

Nom de la configuration

Les exemples ci-dessous définissent la propriété ConfigurationName du LCM sur le nom d’une configuration précédemment compilée, créée à cet effet. Le ConfigurationName 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é <ConfigurationName>.mof, dans ce cas, « ClientConfig.mof ». Pour plus d’informations, consultez Publication de configurations sur un serveur collecteur (v4/v5).

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, décoré avec l’attribut DSCLocalConfigurationManager . Pour plus d’informations sur la configuration du LCM, consultez Configuration du gestionnaire de configuration local.

Le script suivant configure le LCM pour extraire les configurations d’un serveur nommé « CONTOSO-PullSrv ».

• Dans le script, le bloc ConfigurationRepositoryWeb définit le serveur collecteur. La propriété ServerURL spécifie le point de terminaison du serveur collecteur.

• La propriété RegistrationKey est une clé partagée entre tous les nœuds clients d’un serveur collecteur et de ce serveur collecteur. La même valeur est stockée dans un fichier sur le serveur collecteur.

  Remarque

  Les clés d’inscription ne fonctionnent qu’avec les serveurs Web Extract. Vous devez toujours utiliser ConfigurationID avec un serveur collecteur SMB . > Pour plus d’informations sur la configuration d’un serveur collecteur à l’aide de ConfigurationID, consultez Configuration d’un client collecteur à l’aide de l’ID de configuration

• La propriété ConfigurationNames est un tableau qui spécifie les noms des configurations destinées au nœud client. > Note: Si vous spécifiez plusieurs valeurs dans les ConfigurationNames, vous devez également spécifier des blocs PartialConfiguration dans votre configuration. >Pour plus d’informations sur les configurations partielles, consultez Configurations partielles de la configuration de l’état souhaité PowerShell.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }
        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '140a952b-b9d6-406b-b416-e0f759c9c0e4'
            ConfigurationNames = @('ClientConfig')
        }
    }
}
PullClientConfigNames

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

Si vous spécifiez uniquement un bloc ConfigurationRepositoryWeb ou ConfigurationRepositoryShare dans votre configuration LCM (comme dans l’exemple précédent), le client pull extraira les ressources à partir du même emplacement que celui où vos fichiers « .mof » sont stockés. Vous pouvez également spécifier différents emplacements où les clients peuvent télécharger des ressources. Pour spécifier un serveur de ressources, vous devez utiliser un bloc ResourceRepositoryWeb (pour un serveur collecteur Web) ou un bloc ResourceRepositoryShare (pour un serveur collecteur SMB).

L’exemple suivant montre une métaconfiguration qui configure un client pour télécharger les configurations d’un serveur Pull Server et les ressources d’un partage SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ResourceRepositoryShare SMBResources
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigNames

Configurer un client Pull pour signaler l’état

Vous pouvez utiliser un seul serveur collecteur pour les configurations, les ressources et la création de rapports. Par défaut, les rapports ne sont pas configurés pour les clients. Pour configurer un client afin qu’il signale l’état, vous devez créer un bloc ReportRepositoryWeb . L’exemple suivant montre une métaconfiguration qui configure un client pour extraire les configurations et les ressources, et envoyer les données de rapport, à un seul serveur collecteur.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }
    }
}
PullClientConfigNames

Voir aussi

• Configuration d’un client collecteur avec l’ID de configuration
• Configuration d’un serveur Web Pull Server DSC