Problemen met Azure Automation State Configuration oplossen

Notitie

Azure Automation State Configuration wordt op 30 september 2027 buiten gebruik gesteld. Stap op die datum over naar Azure Machine Configuration . Zie de aankondiging van het blogbericht voor meer informatie. De Azure Machine Configuration-service combineert functies van DSC-extensie, Azure Automation State Configuration en de meest aangevraagde functies uit feedback van klanten. Azure Machine Configuration omvat ook ondersteuning voor hybride machines via servers met Arc.

Let op

Azure Automation DSC voor Linux is op 30 september 2023 buiten gebruik gesteld. Zie de aankondiging voor meer informatie.

Dit artikel bevat informatie over het oplossen en oplossen van problemen die optreden 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 de 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. Probeer het later opnieuw.

Oplossing

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

Scenario: Kan de DSC-agent niet registreren

Probleem

Er wordt een foutbericht weergegeven wanneer u Set-DscLocalConfigurationManager of een andere DSC-cmdlet gebruikt.

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
https://<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.RegisterDscAgentCommand
    + PSComputerName        : <computerName>

Oorzaak

Netwerkprobleem kan deze fout veroorzaken. Controleer de firewallinstellingen of of de computer zich achter een proxyserver bevindt.

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 *.azure-automation.nettoestaat. 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. Gebruik de volgende opdracht om de tijd 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

Dit probleem kan optreden als Windows Management Instrumentation (WMI) is beschadigd op het knooppunt.

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

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

Oplossing

Zorg ervoor dat u de juiste ConfigurationDatawaarde doorgeeft, en stel PSDscAllowPlainTextPassword deze in op waar voor elke knooppuntconfiguratie. 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 de naam van het knooppunt exact overeenkomt met de naam in de service of dat de configuratienaam van het knooppunt niet is opgenomen. Hiermee wordt het knooppunt ingeschakeld, maar wordt geen knooppuntconfiguratie toegewezen.

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 een knooppunt probeert te registreren in een ander abonnement dan het knooppunt dat wordt gebruikt door het Automation-account.

Oplossing

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

• Windows: Fysieke/virtuele Windows-machines on-premises of in een andere cloud dan Azure/AWS.
• Linux: fysieke/virtuele Linux-machines on-premises of in een andere cloud dan Azure.

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

Als u het probleem wilt omzeilen, past u een andere testconfiguratie toe en probeert u de oorspronkelijke configuratie opnieuw.

Volgende stappen

Als u het probleem hier niet ziet of als u het probleem niet kunt oplossen, kunt u een van de volgende ondersteuningskanalen proberen:

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