Az Azure Automation állapotkonfigurációs problémáinak elhárítása

Feljegyzés

Az Azure Automation State Configuration 2027. szeptember 30-án megszűnik, ezért ezen a napon lépjen át az Azure Machine Configuration szolgáltatásra. További információkért lásd a blogbejegyzés bejelentését. Az Azure Machine Configuration szolgáltatás egyesíti a DSC-bővítmény, az Azure Automation State Configuration és az ügyfelek visszajelzései alapján leggyakrabban kért funkciókat. Az Azure Machine Configuration emellett az Arc-kompatibilis kiszolgálókon keresztüli hibrid gépek támogatását is tartalmazza.

Ez a cikk az Azure Automation State Configuration konfigurációinak fordítása vagy üzembe helyezése során felmerülő problémák hibaelhárításáról és megoldásáról nyújt tájékoztatást. Az Állapotkonfiguráció funkcióval kapcsolatos általános információkért tekintse meg az Azure Automation állapotkonfigurációjának áttekintését.

Probléma diagnosztizálása

Amikor fordítási vagy üzembe helyezési hibát kap a konfigurációhoz, az alábbi lépések segítenek a probléma diagnosztizálásában.

1. Győződjön meg arról, hogy a konfiguráció sikeresen lefordítható a helyi gépen

Az Azure Automation State Configuration a PowerShell Desired State Configuration (DSC) szolgáltatásra épül. A DSC nyelvének és szintaxisának dokumentációját a PowerShell DSC-dokumentumokban találja.

A helyi gépen található DSC-konfiguráció összeállításával felderítheti és megoldhatja a gyakori hibákat, például:

• Hiányzó modulok.
• Szintaxishibák.
• Logikai hibák.

2. DSC-naplók megtekintése a csomóponton

Ha a konfiguráció sikeresen lefordítva, de egy csomópontra alkalmazva meghiúsul, részletes információkat találhat a DSC-naplókban. A naplók megkereséséről további információt a Hol találhatók a DSC eseménynaplói című témakörben talál.

Az xDscDiagnostics modul segítséget nyújthat a DSC-naplók részletes információinak elemzésében. Ha kapcsolatba lép az ügyfélszolgálattal, ezek a naplók szükségesek a probléma diagnosztizálásához.

A modult a xDscDiagnostics helyi gépére telepítheti a stabil verziójú modul telepítésével kapcsolatos utasításokat követve.

A modul Azure-gépen való telepítéséhez használja az xDscDiagnostics Invoke-AzVMRunCommand parancsot. A Futtatás parancsot az Azure Portalon is használhatja a Windows rendszerű virtuális gép PowerShell-szkriptjeinek futtatása a Futtatás paranccsal lépésekkel.

További információ az xDscDiagnostics használatáról: DSC-naplók elemzése xDscDiagnostics használatával. Lásd még : xDscDiagnostics Parancsmagok.

3. Győződjön meg arról, hogy a csomópontok és az Automation-munkaterület rendelkezik a szükséges modulokkal

A DSC a csomóponton telepített moduloktól függ. Az Azure Automation State Configuration használatakor importálja a szükséges modulokat az Automation-fiókjába a Modulok importálása lépésekkel. A konfigurációk a modulok adott verzióitól is függhetnek. További információ: Modulok hibaelhárítása.

Forgatókönyv: A speciális karaktereket tartalmazó konfiguráció nem törölhető a portálról

Probléma

Amikor megpróbál törölni egy DSC-konfigurációt a portálról, a következő hibaüzenet jelenik meg:

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.

Ok

Ez a hiba ideiglenes probléma. Próbálkozzon újra később.

Resolution (Osztás)

A Konfiguráció törléséhez használja a Remove-AzAutomationDscConfiguration parancsmagot.

Forgatókönyv: Nem sikerült regisztrálni a DSC-ügynököt

Probléma

