Freigeben über

Einrichten eines Pullclients mithilfe von Konfigurations-IDs in PowerShell 4.0

Gilt für: Windows PowerShell 4.0, Windows PowerShell 5.0

Von Bedeutung

Der Pullserver (Windows Feature DSC-Service) ist eine unterstützte Komponente von Windows Server, es ist jedoch nicht geplant, neue Features oder Funktionen anzubieten. Wir möchten Sie darauf hinweisen, dass eine neuere Version von DSC jetzt allgemein verfügbar ist und von einem Feature von Azure Policy mit dem Namen guest configuration verwaltet wird. Der Gastkonfigurationsdienst kombiniert Features der DSC-Erweiterung, der Azure Automation State Configuration und der am häufigsten angeforderten Features aus Kundenfeedback. Die Gastkonfiguration umfasst auch die Unterstützung von Hybridmaschinen über Arc-fähige Server.

Bevor Sie einen Pull-Client einrichten, sollten Sie einen Pull-Server einrichten. Obwohl diese Reihenfolge nicht erforderlich ist, hilft sie bei der Problembehandlung und hilft Ihnen sicherzustellen, dass die Registrierung erfolgreich war. Zum Einrichten eines Pullservers können Sie die folgenden Anleitungen verwenden:

Jeder Zielknoten kann so konfiguriert werden, dass er Konfigurationen und Ressourcen herunterlädt und sogar seinen Status meldet. In den folgenden Abschnitten wird gezeigt, wie Sie einen Pullclient mit einer SMB-Freigabe oder einem HTTP DSC-Pullserver konfigurieren. Wenn das LCM des Knotens aktualisiert wird, wird er sich an den konfigurierten Speicherort wenden, um alle zugewiesenen Konfigurationen herunterzuladen. Wenn auf dem Knoten keine erforderlichen Ressourcen vorhanden sind, werden sie automatisch vom konfigurierten Speicherort heruntergeladen. Wenn der Knoten mit einem Berichtsserver konfiguriert ist, meldet er den Status des Vorgangs.

Konfigurieren des Pullclient-LCM

Wenn Sie eines der folgenden Beispiele ausführen, wird ein neuer Ausgabeordner mit dem Namen PullClientConfigID erstellt und dort eine MOF-Metakonfigurationsdatei abgelegt. In diesem Fall erhält die MOF-Metakonfigurationsdatei den Namen localhost.meta.mof.

Rufen Sie zum Anwenden der Konfiguration das Cmdlet Set-DscLocalConfigurationManager auf, und legen Sie den Pfad auf den Speicherort der MOF-Metakonfigurationsdatei fest. Beispiel:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.

Konfigurations-ID

In den folgenden Beispielen wird die ConfigurationID-Eigenschaft des LCM auf eine GUID festgelegt, die zuvor zu diesem Zweck erstellt wurde. Die ConfigurationID ist die Konfiguration, die der LCM verwendet, um die entsprechende Konfiguration auf dem Pullserver zu finden. Die MOF-Konfigurationsdatei auf dem Pullserver muss den Namen ConfigurationID.mofhaben, wobei ConfigurationID der Wert der ConfigurationID-Eigenschaft des LCM des Zielknotens ist. Weitere Informationen finden Sie unter Veröffentlichen von Konfigurationen auf einem Pullserver (v4/v5).

Sie können eine zufällige GUID erstellen, indem Sie das folgende Beispiel verwenden.

[System.Guid]::NewGuid()

Einrichten eines Pull-Clients zum Herunterladen von Konfigurationen

Jeder Client muss im Pull-Modus konfiguriert werden und die Pull-Server-URL erhalten, in der seine Konfiguration gespeichert ist. Dazu müssen Sie den Local Configuration Manager (LCM) mit den notwendigen Informationen konfigurieren. Um das LCM zu konfigurieren, erstellen Sie einen speziellen Konfigurationstyp mit einem LocalConfigurationManager-Block . Weitere Informationen zum Konfigurieren des LCM finden Sie unter Konfigurieren des lokalen Konfigurations-Managers.

HTTP DSC-Pull-Server

Wenn der Pullserver als Webdienst eingerichtet ist, legen Sie DownloadManagerName auf WebDownloadManager fest. Für WebDownloadManager ist es erforderlich, dass Sie eine ServerUrl für den Schlüssel DownloadManagerCustomData angeben. Sie können auch einen Wert für AllowUnsecureConnection angeben, wie im folgenden Beispiel gezeigt. Mit dem folgenden Skript wird das LCM so konfiguriert, dass Konfigurationen von einem Server mit dem Namen "PullServer" abgerufen werden.

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 "."

SMB-Aktie

Wenn der Pullserver als SMB-Dateifreigabe und nicht als Webdienst eingerichtet ist, legen Sie DownloadManagerName auf DscFileDownloadManager und nicht auf WebDownLoadManager fest. Für den DscFileDownloadManager müssen Sie eine SourcePath-Eigenschaft in DownloadManagerCustomData angeben. Mit dem folgenden Skript wird das LCM so konfiguriert, dass Konfigurationen von einer SMB-Freigabe mit dem Namen "SmbDscShare" auf einem Server mit dem Namen "CONTOSO-SERVER" abgerufen werden.

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 "."

Nächste Schritte

Nachdem der Pullclient konfiguriert wurde, können Sie die folgenden Anleitungen verwenden, um die nächsten Schritte auszuführen:

Siehe auch

  • Last updated on