Aan de slag met Azure Automation State Configuration

  • Artikel

Notitie

Voordat u Automation State Configuration inschakelt, willen we graag weten dat een nieuwere versie van DSC nu algemeen beschikbaar is, beheerd door een functie van Azure Policy met de naam gastconfiguratie. De gastconfiguratieservice combineert functies van DSC-extensie, Azure Automation State Configuration en de meest aangevraagde functies uit feedback van klanten. Gastconfiguratie omvat ook ondersteuning voor hybride machines via servers met Arc.

Dit artikel bevat een stapsgewijze handleiding voor het uitvoeren van de meest voorkomende taken met Azure Automation State Configuration, zoals het maken, importeren en compileren van configuraties, zodat machines rapporten kunnen beheren en weergeven. Zie het overzicht van State Configuration voor een overzicht van State Configuration. Zie het overzicht van Windows PowerShell Desired State Configuration (DSC) voor documentatie over Desired State Configuration (DSC).

Als u een voorbeeldomgeving wilt die al is ingesteld zonder de stappen te volgen die in dit artikel worden beschreven, kunt u de azure Automation Managed Node-sjabloon gebruiken. Met deze sjabloon stelt u een complete DSC-omgeving (State Configuration) in, waaronder een Azure-VM die wordt beheerd door State Configuration (DSC).

Vereisten

Als u de voorbeelden in dit artikel wilt voltooien, moet u het volgende doen:

Een DSC-configuratie maken

U maakt een eenvoudige DSC-configuratie die ervoor zorgt dat de functie Web-Server Windows (IIS) aanwezig of ontbreekt, afhankelijk van de wijze waarop u knooppunten toewijst.

Configuratienamen in Azure Automation mogen maximaal 100 tekens bevatten.

  1. Start VSCode (of een teksteditor).

  2. Typ de volgende tekst:

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

    Node NotWebServer
    {
        WindowsFeature IIS
        {
            Ensure               = 'Absent'
            Name                 = 'Web-Server'
        }
    }
}

  3. Sla het bestand op als TestConfig.ps1.

Deze configuratie roept één resource aan in elk knooppuntblok, de WindowsFeature-resource. Deze resource zorgt voor de aanwezigheid of afwezigheid van de functie Webserver .

Een configuratie importeren in Azure Automation

Vervolgens importeert u de configuratie in het Automation-account.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Selecteer op de pagina Automation-account de optie Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Configuraties en klik vervolgens op Toevoegen.

  5. Blader in het deelvenster Configuratie importeren naar het TestConfig.ps1 bestand op uw computer.

    Screenshot of the Import Configuration blade

  6. Klik op OK.

Een configuratie weergeven in Azure Automation

Nadat u een configuratie hebt geïmporteerd, kunt u deze bekijken in Azure Portal.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Selecteer op de pagina Automation-account de optie Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Configuraties en klik vervolgens op TestConfig. Dit is de naam van de configuratie die u in de vorige procedure hebt geïmporteerd.

  5. Klik in het deelvenster TestConfig-configuratie op Configuratiebron weergeven.

    Screenshot of the TestConfig configuration blade

    Er wordt een bronvenster testconfiguratie geopend met de PowerShell-code voor de configuratie.

Een configuratie compileren in Azure Automation

Voordat u een gewenste status op een knooppunt kunt toepassen, moet een DSC-configuratie die die status definieert, worden gecompileerd in een of meer knooppuntconfiguraties (MOF-document) en op de Automation DSC-pullserver worden geplaatst. Zie Compileerconfiguraties in Azure Automation State Configuration voor een gedetailleerde beschrijving van het compileren van configuraties in State Configuration (DSC). Zie DSC-configuraties voor meer informatie over het compileren van configuraties.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Configuraties en klik vervolgens op TestConfig. Dit is de naam van de eerder geïmporteerde configuratie.

  5. Klik in het deelvenster TestConfig-configuratie op Compileren en klik vervolgens op Ja. Hiermee wordt een compilatietaak gestart.

    Screenshot of the TestConfig configuration page highlighting compile button

Notitie

Wanneer u een configuratie compileert in Azure Automation, worden alle gemaakte MOF-bestanden voor knooppuntconfiguratie automatisch geïmplementeerd op de pull-server.

Een compilatietaak weergeven