A Set-DscLocalConfigurationManager vagy egy másik DSC-parancsmag használatakor hibaüzenet jelenik meg.

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>

Ok

A hálózati probléma okozhatja ezt a hibát. Ellenőrizze a tűzfal beállításait, vagy hogy a gép proxykiszolgáló mögött van-e.

Resolution (Osztás)

Ellenőrizze, hogy a gép hozzáfér-e a DSC megfelelő végpontjaihoz, majd próbálkozzon újra. A szükséges portok és címek listáját lásd : Hálózattervezés.

Forgatókönyv: Az állapotjelentések nem engedélyezett válaszkódot adnak vissza

Probléma

Amikor regisztrál egy csomópontot az Azure Automation State Configuration szolgáltatásban, a következő hibaüzenetek egyikét kapja:

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.

Ok

A lehetséges okok a következők:

• Hibás vagy lejárt tanúsítvány. Lásd: Csomópont újbóli regisztrálása.

• Proxykonfiguráció, amely nem teszi lehetővé a hozzáférést.*.azure-automation.net További információ: Magánhálózatok konfigurálása.

• Ha letiltja a helyi hitelesítést az Azure Automationben. Lásd: Helyi hitelesítés letiltása. A probléma megoldásához tekintse meg a helyi hitelesítés újbóli engedélyezését.

• Az ügyfélszámítógép ideje a tényleges időtől számítva több perc pontatlan. Az idő ellenőrzéséhez használja a következő parancsot: w32tm /stripchart /computer:time.windows.com /samples:6.

Resolution (Osztás)

A sikertelen DSC-csomópont újraregisztrálásához kövesse az alábbi lépéseket.

1. lépés: A csomópont regisztrációjának megszüntetése

1. Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC).
2. Válassza a Csomópontok lehetőséget, és válassza ki a problémás csomópontot.
3. Válassza a Regisztráció törlése lehetőséget a csomópont regisztrációjának megszüntetéséhez.

2. lépés: A DSC-bővítmény eltávolítása a csomópontról

1. Az Azure Portalon nyissa meg az Otthoni>virtuális gép> (hibás csomópont) >bővítményeket.
2. Válassza ki a Microsoft.Powershell.DSC-t, a PowerShell DSC-bővítményt.
3. Válassza az Eltávolítás lehetőséget a bővítmény eltávolításához.

3. lépés: Az összes hibás vagy lejárt tanúsítvány eltávolítása a csomópontról

Az emelt szintű PowerShell-parancssorból származó sikertelen csomóponton futtassa az alábbi parancsokat:

$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)
    }
}

4. lépés: A hibás csomópont újbóli regisztrálása

1. Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC).
2. Válassza a Csomópontok lehetőséget.
3. Válassza a Hozzáadás lehetőséget.
4. Válassza ki a hibás csomópontot.
5. Válassza a Csatlakozás lehetőséget, és válassza ki a kívánt beállításokat.

Forgatókönyv: A csomópont "Nem található" hibával meghiúsult állapotban van

Probléma

A csomópont egy sikertelen állapotú jelentéssel rendelkezik, amely a következő hibát tartalmazza:

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.

Ok

Ez a hiba általában akkor fordul elő, ha a csomópontot egy konfigurációs névhez, például ABC-hez rendelik a csomópontkonfiguráció (MOF-fájl) neve helyett, például az ABC-hez. WebServer.

Resolution (Osztás)

• Győződjön meg arról, hogy a csomópontot a csomópont konfigurációs nevével rendeli hozzá, nem pedig a konfiguráció nevét.
• Csomópontkonfigurációt az Azure Portalon vagy egy PowerShell-parancsmaggal rendelhet hozzá egy csomóponthoz.
  • Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC). Ezután válasszon ki egy csomópontot, és válassza a Csomópontkonfiguráció hozzárendelése lehetőséget.
  • Használja a Set-AzAutomationDscNode parancsmagot.

