Publier sur un serveur Pull à l’aide d’ID de configuration (v4/v5)
Les sections ci-dessous supposent que vous avez déjà configuré un serveur Pull. 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 les configurations et les ressources, et même pour signaler son état. Cet article montre comment charger des ressources afin qu’elles soient disponibles pour être téléchargées, et comment configurer les clients pour télécharger automatiquement des ressources. Lorsque le nœud reçoit une configuration attribuée, via un serveur Pull ou Push (v5), il télécharge automatiquement toutes les ressources requises par la configuration depuis l’emplacement spécifié dans le gestionnaire de configuration local (LCM).
Compiler les configurations
La première étape pour stocker des configurations sur un serveur Pull consiste à les compiler dans des fichiers .mof
. Pour effectuer une configuration générique et applicable à d’autres clients, utilisez localhost
dans votre bloc de nœud. L’exemple ci-dessous montre un interpréteur de commandes de configuration qui utilise localhost
plutôt qu’un nom de client spécifique.
Configuration GenericConfig
{
Node localhost
{
}
}
GenericConfig
Une fois que vous avez compilé votre configuration générique, vous deez disposer d’un fichier localhost.mof
.
Renommer le fichier MOF
Vous pouvez stocker des fichiers de configuration .mof
sur un serveur Pull à l’aide de ConfigurationName ou de ConfigurationID. Selon la façon dont vous souhaitez configurer vos clients Pull, vous pouvez choisir une section ci-dessous afin de renommer correctement vos fichiers .mof
compilés.
ID (GUID) de configuration
Vous devez renommer votre fichier localhost.mof
en fichier <GUID>.mof
. Vous pouvez créer un GUID aléatoire à l’aide de l’exemple ci-dessous, ou en utilisant l’applet de commande New-Guid.
[System.Guid]::NewGuid()
Exemple de sortie
Guid
----
64856475-939e-41fb-aba5-4469f4006059
Vous pouvez ensuite renommer votre fichier .mof
à l’aide de n’importe quelle méthode valide. L’exemple ci-dessous utilise l’applet de commande Rename-Item.
Rename-Item -Path .\localhost.mof -NewName '64856475-939e-41fb-aba5-4469f4006059.mof'
Pour plus d’informations sur l’utilisation des GUID dans votre environnement, consultez Planifier les GUID.
Noms de configuration
Vous devez renommer votre fichier localhost.mof
en fichier <Configuration Name>.mof
. L’exemple suivant utilise le nom de la configuration de la section précédente. Vous pouvez ensuite renommer votre fichier .mof
à l’aide de n’importe quelle méthode valide. L’exemple ci-dessous utilise l’applet de commande Rename-Item.
Rename-Item -Path .\localhost.mof -NewName 'GenericConfig.mof'
Créer la somme de contrôle
Chaque fichier .mof
stocké sur un serveur Pull ou sur un partage SMB doit être associé à un fichier .checksum
.
Ce fichier permet aux clients de savoir quand le fichier .mof
associé a changé et doit être téléchargé à nouveau.
Vous pouvez créer une somme de contrôle à l’aide de l’applet de commande New-DSCCheckSum. Vous pouvez également exécuter New-DSCCheckSum
dans un répertoire de fichiers à l’aide du paramètre -Path
.
Si une somme de contrôle existe déjà, vous pouvez forcer sa recréation avec le paramètre -Force
. L’exemple suivant a spécifié un répertoire contenant le fichier .mof
à partir de la section précédente et utilise le paramètre -Force
.
New-DscChecksum -Path '.\' -Force
Aucune sortie ne s’affiche, mais vous devez maintenant voir un fichier <GUID or Configuration Name>.mof.checksum
.
Emplacement de stockage des fichiers MOF et sommes de contrôle
Sur un serveur Pull HTTP DSC
Lorsque vous configurez votre serveur Pull HTTP, comme expliqué dans la section Configurer un serveur Pull HTTP DSC, vous spécifiez des répertoires pour les clés ModulePath et ConfigurationPath. La clé ModulePath indique l’emplacement de stockage des fichiers .zip
empaquetés d’un module. La clé ConfigurationPath indique l’emplacement où tous les fichiers .mof
et .checksum
doivent être stockés.
xDscWebService PSDSCPullServer
{
...
ModulePath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
ConfigurationPath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
...
}
Sur un partage SMB
Lorsque vous configurez un client Pull pour utiliser un partage SMB, vous spécifiez une clé ConfigurationRepositoryShare.
Tous les fichiers .mof
et .checksum
doivent alors être stockés dans le répertoire SourcePath du bloc ConfigurationRepositoryShare.
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Pull'
}
Étapes suivantes
Vous devez ensuite configurer les clients Pull pour extraire la configuration spécifiée. Pour plus d’informations, consultez l’un des guides suivants :
- Configurer un client Pull à l’aide d’ID de configuration (v4)
- Configurer un client Pull à l’aide d’ID de configuration (v5)
- Configurer un client Pull à l’aide de noms de configuration (v5)