Erste Schritte mit Azure Automation State Configuration

Hinweis

Azure Automation State Configuration wird am 30. September 2027 eingestellt. Wechseln Sie bis zu diesem Datum zu Azure Machine Configuration. Weitere Informationen finden Sie in der Ankündigung im Blogbeitrag. Der Azure-Computerkonfigurationsdienst kombiniert Features der DSC-Erweiterung und von Azure Automation State Configuration mit den am häufigsten angeforderten Features aus Kundenfeedback. Die Azure-Computerkonfiguration umfasst auch die Unterstützung von Hybridcomputern über Arc-fähige Server.

Achtung

Azure Automation DSC für Linux wurde am 30. September 2023 eingestellt. Weitere Informationen finden Sie in der Ankündigung.

Dieser Artikel enthält eine schrittweise Anleitung zum Ausführen der am häufigsten verwendeten Aufgaben mit der Azure Automation State Configuration, z. B.:

• Erstellen, Importieren und Kompilieren von Konfigurationen
• Aktivieren der Verwaltung von Computern
• viewing reports

Eine Übersicht über State Configuration finden Sie unter Übersicht über Azure Automation State Configuration. Die DSC-Dokumentation (Desired State Configuration, Konfiguration des gewünschten Zustands) finden Sie unter Windows PowerShell DSC – Übersicht.

Wenn Sie eine bereits eingerichtete Beispielumgebung verwenden möchten, ohne die in diesem Artikel beschriebenen Schritte auszuführen, können Sie die Vorlage für verwaltete Azure Automation-Knoten verwenden. Mit dieser Vorlage wird eine vollständige Umgebung für State Configuration (DSC) eingerichtet, einschließlich eines virtuellen Azure-Computers, der von State Configuration (DSC) verwaltet wird.

Voraussetzungen

Um die Beispiele in diesem Artikel ausführen zu können, ist Folgendes erforderlich:

• Ein Azure Automation-Konto. Weitere Informationen zu Automation-Konten und den zugehörigen Anforderungen finden Sie unter Übersicht über die Automation-Kontoauthentifizierung.
• Eine Azure Resource Manager-VM (nicht klassisch), die ein unterstütztes Betriebssystem ausführt. Eine Anleitung zum Erstellen einer VM finden Sie unter Erstellen Ihres ersten virtuellen Windows-Computers im Azure-Portal

Erstellen einer DSC-Konfiguration

Sie erstellen eine einfache DSC-Konfiguration, die abhängig von der Knotenzuweisung entweder das Vorhandensein oder Nichtvorhandensein des Windows- bzw. IIS-Features Web-Server sicherstellt.

Konfigurationsnamen in Azure Automation dürfen nicht mehr als 100 Zeichen lang sein.

1. Starten Sie VS Code (oder einen beliebigen Text-Editor).

2. Geben Sie den folgenden Text ein:

   configuration TestConfig
   {
       Node IsWebServer
       {
           WindowsFeature IIS
           {
               Ensure               = 'Present'
               Name                 = 'Web-Server'
               IncludeAllSubFeature = $true
           }
       }
   
       Node NotWebServer
       {
           WindowsFeature IIS
           {
               Ensure               = 'Absent'
               Name                 = 'Web-Server'
           }
       }
   }
   

3. Speichern Sie die Datei unter dem Namen TestConfig.ps1.

Mit dieser Konfiguration wird eine Ressource in jedem Knotenblock aufgerufen, die WindowsFeature-Ressource. Diese Ressource stellt das Vorhandensein oder das Fehlen der Funktion Webserver sicher.

Importieren einer Konfiguration in Azure Automation

Als Nächstes importieren Sie die Konfiguration in das Automation-Konto.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „Zustandskonfiguration (DSC)“ die Registerkarte Konfigurationen und dann Hinzufügen aus.

5. Wechseln Sie auf der Seite „Konfiguration importieren“ zur Datei TestConfig.ps1 auf Ihrem Computer.

   

6. Wählen Sie OK aus.

Anzeigen einer Konfiguration in Azure Automation