Forgatókönyv: A konfiguráció lefordításakor nem jöttek létre csomópontkonfigurációk (MOF-fájlok)

Probléma

A DSC fordítási feladata a következő hibával függeszt fel:

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

Ok

Amikor a DSC-konfigurációban a Node kulcsszót követő kifejezés kiértékeli, $nulla rendszer nem hoz létre csomópontkonfigurációkat.

Resolution (Osztás)

A probléma megoldásához használja az alábbi megoldások egyikét:

• Győződjön meg arról, hogy a Node konfigurációdefiníció kulcsszója melletti kifejezés nem null értékű.
• Ha a konfiguráció lefordításakor adja át a ConfigurationData-t , győződjön meg arról, hogy a konfiguráció által elvárt értékeket adja át a konfigurációs adatoktól.

Forgatókönyv: A DSC-csomópont jelentése elakad a Folyamatban állapotban

Probléma

A DSC-ügynök kimenetei:

No instance found with given property values

Ok

Ez a probléma akkor fordulhat elő, ha a Windows Management Instrumentation (WMI) sérült a csomóponton.

Resolution (Osztás)

Kövesse a DSC ismert problémáival és korlátozásokkal kapcsolatos utasításait.

Forgatókönyv: A hitelesítő adatok nem használhatók DSC-konfigurációban

Probléma

A DSC fordítási feladatát a következő hibával függesztette fel:

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.

Ok

Ez a probléma akkor fordulhat elő, ha hitelesítő adatokat használ egy konfigurációban, de nem adta meg a megfelelő ConfigurationData PSDscAllowPlainTextPassword beállítást az egyes csomópontkonfigurációkhoz.

Resolution (Osztás)

Győződjön meg arról, hogy az egyes csomópontkonfigurációk esetében a megfelelő ConfigurationData, igaz értéket adja PSDscAllowPlainTextPassword meg. Lásd: DSC-konfigurációk összeállítása az Azure Automation State Configuration szolgáltatásban.

Forgatókönyv: "Hibafeldolgozási bővítmény" hiba a gép DSC-bővítményből való engedélyezésekor

Probléma

Ha DSC-bővítmény használatával engedélyezi a gépet, hiba történik, amely a következő hibát tartalmazza:

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. .\".

Ok

Ez a hiba általában akkor fordul elő, ha a csomóponthoz olyan csomópontkonfigurációs nevet rendel, amely nem létezik a szolgáltatásban.

Resolution (Osztás)

Győződjön meg arról, hogy a szolgáltatásban szereplő névnek megfelelő csomópontnév, vagy nem tartalmazza a csomópont konfigurációjának nevét. Ez engedélyezi a csomópontot, de nem rendel hozzá csomópontkonfigurációt.

Forgatókönyv: "Egy vagy több hiba történt" hiba, amikor egy csomópontot regisztrál a PowerShell használatával

Probléma

Amikor regisztrál egy csomópontot a Register-AzAutomationDSCNode vagy a Register-AzureRMAutomationDSCNode használatával, a következő hibaüzenet jelenik meg:

One or more errors occurred.

Ok

Ez a hiba akkor fordul elő, ha az Automation-fiók által használttól eltérő előfizetésben próbál csomópontot regisztrálni.

Resolution (Osztás)

Kezelje az előfizetések közötti csomópontot egy külön felhőhöz vagy helyszínihez definiált csomópontként. Regisztrálja a csomópontot az alábbi lehetőségek egyikével a gépek engedélyezéséhez:

• Windows: Fizikai/virtuális Windows-gépek a helyszínen vagy az Azure/AWS-en kívüli felhőben.
• Linux: Fizikai/virtuális Linux-gépek a helyszínen vagy az Azure-on kívüli felhőben.

Forgatókönyv: "A kiépítés meghiúsult" hibaüzenet

Probléma

Amikor regisztrál egy csomópontot, a következő hibaüzenet jelenik meg:

Provisioning has failed

Ok

