Verpacken und Hochladen von Ressourcen auf einen Pullserver
Die folgenden Abschnitte gehen davon aus, dass Sie bereits einen Pullserver eingerichtet haben. Wenn Sie noch keinen Pullserver eingerichtet haben, können Sie die folgenden Anleitungen verwenden:
Jeder Zielknoten kann zum Herunterladen von Konfigurationen, Ressourcen und sogar zum Berichten seines Status konfiguriert werden. Dieser Artikel zeigt Ihnen, wie Sie Ressourcen hochladen können, damit sie zum Download zur Verfügung stehen, und wie Sie Clients so konfigurieren, dass sie Ressourcen automatisch herunterladen. Wenn der Knoten eine zugewiesene Konfiguration empfängt (durch Pull oder Push (v5)), lädt er automatisch alle für die Konfiguration erforderlichen Ressourcen vom in LCM angegebenen Speicherort herunter.
Verpacken von Ressourcenmodulen
Jede Ressource, die für einen Client zum Herunterladen verfügbar ist, muss in einer .zip
-Datei gespeichert werden. Das folgende Beispiel zeigt die erforderlichen Schritte unter Verwendung der Ressource xPSDesiredStateConfiguration.
Hinweis
Wenn ein Client PowerShell 4.0 verwendet, müssen Sie die Ressourcenordnerstruktur vereinfachen und alle Versionsordner entfernen. Weitere Informationen finden Sie unter Mehrere Ressourcenversionen.
Sie können das Ressourcenverzeichnis mit einem beliebigen Hilfsprogramm, einem Skript oder einer beliebigen Methode komprimieren. Unter Windows können Sie mit der rechten Maustaste auf das Verzeichnis xPSDesiredStateConfiguration
klicken, Senden an auswählen und dann auf Komprimierter Ordner klicken.
Benennen des Ressourcenarchivs
Das Ressourcenarchiv muss im folgenden Format benannt werden:
{ModuleName}_{Version}.zip
Im obigen Beispiel muss xPSDesiredStateConfiguration.zip
in xPSDesiredStateConfiguration_8.4.4.0.zip
umbenannt werden.
Erstellen von Prüfsummen
Sobald das Ressourcenmodul komprimiert und umbenannt wurde, müssen Sie eine Prüfsumme erstellen. Die CheckSum wird von LCM auf dem Client verwendet, um festzustellen, ob die Ressource geändert wurde und erneut heruntergeladen werden muss. Sie können mit dem Cmdlet New-DSCCheckSum eine CheckSum erstellen, wie im folgenden Beispiel gezeigt.
New-DscChecksum -Path .\xPSDesiredStateConfiguration_8.4.4.0.zip
Es wird keine Ausgabe angezeigt, aber Sie sollten nun eine „xPSDesiredStateConfiguration_8.4.4.4.4.0.zip.zip.checksum“ vorfinden. Sie können auch New-DSCCheckSum
für ein Verzeichnis mit Dateien mit dem Parameter -Path
ausführen. Wenn bereits eine Prüfsumme vorhanden ist, können Sie mit dem Parameter -Force
erzwingen, dass sie neu erstellt wird.
Speicherort für Ressourcenarchive
Auf einem DSC-HTTP-Pullserver
Wenn Sie Ihren HTTP-Pullserver einrichten (wie unter Einrichten eines DSC-HTTP-Pullservers beschrieben), geben Sie Verzeichnisse für die Schlüssel ModulePath und ConfigurationPath an. Der Schlüssel ConfigurationPath gibt an, wo MOF-Dateien gespeichert werden sollen. ModulePath gibt an, wo DSC-Ressourcenmodule gespeichert werden sollen.
xDscWebService PSDSCPullServer
{
...
ModulePath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
ConfigurationPath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
...
}
Auf einer SMB-Freigabe
Wenn Sie eine ResourceRepositoryShare angegeben haben, speichern Sie beim Einrichten Ihres Pullclients Archive und Prüfsummen im Verzeichnis SourcePath aus dem Block ResourceRepositoryShare.
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Configurations'
}
ResourceRepositoryShare SMBResourceServer
{
SourcePath = '\\SMBPullServer\Resources'
}
Wenn Sie nur eine ConfigurationRepositoryShare angegeben haben, speichern Sie beim Einrichten Ihres Pullclients Archive und Prüfsummen im Verzeichnis SourcePath aus dem Block ConfigurationRepositoryShare.
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Pull'
}
Aktualisieren von Ressourcen
Sie können einen Knoten zwingen, seine Ressourcen zu aktualisieren, indem Sie die Versionsnummer im Namen des Archivs ändern oder eine neue Prüfsumme erstellen. Der Pullclient sucht nach neueren Versionen der erforderlichen Ressourcen sowie nach aktualisierten Prüfsummen, wenn sein LCM aktualisiert wird.