Nadat u een compilatie hebt gestart, kunt u deze bekijken in de tegel Compilatietaken op de pagina Configuratie . De tegel Compilatietaken toont momenteel actieve, voltooide en mislukte taken. Wanneer u een deelvenster compilatietaak opent, ziet u informatie over die taak, inclusief eventuele fouten of waarschuwingen die zijn opgetreden, invoerparameters die in de configuratie worden gebruikt en compilatielogboeken.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Configuraties en klik vervolgens op TestConfig. Dit is de naam van de eerder geïmporteerde configuratie.

  5. Selecteer onder Compilatietaken de compilatietaak die u wilt weergeven. Er wordt een deelvenster Compilatietaak geopend, gelabeld met de datum waarop de compilatietaak is gestart.

    Screenshot of the Compilation Job page

  6. Klik op een tegel in het deelvenster Compilatietaak voor meer informatie over de taak.

Knooppuntconfiguraties weergeven

Als een compilatietaak is voltooid, worden een of meer nieuwe knooppuntconfiguraties gemaakt. Een knooppuntconfiguratie is een MOF-document dat is geïmplementeerd op de pull-server en klaar is om te worden opgehaald en toegepast door een of meer knooppunten. U kunt de knooppuntconfiguraties in uw Automation-account bekijken op de pagina State Configuration (DSC). Een knooppuntconfiguratie heeft een naam met het formulier ConfigurationName.NodeName.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Gecompileerde configuraties .

    Screenshot of the Compiled Configurations tab

Een Azure Resource Manager-VM inschakelen voor beheer met State Configuration

U kunt State Configuration gebruiken om virtuele Azure-machines (zowel klassiek als Resource Manager), on-premises VM's, Linux-machines, AWS-VM's en on-premises fysieke machines te beheren. In dit artikel leert u hoe u alleen Azure Resource Manager-VM's inschakelt. Zie Machines inschakelen voor beheer door Azure Automation State Configuration voor meer informatie over het inschakelen van andere typen machines.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Selecteer op de pagina Statusconfiguratie (DSC) het tabblad Knooppunten en klik vervolgens op + Toevoegen.

    Screenshot of the DSC Nodes page highlighting the Add Azure VM button

  5. Selecteer uw virtuele machine in het deelvenster Virtuele machines.

  6. Klik in het detailvenster van de virtuele machine op + Verbinding maken.

    Belangrijk

    De VM moet een Azure Resource Manager-VM zijn waarop een ondersteund besturingssysteem wordt uitgevoerd.

  7. Selecteer op de pagina Registratie de naam van de knooppuntconfiguratie die moet worden toegepast op de VIRTUELE machine in het veld Naam van knooppuntconfiguratie . Het opgeven van een naam op dit moment is optioneel. U kunt de configuratie van het toegewezen knooppunt wijzigen nadat u het knooppunt hebt ingeschakeld.

  8. Controleer indien nodig het knooppunt Opnieuw opstarten en klik vervolgens op OK.

    Screenshot of the Registration blade

    De knooppuntconfiguratie die u hebt opgegeven, wordt toegepast op de VIRTUELE machine met intervallen die zijn opgegeven door de waarde die is opgegeven voor de frequentie van de configuratiemodus. De VM controleert op updates van de knooppuntconfiguratie met intervallen die zijn opgegeven met de waarde Vernieuwingsfrequentie . Zie Local Configuration Manager configureren voor meer informatie over hoe deze waarden worden gebruikt.

Azure start het proces voor het inschakelen van de VIRTUELE machine. Wanneer deze is voltooid, wordt de VM weergegeven op het tabblad Knooppunten van de pagina Statusconfiguratie (DSC) in het Automation-account.

De lijst met beheerde knooppunten weergeven

U kunt de lijst weergeven met alle machines die zijn ingeschakeld voor beheer in uw Automation-account op het tabblad Knooppunten van de pagina Statusconfiguratie (DSC).

  1. Meld u aan bij de Azure-portal.
  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.
  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.
  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Knooppunten .

Statuswaarden van DSC-knooppunten

Het DSC-knooppunt kan een van de volgende zes waarden als volgt aannemen:

  • Mislukt : deze status wordt weergegeven wanneer er een fout optreedt tijdens het toepassen van een of meer configuraties op een knooppunt.
  • Niet compatibel : deze status wordt weergegeven wanneer drift op een knooppunt plaatsvindt en vereist een nauwe beoordeling als deze systematisch is.
  • Reageert niet . Deze status wordt weergegeven wanneer een knooppunt langer dan 24 uur niet is ingecheckt.
  • In behandeling : deze status wordt weergegeven wanneer een knooppunt een nieuwe configuratie heeft die moet worden toegepast en de pull-server wacht op inchecken van knooppunten.
  • Wordt uitgevoerd : deze status wordt weergegeven wanneer een knooppunt configuratie toepast en de pull-server wacht op de status.
  • Compatibel : deze status wordt weergegeven wanneer een knooppunt een geldige configuratie heeft en er momenteel geen drift optreedt.