Ez az üzenet akkor jelenik meg, ha probléma merül fel a csomópont és az Azure közötti kapcsolattal kapcsolatban.

Resolution (Osztás)

Állapítsa meg, hogy a csomópont virtuális magánhálózaton (VPN) található-e, vagy más problémák merülnek fel az Azure-hoz való csatlakozás során. Lásd a funkció üzembe helyezésével kapcsolatos problémák elhárítását.

Forgatókönyv: Általános hibával kapcsolatos hiba a konfiguráció linuxos alkalmazásakor

Probléma

Amikor linuxos konfigurációt alkalmaz, hiba történik, amely a következő hibát tartalmazza:

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

Ok

Ha a /tmp hely beállításakor noexeca DSC jelenlegi verziója nem alkalmazza a konfigurációkat.

Resolution (Osztás)

Távolítsa el a noexec lehetőséget a /tmp helyről.

Forgatókönyv: Az átfedésben lévő csomópont-konfigurációnevek rossz kiadást eredményezhetnek

Probléma

Ha egyetlen konfigurációs szkripttel több csomópontkonfigurációt hoz létre, és egyes csomópontkonfigurációnevek más nevek részhalmazai, a fordítási szolgáltatás végül nem a megfelelő konfigurációt rendeli hozzá. Ez a probléma csak akkor fordul elő, ha egyetlen szkripttel hoz létre konfigurációkat csomópontonkénti konfigurációs adatokkal, és csak akkor, ha a név átfedésben van a sztring elején. Ilyen például egy olyan konfigurációs szkript, amellyel parancsmagok használatával kivonatolóként átadott csomópontadatokon alapuló konfigurációkat hozhat létre, a csomópontadatok pedig kiszolgáló és 1kiszolgáló nevű kiszolgálókat tartalmaznak.

Ok

Ez a fordítási szolgáltatás ismert problémája.

Resolution (Osztás)

A legjobb megoldás az, ha helyileg vagy CI/CD-folyamatban fordítja le, és feltölti a csomópontkonfigurációs MOF-fájlokat közvetlenül a szolgáltatásba. Ha a szolgáltatásban való fordítás követelmény, a következő legjobb megoldás a fordítási feladatok felosztása, hogy ne legyen átfedés a nevek között.

Forgatókönyv: Átjáró időtúllépési hibája a DSC-konfiguráció feltöltésekor

Probléma

A DSC-konfiguráció feltöltésekor hibaüzenet jelenik GatewayTimeout meg.

Ok

A fordításhoz hosszú ideig tartó DSC-konfigurációk okozhatják ezt a hibát.

Resolution (Osztás)

A DSC-konfigurációk elemzését gyorsabbá teheti, ha explicit módon beleszámít minden ModuleName Import-DSCResource-hívás paraméterét.

Forgatókönyv: Hiba a gép előkészítése során

Probléma

A gép előkészítésekor hibaüzenet jelenik agent has a problem meg.

Ok

Ez egy ismert probléma. Nem rendelheti hozzá újra ugyanazt a konfigurációt, mint amikor a csomópont függőben marad.

Resolution (Osztás)

A probléma megoldásához alkalmazzon egy másik tesztkonfigurációt, és próbálkozzon újra az eredeti konfigurációval.

Következő lépések

Ha itt nem látja a problémát, vagy nem tudja megoldani a problémát, próbálkozzon az alábbi támogatási csatornák egyikével:

• Azure-szakértők válaszolnak az Azure Fórumain keresztül.
• Csatlakozzon @AzureSupport, a hivatalos Microsoft Azure-fiókhoz az ügyfélélmény javítása érdekében. Az Azure-támogatás összekapcsolja az Azure-közösséget a válaszokhoz, a támogatáshoz és a szakértőkhöz.
• Azure-támogatás incidens bejelentése. Lépjen a Azure-támogatás webhelyre, és válassza a Támogatás kérése lehetőséget.