Schnellstart: Erstellen einer Website mit Desired State Configuration (DSC)

Artikel
05/05/2023

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

Diese Übung führt Sie von Anfang bis Ende durch das Erstellen und Anwenden einer Desired State Configuration (DSC)-Konfiguration. Das Beispiel, das wir verwenden, stellt sicher, dass ein Server die Web-Server (IIS)-Funktion aktiviert hat und der Inhalt für eine einfache „Hello World“-Website ist im Verzeichnis inetpub\wwwroot des Servers vorhanden ist.

Eine Übersicht über DSC und die Funktionsweise finden Sie unter Desired State Configuration (DSC): Übersicht für Entscheidungsträger.

Anforderungen

Sie benötigen einen Computer mit Windows Server 2012 oder höher und mit PowerShell 4.0 oder höher, um dieses Beispiel auszuführen.

Schreiben und Platzieren der Datei „Index.htm“

Zunächst erstellen wir die HTML-Datei, die wir als Website-Inhalt verwenden werden.

Erstellen Sie in Ihrem Stammordner einen Ordner namens test.

Geben Sie in einem Text-Editor den folgenden Text ein:

<head></head>
<body>
<p>Hello World!</p>
</body>

Speichern Sie dies als index.htm in den Ordner test, den Sie zuvor erstellt haben.

Schreiben der Konfiguration

Eine DSC-Konfiguration ist eine spezielle PowerShell-Funktion, die definiert, wie Sie einen oder mehrere Zielcomputer (Knoten) konfigurieren möchten.

Geben Sie in der PowerShell ISE Folgendes ein:

Configuration WebsiteTest {

    # Import the module that contains the resources we're using.
    Import-DscResource -ModuleName PsDesiredStateConfiguration

    # The Node statement specifies which targets this configuration will be applied to.
    Node 'localhost' {

        # The first resource block ensures that the Web-Server (IIS) feature is enabled.
        WindowsFeature WebServer {
            Ensure = "Present"
            Name   = "Web-Server"
        }

        # The second resource block ensures that the website content copied to the website root folder.
        File WebsiteContent {
            Ensure = 'Present'
            SourcePath = 'c:\test\index.htm'
            DestinationPath = 'c:\inetpub\wwwroot'
        }
    }
}

Speichern Sie die Datei unter dem Namen WebsiteTest.ps1.

Sie sehen, dass sie wie eine PowerShell-Funktion aussieht und zusätzlich das Schlüsselworts Configuration enthält, welches vor dem Namen der Funktion verwendet wurde.

Der Node-Block gibt den zu konfigurierenden Zielknoten an. In diesem Fall localhost.

Die Konfiguration ruft zwei Ressourcen auf, WindowsFeature und File. Ressourcen stellen sicher, dass sich der Zielknoten im durch die Konfiguration definierten Zustand befindet.

Kompilieren der Konfiguration

Damit eine DSC-Konfiguration auf einem Knoten angewendet werden kann, muss sie zunächst in eine MOF-Datei kompiliert werden. Hierzu führen Sie die Konfiguration wie eine Funktion aus. Wechseln Sie in einer PowerShell-Konsole in den gleichen Ordner, in dem Sie die Konfiguration gespeichert haben, und führen Sie die folgenden Befehle aus, um die Konfiguration in eine MOF-Datei zu kompilieren:

. .\WebsiteTest.ps1
WebsiteTest

Die folgende Ausgabe wird generiert:

Directory: C:\ConfigurationTest\WebsiteTest


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        3/13/2017   5:20 PM           2746 localhost.mof

Die erste Zeile macht die Konfigurationsfunktion in der Konsole verfügbar. In der zweiten Zeile wird die Konfiguration ausgeführt. Dies bedeutet, dass ein neuer Ordner mit dem Namen WebsiteTest als Unterordner des aktuellen Ordners erstellt wird. Der Ordner WebsiteTest enthält eine Datei mit dem Namen localhost.mof. Dies ist die Datei, die anschließend auf den Zielknoten angewendet werden kann.

Anwenden der Konfiguration

Nun, da Sie die kompilierte MOF-Dateien haben, können Sie die Konfiguration auf den Zielknoten (in diesem Fall der lokale Computer) anwenden, indem Sie das Cmdlet Start-DscConfiguration aufrufen.

Das Start-DscConfiguration-Cmdlet fordert den lokalen Konfigurations-Manager (Local Configuration Manager – LCM), die DSC-Engine, auf, die Konfiguration anzuwenden. Der LCM übernimmt das Aufrufen der DSC-Ressourcen, um die Konfiguration anzuwenden.

Hinweis

Damit DSC ausgeführt werden kann, muss Windows für den Empfang von PowerShell-Remotebefehlen konfiguriert werden – selbst dann, wenn Sie eine localhost-Konfiguration ausführen. Um Ihre Umgebung auf einfache Weise ordnungsgemäß zu konfigurieren, rufen Sie einfach Set-WsManQuickConfig -Force in einem PowerShell-Terminal mit erhöhten Rechten aus.

Wechseln Sie in einer PowerShell-Konsole in den gleichen Ordner, in dem Sie die Konfiguration gespeichert haben, und führen Sie den folgenden Befehl aus:

Start-DscConfiguration .\WebsiteTest

Testen der Konfiguration

Sie können das Cmdlet Get-DscConfigurationStatus, aufrufen, um zu überprüfen, ob die Konfiguration erfolgreich war.

Sie können die Ergebnisse auch direkt testen, in diesem Fall durch Aufrufen von http://localhost/ in einem Webbrowser. Es sollte die „Hello World“-HTML-Seite angezeigt werden, die Sie im ersten Schritt dieses Beispiels erstellt haben.

Nächste Schritte

Weiteren Informationen zu DSC-Konfigurationen erhalten Sie unter DSC-Konfigurationen.
Welche DSC-Ressourcen verfügbar sind und wie Sie benutzerdefinierte DSC-Ressourcen erstellen erfahren Sie unter DSC-Ressourcen.
DSC-Konfigurationen und -Ressourcen finden Sie unter PowerShell-Katalog.

Freigeben über