Share via

Problemen met Azure Automation State Configuration oplossen

  • Artikel

Dit artikel bevat informatie over het oplossen en oplossen van problemen die zich voordoen tijdens het compileren of implementeren van configuraties in Azure Automation State Configuration. Zie het overzicht van Azure Automation State Configuration voor algemene informatie over de functie State Configuration.

Een probleem vaststellen

Wanneer u een compilatie- of implementatiefout voor de configuratie ontvangt, volgt u een paar stappen om u te helpen bij het vaststellen van het probleem.

1. Zorg ervoor dat uw configuratie is gecompileerd op de lokale computer

Azure Automation State Configuration is gebouwd op PowerShell Desired State Configuration (DSC). U vindt de documentatie voor de DSC-taal en syntaxis in de PowerShell DSC-documenten.

Door een DSC-configuratie op uw lokale computer te compileren, kunt u veelvoorkomende fouten detecteren en oplossen, zoals:

  • Ontbrekende modules.
  • Syntaxisfouten.
  • Logische fouten.

2. DSC-logboeken op uw knooppunt weergeven

Als uw configuratie is gecompileerd, maar mislukt wanneer deze wordt toegepast op een knooppunt, vindt u gedetailleerde informatie in de DSC-logboeken. Zie Waar vindt u de DSC-gebeurtenislogboeken voor informatie over waar u deze logboeken kunt vinden.

De module xDscDiagnostics kan u helpen bij het parseren van gedetailleerde informatie uit de DSC-logboeken. Als u contact op neemt met ondersteuning, moeten deze logboeken uw probleem vaststellen.

U kunt de xDscDiagnostics module installeren op uw lokale computer door de instructies te volgen in De stabiele versiemodule installeren.

Gebruik Invoke-AzVMRunCommand om de xDscDiagnostics module op uw Azure-machine te installeren. U kunt ook de optie Opdracht uitvoeren in Azure Portal gebruiken door de stappen uit te voeren in PowerShell-scripts uitvoeren op uw Windows-VM met de opdracht Uitvoeren.

Zie XDscDiagnostics gebruiken om DSC-logboeken te analyseren voor meer informatie over het gebruik van xDscDiagnostics. Zie ook xDscDiagnostics-cmdlets.

3. Zorg ervoor dat knooppunten en de Automation-werkruimte vereiste modules hebben

DSC is afhankelijk van modules die op het knooppunt zijn geïnstalleerd. Wanneer u Azure Automation State Configuration gebruikt, importeert u de vereiste modules in uw Automation-account door de stappen in Modules importeren te volgen. Configuraties kunnen ook afhankelijk zijn van specifieke versies van modules. Zie Problemen met modules oplossen voor meer informatie.

Scenario: Een configuratie met speciale tekens kan niet worden verwijderd uit de portal

Probleem

Wanneer u probeert een DSC-configuratie te verwijderen uit de portal, ziet u de volgende fout:

An error occurred while deleting the DSC configuration '<name>'.  Error-details: The argument configurationName with the value <name> is not valid.  Valid configuration names can contain only letters,  numbers, and underscores.  The name must start with a letter.  The length of the name must be between 1 and 64 characters.

Oorzaak

Deze fout is een tijdelijk probleem dat is gepland om te worden opgelost.

Oplossing

Gebruik de cmdlet Remove-AzAutomationDscConfiguration om de configuratie te verwijderen.

Scenario: Kan de DSC-agent niet registreren

Probleem

Wanneer Set-DscLocalConfigurationManager of een andere DSC-cmdlet wordt weergegeven, wordt de volgende fout weergegeven:

Registration of the Dsc Agent with the server
https://<location>-agentservice-prod-1.azure-automation.net/accounts/00000000-0000-0000-0000-000000000000 failed. The
underlying error is: Failed to register Dsc Agent with AgentId 00000000-0000-0000-0000-000000000000 with the server htt
ps://<location>-agentservice-prod-1.azure-automation.net/accounts/00000000-0000-0000-0000-000000000000/Nodes(AgentId='00000000-0000-0000-0000-000000000000'). .
    + CategoryInfo          : InvalidResult: (root/Microsoft/...gurationManager:String) [], CimException
    + FullyQualifiedErrorId : RegisterDscAgentCommandFailed,Microsoft.PowerShell.DesiredStateConfiguration.Commands.Re
   gisterDscAgentCommand
    + PSComputerName        : <computerName>