Nachdem Sie eine Konfiguration importieren, können Sie sie im Azure-Portal anzeigen.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „Zustandskonfiguration“ (DSC) die Registerkarte Konfigurationen aus, und wählen Sie dann den Namen der Konfiguration aus, die Sie im vorherigen Verfahren importiert haben, nämlich TestConfig.

5. Wählen Sie auf der Seite „TestConfig-Konfiguration“ Konfigurationsquelle anzeigen aus.

   

   Der Bereich „TestConfig-Konfigurationsquelle“ wird geöffnet, und der PowerShell-Code der Konfiguration wird angezeigt.

Kompilieren einer Konfiguration in Azure Automation

Bevor Sie einen gewünschten Status auf einen Knoten anwenden können, muss eine DSC-Konfiguration, die diesen Status definiert, in eine oder mehrere Knotenkonfigurationen (MOF-Dokumente) kompiliert und auf dem Pullserver von Automation DSC abgelegt werden. Eine ausführlichere Beschreibung der Kompilierung von Konfigurationen in State Configuration finden Sie unter Kompilieren von DSC-Konfigurationen in Azure Automation State Configuration. Weitere Informationen zum Kompilieren von Konfigurationen finden Sie unter DSC-Konfigurationen.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „Zustandskonfiguration“ (DSC) die Registerkarte Konfigurationen aus, und wählen Sie dann den Namen der zuvor importierten Konfiguration aus, nämlich TestConfig.

5. Um den Kompilierungsauftrag zu starten, wählen Sie im Konfigurationsbereich „TestConfig“ Kompilieren aus, und wählen Sie dann Ja aus.

   

Hinweis

Wenn Sie eine Konfiguration in Azure Automation kompilieren, werden automatisch alle erstellten MOF-Dateien mit der Knotenkonfiguration auf dem Pullserver bereitgestellt.

Anzeigen eines Kompilierungsauftrags

Nachdem Sie eine Kompilierung gestartet haben, können Sie sie auf der Seite Konfiguration auf der Kachel Kompilierungsaufträge anzeigen. Die Kachel Kompilierungsaufträge zeigt derzeit ausgeführte, abgeschlossene und fehlerhafte Aufträge. Wenn Sie die Seite eines Kompilierungsauftrags öffnen, werden Informationen zum Auftrag angezeigt, etwa aufgetretene Fehler und Warnungen, in der Konfiguration verwendete Eingabeparameter und Kompilierungsprotokolle.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „Zustandskonfiguration“ (DSC) die Registerkarte Konfigurationen aus, und wählen Sie dann den Namen der zuvor importierten Konfiguration aus, nämlich TestConfig.

5. Wählen Sie unter Kompilierungsaufträge den Kompilierungsauftrag aus, den Sie anzeigen möchten. Ein Bereich vom Typ „Kompilierungsauftrag“ wird geöffnet, die mit dem Startdatum des Kompilierungsauftrags bezeichnet ist.

   

6. Wenn Sie weitere Details zum Auftrag anzeigen möchten, wählen Sie eine beliebige Kachel im Bereich „Kompilierungsauftrag“ aus.

Anzeigen von Knotenkonfigurationen

Bei erfolgreicher Erstellung eines Kompilierungsauftrags werden eine oder mehrere neue Knotenkonfigurationen erzeugt. Eine Knotenkonfiguration ist ein MOF-Dokument, das Sie auf dem Pullserver bereitstellen. Die Knotenkonfigurationen finden Sie in Ihrem Automation-Konto auf der Seite „State Configuration (DSC)“. Die Namen von Knotenkonfigurationen weisen das Format ConfigurationName.NodeName auf.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „State Configuration (DSC)“ auf der Registerkarte Kompilierte Konfigurationen aus.

   

Aktivieren eines virtuellen Azure Resource Manager-Computers für die Verwaltung mit State Configuration

