Partager via


Empaquetage et téléchargement de ressources sur un serveur collecteur

Les sections ci-dessous supposent que vous avez déjà configuré un serveur collecteur. Si vous n’avez pas configuré votre serveur Pull, 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. Cet article vous montrera comment charger des ressources afin qu’elles soient disponibles pour être téléchargées, et configurer les clients pour qu’ils téléchargent automatiquement les ressources. Lorsque le nœud reçoit une configuration attribuée, par le biais de Pull ou Push (v5), il télécharge automatiquement toutes les ressources requises par la configuration à partir de l’emplacement spécifié dans le LCM.

Modules de ressources de package

Chaque ressource disponible pour le téléchargement d’un client doit être stockée dans un .zip fichier. L’exemple ci-dessous montre les étapes requises à l’aide de la ressource xPSDesiredStateConfiguration .

Note

Si vous avez des clients qui utilisent PowerShell 4.0, vous devrez aplatir la structure des dossiers de ressources et supprimer tous les dossiers de version. Pour plus d’informations, consultez Versions de plusieurs ressources.

Vous pouvez compresser le répertoire de ressources à l’aide de l’utilitaire, du script ou de la méthode de votre choix. Sous Windows, vous pouvez cliquer avec le bouton droit de la souris sur le xPSDesiredStateConfiguration répertoire et sélectionner Envoyer vers, puis Dossier compressé.

Clic droit - envoyer vers - dossier compressé

Attribution d’un nom à l’archive de ressources

L’archive de ressources doit être nommée au format suivant :

{ModuleName}_{Version}.zip

Dans l’exemple ci-dessus, xPSDesiredStateConfiguration.zip devrait être renommé xPSDesiredStateConfiguration_8.4.4.0.zip.

Création de sommes de contrôle

Une fois que le module Resource a été compressé et renommé, vous devez créer une somme de contrôle. La somme de contrôle est utilisée par le LCM sur le client pour déterminer si la ressource a été modifiée et doit être téléchargée à nouveau. Vous pouvez créer une somme de contrôle avec l’applet de commande New-DSCCheckSum , comme illustré dans l’exemple ci-dessous.

New-DscChecksum -Path .\xPSDesiredStateConfiguration_8.4.4.0.zip

Aucune sortie ne sera affichée, mais vous devriez maintenant voir un "xPSDesiredStateConfiguration_8.4.4.0.zip.checksum « . Vous pouvez également exécuter New-DSCCheckSum sur un répertoire de fichiers à l’aide du -Path paramètre. Si une somme de contrôle existe déjà, vous pouvez forcer sa recréation à l’aide du -Force paramètre.

Où stocker les archives de ressources

Sur un serveur HTTP Pull DSC

Lorsque vous configurez votre serveur HTTP Pull, comme expliqué dans la section Configurer un serveur HTTP Pull DSC, vous spécifiez des répertoires pour les clés ModulePath et ConfigurationPath . La clé ConfigurationPath indique l’emplacement de stockage des fichiers « .mof ». Le ModulePath indique l’emplacement de stockage des modules de ressources DSC.

    xDscWebService PSDSCPullServer
    {
    ...
        ModulePath              = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
        ConfigurationPath       = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
    ...
    }

Sur un partage SMB

Si vous avez spécifié un ResourceRepositoryShare, lors de la configuration de votre client Pull, stockez les archives et les sommes de contrôle dans le répertoire SourcePath à partir du bloc ResourceRepositoryShare .

ConfigurationRepositoryShare SMBPullServer
{
    SourcePath = '\\SMBPullServer\Configurations'
}

ResourceRepositoryShare SMBResourceServer
{
    SourcePath = '\\SMBPullServer\Resources'
}

Si vous n’avez spécifié qu’un ConfigurationRepositoryShare, lors de la configuration de votre client Pull, stockez les archives et les sommes de contrôle dans le répertoire SourcePath à partir du bloc ConfigurationRepositoryShare .

ConfigurationRepositoryShare SMBPullServer
{
    SourcePath = '\\SMBPullServer\Pull'
}

Mise à jour des ressources

Vous pouvez forcer un nœud à mettre à jour ses ressources en modifiant le numéro de version dans le nom de l’archive ou en créant une nouvelle somme de contrôle. Le client Pull recherche les versions plus récentes des ressources requises, ainsi que les sommes de contrôle mises à jour, lorsque son LCM est actualisé.

Voir aussi