Oorzaak

Deze fout wordt normaal gesproken veroorzaakt door een firewall, de computer achter een proxyserver of andere netwerkfouten.

Oplossing

Controleer of uw computer toegang heeft tot de juiste eindpunten voor DSC en probeer het opnieuw. Zie Netwerkplanning voor een lijst met benodigde poorten en adressen.

Scenario: Statusrapporten retourneren de antwoordcode niet geautoriseerd

Probleem

Wanneer u een knooppunt registreert bij Azure Automation State Configuration, ontvangt u een van de volgende foutberichten:

The attempt to send status report to the server https://{your Automation account URL}/accounts/xxxxxxxxxxxxxxxxxxxxxx/Nodes(AgentId='xxxxxxxxxxxxxxxxxxxxxxxxx')/SendReport returned unexpected response code Unauthorized.

VM has reported a failure when processing extension 'Microsoft.Powershell.DSC / Registration of the Dsc Agent with the server failed.

Oorzaak

Hier volgen de mogelijke oorzaken:

  • Een ongeldig of verlopen certificaat. Zie Een knooppunt opnieuw registreren.

  • Een proxyconfiguratie die geen toegang tot *.azure-automation.net toestaat. Zie Configuratie van privénetwerken voor meer informatie.

  • Wanneer u lokale verificatie uitschakelt in Azure Automation. Zie Lokale verificatie uitschakelen. Zie Lokale verificatie opnieuw inschakelen om dit probleem op te lossen.

  • De tijd van de clientcomputer is veel minuten onnauwkeurig ten tijde van de werkelijke tijd. (Om het tijdgebruik te controleren: w32tm /stripchart /computer:time.windows.com /samples:6).

Oplossing

Gebruik de volgende stappen om het mislukte DSC-knooppunt opnieuw te registreren.

Stap 1: De registratie van het knooppunt ongedaan maken

  1. Ga in De Azure-portal naar Home>Automation-accounts> (uw Automation-account) >Statusconfiguratie (DSC) .
  2. Selecteer Knooppunten en selecteer het knooppunt met problemen.
  3. Selecteer Registratie opheffen om de registratie van het knooppunt ongedaan te maken.

Stap 2: verwijder de DSC-extensie van het knooppunt

  1. Ga in De Azure-portal naar extensies voor virtuele>> thuiscomputers (mislukte knooppunten). >
  2. Selecteer Microsoft.Powershell.DSC, de PowerShell DSC-extensie.
  3. Selecteer Verwijderen om de extensie te verwijderen.

Stap 3: verwijder alle ongeldige of verlopen certificaten van het knooppunt

Voer op het mislukte knooppunt vanuit een PowerShell-prompt met verhoogde bevoegdheid de volgende opdrachten uit:

$certs = @()
$certs += dir cert:\localmachine\my | ?{$_.FriendlyName -like "DSC"}
$certs += dir cert:\localmachine\my | ?{$_.FriendlyName -like "DSC-OaaS Client Authentication"}
$certs += dir cert:\localmachine\CA | ?{$_.subject -like "CN=AzureDSCExtension*"}
"";"== DSC Certificates found: " + $certs.Count
$certs | FL ThumbPrint,FriendlyName,Subject
If (($certs.Count) -gt 0)
{
    ForEach ($Cert in $certs)
    {
        RD -LiteralPath ($Cert.Pspath)
    }
}

Stap 4: Het mislukte knooppunt opnieuw registreren

  1. Ga in De Azure-portal naar Home>Automation-accounts> (uw Automation-account) >Statusconfiguratie (DSC) .
  2. Selecteer Knooppunten.
  3. Selecteer Toevoegen.
  4. Selecteer het mislukte knooppunt.
  5. Selecteer Verbinding maken en selecteer de gewenste opties.

Scenario: Knooppunt heeft de status Mislukt met de fout 'Niet gevonden'

Probleem

Het knooppunt heeft een rapport met de status Mislukt en bevat de volgende fout:

The attempt to get the action from server https://<url>//accounts/<account-id>/Nodes(AgentId=<agent-id>)/GetDscAction failed because a valid configuration <guid> cannot be found.

Oorzaak