Mit State Configuration können Sie virtuelle Azure-Computer (mit dem klassischen Modell oder dem Resource Manager-Modell), lokale virtuelle Computer, Linux-Computer, virtuelle AWS-Computer und lokale physische Computer verwalten. In diesem Artikel erfahren Sie, wie ausschließlich Azure Resource Manager-VMs aktiviert werden. Informationen zum Aktivieren anderer Computertypen finden Sie unter Aktivieren von Computern zur Verwaltung durch Azure Automation State Configuration.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „State Configuration (DSC)“ die Registerkarte Knoten aus, und wählen Sie dann + Hinzufügen aus.

   

5. Wählen Sie im Bereich „Virtuelle Computer“ Ihren virtuellen Computer aus.

6. Wählen Sie im Detailbereich „Virtueller Computer“ + Verbinden aus.

   Wichtig

   Der virtuelle Computer muss eine Azure Resource Manager-VM sein, auf der ein unterstütztes Betriebssystem ausgeführt wird.

7. Wählen Sie auf der Seite „Registrierung“ im Feld Name der Knotenkonfiguration den Namen der Knotenkonfiguration aus, die Sie auf den virtuellen Computer anwenden möchten. Das Angeben eines Namens an dieser Stelle ist optional. Sie können die zugewiesene Knotenkonfiguration nach dem Aktivieren des Knotens ändern.

8. Aktivieren Sie Starten Sie den Knoten ggf. neu, und wählen Sie dann OK aus.

   

   Die angegebene Knotenkonfiguration wird in den Intervallen auf die VM angewandt, die durch den Wert für Konfigurationsmodushäufigkeit angegeben sind. Der virtuelle Computer sucht in den vom Wert Aktualisierungshäufigkeit angegebenen Intervallen nach Updates für die Knotenkonfiguration. Weitere Informationen zur Verwendung dieser Werte finden Sie unter Konfigurieren des lokalen Konfigurations-Managers.

Azure startet den Prozess der Aktivierung des virtuellen Computers. Wenn es abgeschlossen ist, wird der virtuelle Computer im Automation-Konto auf der Seite „State Configuration (DSC)“ auf der Registerkarte Knoten angezeigt.

Anzeigen der Liste mit verwalteten Knoten

Die Registerkarte Knoten der Seite „Zustandskonfiguration“ (DSC) enthält eine Liste aller Computer, die für die Verwaltung in Ihrem Automation-Konto aktiviert sind.

1. Melden Sie sich beim Azure-Portal an.
2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.
3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.
4. Wählen Sie auf der Seite „State Configuration (DSC)“ die Registerkarte Knoten aus.

DSC-Knotenstatuswerte

Der DSC-Knoten kann einen der folgenden sechs Werte annehmen:

• Fehler: Dieser Status wird angezeigt, wenn beim Anwenden einer oder mehrerer Konfigurationen auf einem Knoten ein Fehler auftritt.
• Nicht kompatibel: Dieser Status wird angezeigt, wenn auf einem Knoten eine Drift auftritt, und eine genaue Überprüfung erforderlich ist.
• Keine Reaktion: Dieser Status wird angezeigt, wenn ein Knoten seit mehr als 24 Stunden nicht eingecheckt wurde.
• Ausstehend: Dieser Status wird angezeigt, wenn auf einem Knoten eine neue Konfiguration angewendet werden muss und der Pullserver auf das Einchecken des Knotens wartet.
• In Bearbeitung: Dieser Status wird angezeigt, wenn ein Knoten die Konfiguration anwendet und der Pullserver auf den Status wartet.
• Kompatibel: Dieser Status wird angezeigt, wenn ein Knoten über eine gültige Konfiguration verfügt und derzeit keine Drift auftritt.

Hinweis

• RefreshFrequencyMins: Dieser Wert definiert die Häufigkeit, mit der sich der Knoten mit dem Agent-Dienst in Verbindung setzt, und kann im Rahmen des Onboardings in DSC bereitgestellt werden. Der Maximalwert beträgt 10080 Minuten.
• Ein Knoten wird mit Keine Reaktion gekennzeichnet, wenn der Knoten den Agent-Dienst 1440 Minuten (1 Tag) lang nicht kontaktiert. Es wird empfohlen, einen RefreshFrequencyMins-Wert < 1440 Minuten zu verwenden. Andernfalls wird der Knoten fälschlich im Zustand Keine Reaktion angezeigt.

