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 collecteur (fonctionnalité Windows Service DSC) est un composant pris en charge de Windows Server. Toutefois, nous ne prévoyons pas de proposer de nouvelles fonctionnalités. nous aimerions que vous sachiez qu’une version plus récente de DSC est désormais en disponibilité générale, gérée par une fonctionnalité de Azure Policy configuration d’invité nommée. Le service de configuration invité combine les fonctionnalités d’Extension DSC, d’Azure Automation State Configuration, ainsi que les fonctionnalités les plus couramment demandées par les commentaires des clients. La configuration invité comprend également une prise en charge d’ordinateur hybride via des serveurs avec Arc.
Avant de configurer un client Pull, vous devez configurer un serveur Pull. Bien que cet ordre ne soit pas obligatoire, il facilite le dépannage et vous permet de vous assurer que l’inscription a réussi. Pour configurer un 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. Les sections suivantes montrent comment configurer un client Pull avec un partage SMB ou un serveur Pull DSC HTTP. Quand le Gestionnaire de configuration local du nœud est actualisé, il contacte l’emplacement configuré pour télécharger toutes les configurations affectées. Si des ressources requises n’existent pas sur le nœud, il les télécharge automatiquement à partir de l’emplacement configuré. Si le nœud est configuré avec un serveur de rapports, il signale ensuite l’état de l’opération.
Configurer le Gestionnaire de configuration local du client Pull
L’exécution de l’un des exemples ci-dessous crée un dossier de sortie nommé PullClientConfigID et y place un fichier MOF de métaconfiguration. Dans ce cas, le fichier MOF de métaconfiguration est nommé localhost.meta.mof.
Pour appliquer la configuration, appelez l’applet de commande Set-DscLocalConfigurationManager avec le paramètre Path défini sur l’emplacement du fichier MOF de métaconfiguration. Exemple :
Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.
ID de configuration
Les exemples ci-dessous affectent à la propriété ConfigurationID du Gestionnaire de configuration local un GUID précédemment créé à cet effet. Le paramètre ConfigurationID est utilisé par le gestionnaire de configuration local pour rechercher 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 gestionnaire de configuration local du nœud cible. Pour plus d’informations, consultez Publier des configurations vers un serveur Pull (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 des configurations
Chaque client doit être configuré en mode Pull et il faut lui fournir l’URL du serveur Pull où sa configuration est stockée. Pour ce faire, vous devez configurer le gestionnaire de configuration local avec les informations nécessaires. Pour configurer le gestionnaire de configuration local, vous créez un type spécial de configuration, avec un bloc LocalConfigurationManager. Pour plus d’informations sur la configuration du gestionnaire de configuration local, consultez Configuration du gestionnaire de configuration local.
Serveur Pull DSC HTTP
Si le serveur Pull est configuré comme un service web, définissez DownloadManagerName sur WebDownloadManager. WebDownloadManager requiert que vous spécifiiez une propriété 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 gestionnaire de configuration local de façon à extraire des 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 "."
Partage SMB
Si le serveur collecteur est configuré comme un partage de fichiers SMB au lieu d’un service web, vous spécifiez DownloadManagerName sur DscFileDownloadManager au lieu de WebDownLoadManager. DscFileDownloadManager requiert que vous spécifiiez une propriété SourcePath dans DownloadManagerCustomData. Le script suivant configure le gestionnaire de configuration local de façon à extraire 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 Pull configuré, vous pouvez utiliser les guides suivants pour effectuer les étapes suivantes :
- Publier des configurations vers un serveur Pull (v4/v5)
- Empaqueter et charger des ressources dans un serveur Pull (v4)