Deze fout treedt meestal op wanneer het knooppunt is toegewezen aan een configuratienaam, bijvoorbeeld ABC, in plaats van een MOF-naam (Node Configuration), bijvoorbeeld ABC. WebServer.

Oplossing

  • Zorg ervoor dat u het knooppunt toewijst met de naam van de knooppuntconfiguratie en niet de configuratienaam.

  • U kunt een knooppuntconfiguratie toewijzen aan een knooppunt met behulp van Azure Portal of met een PowerShell-cmdlet.

    • Ga in De Azure-portal naar Home>Automation-accounts> (uw Automation-account) >Statusconfiguratie (DSC) . Selecteer vervolgens een knooppunt en selecteer Knooppuntconfiguratie toewijzen.
    • Gebruik de cmdlet Set-AzAutomationDscNode .

Scenario: Er zijn geen knooppuntconfiguraties (MOF-bestanden) geproduceerd toen een configuratie werd gecompileerd

Probleem

Uw DSC-compilatietaak wordt onderbroken met de fout:

Compilation completed successfully, but no node configuration **.mof** files were generated.

Oorzaak

Wanneer de expressie na het Node trefwoord in de DSC-configuratie wordt geëvalueerd $null, worden er geen knooppuntconfiguraties geproduceerd.

Oplossing

Gebruik een van de volgende oplossingen om het probleem op te lossen:

  • Zorg ervoor dat de expressie naast het Node trefwoord in de configuratiedefinitie niet wordt geëvalueerd op Null.
  • Als u ConfigurationData doorgeeft wanneer u de configuratie compileert, moet u ervoor zorgen dat u de waarden doorgeeft die de configuratie verwacht van de configuratiegegevens.

Scenario: Het DSC-knooppuntrapport blijft hangen in de status Wordt uitgevoerd

Probleem

De DSC-agent voert het volgende uit:

No instance found with given property values

Oorzaak

U hebt de WMF-versie (Windows Management Framework) bijgewerkt en windows Management Instrumentation (WMI) beschadigd.

Oplossing

Volg de instructies in DSC bekende problemen en beperkingen.

Scenario: Kan geen referentie gebruiken in een DSC-configuratie

Probleem

Uw DSC-compilatietaak is onderbroken met de fout:

System.InvalidOperationException error processing property 'Credential' of type <some resource name>: Converting and storing an encrypted password as plaintext is allowed only if PSDscAllowPlainTextPassword is set to true.

Oorzaak

U hebt een referentie in een configuratie gebruikt, maar u hebt niet de juiste ConfigurationData gegevens opgegeven om in te stellen PSDscAllowPlainTextPassword op waar voor elke knooppuntconfiguratie.

Oplossing

Zorg ervoor dat u het juiste ConfigurationData doorgeeft om in te stellen PSDscAllowPlainTextPassword op true voor elke knooppuntconfiguratie die wordt vermeld in de configuratie. Zie DSC-configuraties compileren in Azure Automation State Configuration.

Scenario: Fout bij foutverwerkingsextensie bij het inschakelen van een machine vanuit een DSC-extensie

Probleem

Wanneer u een machine inschakelt met behulp van een DSC-extensie, treedt er een fout op die de fout bevat:

VM has reported a failure when processing extension 'Microsoft.Powershell.DSC'. Error message: \"DSC COnfiguration 'RegistrationMetaConfigV2' completed with error(s). Following are the first few: Registration of the Dsc Agent with the server <url> failed. The underlying error is: The attempt to register Dsc Agent with Agent Id <ID> with the server <url> return unexpected response code BadRequest. .\".

Oorzaak

Deze fout treedt meestal op wanneer aan het knooppunt een configuratienaam voor het knooppunt wordt toegewezen die niet in de service bestaat.

Oplossing

  • Zorg ervoor dat u het knooppunt toewijst met een naam die exact overeenkomt met de naam in de service.
  • U kunt ervoor kiezen om de naam van de knooppuntconfiguratie niet op te nemen, wat resulteert in het inschakelen van het knooppunt, maar niet het toewijzen van een knooppuntconfiguratie.

Scenario: Fout 'Er zijn een of meer fouten opgetreden' bij het registreren van een knooppunt met behulp van PowerShell

Probleem

Wanneer u een knooppunt registreert met register-AzAutomationDSCNode of Register-AzureRMAutomationDSCNode, ontvangt u de volgende fout:

One or more errors occurred.

Oorzaak