Anzeigen von Berichten für verwaltete Knoten

Immer wenn State Configuration eine Konsistenzprüfung auf einem verwalteten Knoten ausführt, sendet der Knoten einen Statusbericht zurück an den Pullserver. Sie können diese Berichte auf der Seite dieses Knotens anzeigen.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „State Configuration (DSC)“ die Registerkarte Knoten aus. Hier ist eine Übersicht über den Konfigurationszustand und die Details für jeden Knoten:

   

5. Wählen Sie auf der Registerkarte Knoten den Knotendatensatz aus, um die Berichte zu öffnen. Wählen Sie den Bericht aus, den Sie anzeigen wollen.

   

Sie können die folgenden Statusinformationen für die entsprechende Konsistenzüberprüfung anzeigen:

• Der Berichtstatus. Mögliche Werte sind:
  • Compliant: Der Knoten ist laut Überprüfung konform.
  • Failed: Die Konfiguration hat die Überprüfung nicht bestanden.
  • Not Compliant: Der Knoten befindet sich im ApplyandMonitor-Modus, und der Computer befindet sich nicht im gewünschten Zustand.
• Startzeit der Konsistenzprüfung.
• Gesamtdauer der Konsistenzprüfung.
• Typ der Konsistenzprüfung.
• Fehler, einschließlich Fehlercode und -meldung.
• Alle in der Konfiguration verwendeten DSC-Ressourcen und der Zustand jeder Ressource (ob der Knoten den gewünschten Status für diese Ressource aufweist). Wählen Sie die einzelnen Ressourcen aus, um ausführlichere Informationen zu erhalten.
• Name, IP-Adresse und Konfigurationsmodus des Knotens.

Sie können auch Unformatierten Bericht anzeigen auswählen, um die tatsächlichen Daten anzuzeigen, die der Knoten an den Server sendet. Weitere Informationen zur Verwendung dieser Daten finden Sie unter Verwenden eines DSC-Berichtsservers.

Nachdem ein Knoten aktiviert wurde, kann es einige Zeit dauern, bis der erste Bericht verfügbar ist. Sie müssen möglicherweise bis zu 30 Minuten auf den ersten Bericht warten, nachdem Sie einen Knoten aktiviert haben.

Neuzuweisen eines Knotens zu einer anderen Knotenkonfiguration

Sie können einen Knoten einer anderen Knotenkonfiguration als der ursprünglich zugewiesenen zuweisen.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie links auf Alle Ressourcen und dann den Namen des Automation-Kontos aus.

3. Wählen Sie auf der Seite „Automation-Konto“ unter Konfigurationsverwaltung die Option State Configuration (DSC) aus.

4. Wählen Sie auf der Seite „State Configuration (DSC)“ die Registerkarte Knoten aus.

5. Wählen Sie auf der Registerkarte Knoten den Namen des Knotens aus, den Sie neu zuweisen möchten.

6. Wählen Sie auf der Seite dieses Knotens Knotenkonfiguration zuweisen aus.

   

7. Wählen Sie auf der Seite „Knotenkonfiguration zuweisen“ die Knotenkonfiguration aus, der Sie den Knoten zuweisen möchten, und wählen Sie dann OK aus.

   

Aufheben der Registrierung eines Knotens

Sie können die Registrierung aufheben, wenn die State Configuration nicht mehr verwaltet werden soll. Siehe Entfernen einer Konfiguration und eines Knotens aus Automation State Configuration.

Nächste Schritte

• Eine Übersicht finden Sie unter Übersicht über Azure Automation State Configuration.
• Informationen zum Aktivieren des Features für virtuelle Computer in Ihrer Umgebung finden Sie unter Aktivieren von Azure Automation State Configuration.
• Eine Einführung in PowerShell DSC finden Sie unter Windows Desired State Configuration – Übersicht.
• Eine Preisübersicht finden Sie unter Automation – Preise.
• Eine Referenz zu den PowerShell-Cmdlets finden Sie unter Az.Automation.