Notitie

  • RefreshFrequencyMins : hiermee wordt de frequentie gedefinieerd van het knooppunt dat contact maakt met de agentservice en kan worden geleverd als onderdeel van onboarding naar DSC. Het duurt maximaal 10080 minuten.
  • Het knooppunt wordt gemarkeerd als Niet reageren als het knooppunt gedurende 1440 minuten (1 dag) geen contact opneemt met de agentservice. Het is raadzaam om de waarde RefreshFrequencyMins 1440 minuten te gebruiken, anders wordt het knooppunt weergegeven met de status False Unresponsive.<

Rapporten voor beheerde knooppunten weergeven

Telkens wanneer State Configuration een consistentiecontrole uitvoert op een beheerd knooppunt, stuurt het knooppunt een statusrapport terug naar de pull-server. U kunt deze rapporten weergeven op de pagina voor dat knooppunt.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Knooppunten . Hier ziet u het overzicht van de configuratiestatus en de details voor elk knooppunt.

    Screenshot of Node page

  5. Klik op het tabblad Knooppunten op de knooppuntrecord om de rapportage te openen. Klik op het rapport dat u aanvullende rapportagedetails wilt weergeven.

    Screenshot of the Report blade

Op de blade voor een afzonderlijk rapport ziet u de volgende statusinformatie voor de bijbehorende consistentiecontrole:

  • De rapportstatus. Mogelijke waarden zijn:
    • Compatibel: het knooppunt voldoet aan de controle.
    • Mislukt: de configuratie heeft de controle mislukt.
    • Niet compatibel: het knooppunt bevindt zich in ApplyandMonitor de modus en de computer heeft niet de gewenste status.
  • De begintijd voor de consistentiecontrole.
  • De totale runtime voor de consistentiecontrole.
  • Het type consistentiecontrole.
  • Eventuele fouten, inclusief de foutcode en het foutbericht.
  • Eventuele DSC-resources die worden gebruikt in de configuratie en de status van elke resource (of het knooppunt de gewenste status voor die resource heeft). U kunt op elke resource klikken om meer gedetailleerde informatie voor die resource op te halen.
  • De naam, het IP-adres en de configuratiemodus van het knooppunt.

U kunt ook op Onbewerkt rapport weergeven klikken om de werkelijke gegevens te zien die het knooppunt naar de server verzendt. Zie Een DSC-rapportserver gebruiken voor meer informatie over het gebruik van die gegevens.

Het kan enige tijd duren nadat een knooppunt is ingeschakeld voordat het eerste rapport beschikbaar is. Mogelijk moet u maximaal 30 minuten wachten op het eerste rapport nadat u een knooppunt hebt ingeschakeld.

Een knooppunt opnieuw toewijzen aan een andere knooppuntconfiguratie

U kunt een knooppunt toewijzen om een andere knooppuntconfiguratie te gebruiken dan het knooppunt dat u aanvankelijk hebt toegewezen.

  1. Meld u aan bij de Azure-portal.

  2. Klik aan de linkerkant op Alle resources en vervolgens op de naam van uw Automation-account.

  3. Klik op de pagina Automation-account op Statusconfiguratie (DSC) onder Configuratiebeheer.

  4. Klik op de pagina Statusconfiguratie (DSC) op het tabblad Knooppunten .

  5. Klik op het tabblad Knooppunten op de naam van het knooppunt dat u opnieuw wilt toewijzen.

  6. Klik op de pagina voor dat knooppunt op Configuratie van knooppunt toewijzen.

    Screenshot of the Node details page highlighting the Assign node configuration button

  7. Selecteer op de pagina Knooppuntconfiguratie toewijzen de knooppuntconfiguratie waaraan u het knooppunt wilt toewijzen en klik op OK.

    Screenshot of the Assign Node Configuration page

Registratie van een knooppunt ongedaan maken

Als u niet meer wilt dat een knooppunt wordt beheerd door State Configuration, kunt u de registratie ervan ongedaan maken. Zie Hoe u een configuratie en knooppunt verwijdert uit Automation State Configuration.

Volgende stappen