Deze fout treedt op wanneer u probeert een knooppunt te registreren in een afzonderlijk abonnement dat wordt gebruikt door het Automation-account.

Oplossing

Behandel het knooppunt voor meerdere abonnementen alsof het is gedefinieerd voor een afzonderlijke cloud of on-premises. Registreer het knooppunt met behulp van een van deze opties voor het inschakelen van machines:

Scenario: foutbericht 'Inrichten is mislukt'

Probleem

Wanneer u een knooppunt registreert, ziet u de volgende fout:

Provisioning has failed

Oorzaak

Dit bericht treedt op wanneer er een probleem is met de connectiviteit tussen het knooppunt en Azure.

Oplossing

Bepaal of uw knooppunt zich in een virtueel particulier netwerk (VPN) bevindt of andere problemen ondervindt bij het maken van verbinding met Azure. Zie Problemen met de implementatie van functies oplossen.

Scenario: Fout met een algemene fout bij het toepassen van een configuratie in Linux

Probleem

Wanneer u een configuratie toepast in Linux, treedt er een fout op die de fout bevat:

This event indicates that failure happens when LCM is processing the configuration. ErrorId is 1. ErrorDetail is The SendConfigurationApply function did not succeed.. ResourceId is [resource]name and SourceInfo is ::nnn::n::resource. ErrorMessage is A general error occurred, not covered by a more specific error code..

Oorzaak

Als de /tmp-locatie is ingesteld op noexec, kan de huidige versie van DSC geen configuraties toepassen.

Oplossing

Verwijder de noexec optie van de /tmp-locatie .

Scenario: Knooppuntconfiguratienamen die elkaar overlappen, kunnen leiden tot een ongeldige release

Probleem

Wanneer u één configuratiescript gebruikt om meerdere knooppuntconfiguraties te genereren en sommige knooppuntconfiguratienamen subsets van andere namen zijn, kan de compilatieservice uiteindelijk de verkeerde configuratie toewijzen. Dit probleem treedt alleen op wanneer u één script gebruikt om configuraties met configuratiegegevens per knooppunt te genereren en alleen wanneer de naam overlapt aan het begin van de tekenreeks. Een voorbeeld is één configuratiescript dat wordt gebruikt voor het genereren van configuraties op basis van knooppuntgegevens die zijn doorgegeven als een hashtabel met behulp van cmdlets, en de knooppuntgegevens servers met de naam server en 1server bevatten.

Oorzaak

Dit is een bekend probleem met de compilatieservice.

Oplossing

De beste tijdelijke oplossing is om lokaal of in een CI/CD-pijplijn te compileren en de MOF-knooppuntconfiguratiebestanden rechtstreeks naar de service te uploaden. Als compilatie in de service een vereiste is, is de volgende beste oplossing om de compilatietaken te splitsen, zodat er geen overlapping in namen is.

Scenario: Time-outfout voor gateway bij het uploaden van DSC-configuratie

Probleem

Er wordt een GatewayTimeout foutbericht weergegeven wanneer u een DSC-configuratie uploadt.

Oorzaak

DSC-configuraties die lang duren om te compileren, kunnen deze fout veroorzaken.

Oplossing

U kunt uw DSC-configuraties sneller parseren door expliciet de ModuleName parameter op te slaan voor import-DSCResource-aanroepen .

Scenario: Fout tijdens onboarding van een machine

Probleem

Er wordt een agent has a problem foutbericht weergegeven wanneer u een machine onboardt.

Oorzaak

Dit is een bekend probleem. U kunt dezelfde configuratie niet opnieuw toewijzen als het knooppunt de status In behandeling heeft.

Oplossing

Het werk is om verschillende testconfiguraties toe te passen en de oorspronkelijke configuratie opnieuw toe te passen.

Volgende stappen

Als u het probleem hier niet ziet of als u het probleem niet kunt oplossen, kunt u een van de volgende kanalen proberen voor aanvullende ondersteuning:

  • Krijg antwoorden van Azure-experts via Azure-forums.
  • Maak verbinding met @AzureSupport, het officiële Microsoft Azure-account voor het verbeteren van de klantervaring. Azure Support verbindt de Azure-community met antwoorden, ondersteuning en experts.
  • Dien een ondersteuning voor Azure incident in. Ga naar de ondersteuning voor Azure site en selecteer Ondersteuning krijgen.