Megosztás a következőn keresztül:

Az Azure Connected Machine Agent kapcsolati problémáinak elhárítása

Ez a cikk a Windowshoz vagy Linuxhoz készült Azure Connected Machine-ügynök konfigurálása során felmerülő problémák elhárításáról nyújt tájékoztatást. A szolgáltatáshoz való csatlakozás konfigurálásakor az interaktív és a nagy léptékű telepítési módszerekre vonatkozó tippek is megtalálhatók.

Általános információkért tekintse meg az Azure Arc-kompatibilis kiszolgálók áttekintését, az Azure Connected Machine-ügynök áttekintését, valamint a Csatlakoztatottgép-ügynök kezelését és karbantartását.

Ügynök hibakódjai

Az alábbi táblázattal azonosíthatja és megoldhatja az Azure Connected Machine-ügynök konfigurálásával kapcsolatos problémákat a AZCM0000 ("0000" bármely négyjegyű szám lehet) hibakóddal, amely a konzolra vagy a szkript kimenetére van nyomtatva.

Hibakód Valószínű ok Javasolt szervizelés
AZCM0000 A művelet sikeres volt n/a
AZCM0001 Ismeretlen hiba történt Segítségért forduljon a Microsoft ügyfélszolgálatához .
AZCM0011 A felhasználó megszakította a műveletet (CTRL+C) Próbálkozzon újra az előző paranccsal.
AZCM0012 A hozzáférési jogkivonat érvénytelen Ha hozzáférési jogkivonaton keresztül hitelesít, szerezze be az új jogkivonatot, és próbálkozzon újra. Ha szolgáltatásnévvel vagy eszközbeléptetéssel hitelesít, forduljon Microsoft ügyfélszolgálata segítségért.
AZCM0016 Hiányzó kötelező paraméter Tekintse át a kimenetben megjelenő hibaüzenetet, és állapítsa meg, hogy mely paraméterek hiányoznak. A parancs teljes szintaxisához futtassa a következőt azcmagent <command> --help: .
AZCM0018 A parancs rendszergazdai jogosultságok nélkül lett végrehajtva Próbálkozzon újra a parancs emelt szintű felhasználói környezetben (rendszergazda/root).
AZCM0019 A konfigurációs fájl elérési útja helytelen Győződjön meg arról, hogy a konfigurációs fájl elérési útja helyes, és próbálkozzon újra.
AZCM0023 A paraméterhez (argumentumhoz) megadott érték érvénytelen További információt a hibaüzenetben talál. Tekintse meg a parancs (azcmagent <command> --help) szintaxisát érvényes értékek vagy az argumentumok várt formátuma esetén.
AZCM0026 Hiba történt a hálózati konfigurációban, vagy néhány kritikus szolgáltatás átmenetileg nem érhető el Ellenőrizze, hogy a szükséges végpontok elérhetők-e (például a gazdagépnevek feloldhatók, a végpontok nincsenek letiltva). Ha a hálózat a Privát Kapcsolati Hatókörre van konfigurálva, a parameter --private-link-scope használatával történő beállításhoz meg kell adni a Private Link Scope erőforrás-azonosítóját.
AZCM0041 A megadott hitelesítő adatok érvénytelenek Eszközbeléptetések esetén ellenőrizze, hogy a megadott felhasználói fiók rendelkezik-e hozzáféréssel ahhoz a bérlőhöz és előfizetéshez, ahol a kiszolgálói erőforrás létrejön. Szolgáltatási fiók bejelentkezéseknél ellenőrizze az ügyfélazonosító és a titkos kulcs helyességét, az érvényes lejárati dátumot, és győződjön meg arról, hogy a szolgáltatási fiók ugyanabból a bérlőből származik, ahol a kiszolgálóerőforrás létrejön.
AZCM0042 Az Azure Arc-kompatibilis kiszolgálói erőforrás létrehozása nem sikerült Tekintse át a kimenetben megjelenő hibaüzenetet az erőforrás létrehozásának sikertelenségének okának és a javasolt szervizelésnek az azonosításához. További információ: Szükséges engedélyek.
AZCM0043 Az Azure Arc-kompatibilis kiszolgálói erőforrás törlése meghiúsult Ellenőrizze, hogy a megadott felhasználó/szolgáltatásnév rendelkezik-e engedéllyel az Azure Arc-kompatibilis kiszolgáló/erőforrások törléséhez a megadott csoportban. További információ: Szükséges engedélyek. Ha az erőforrás már nem létezik az Azure-ban, a --force-local-only zászlót használja a folytatáshoz.
AZCM0044 Már létezik ugyanazzal a névvel rendelkező erőforrás Adjon meg egy másik nevet a --resource-name paraméternek, vagy törölje a meglévő Azure Arc-kompatibilis kiszolgálót az Azure-ban, és próbálkozzon újra.
AZCM0062 Hiba történt a kiszolgáló csatlakoztatása közben További információkért tekintse át a kimenetben megjelenő hibaüzenetet. Ha a hiba az Azure-erőforrás létrehozása után történt, az újrapróbálkozás előtt törölje ezt az erőforrást.
AZCM0063 Hiba történt a szerver leválasztásakor További információkért tekintse át a kimenetben megjelenő hibaüzenetet. Ha a hiba továbbra is fennáll, törölje az erőforrást az Azure-ban, majd futtassa azcmagent disconnect --force-local-only a kiszolgálón.
AZCM0067 A gép már csatlakoztatva van az Azure-hoz Futtassa azcmagent disconnect az aktuális kapcsolat eltávolításához, majd próbálkozzon újra.
AZCM0068 Az előfizetés neve meg lett adva, és hiba történt a megfelelő előfizetés GUID-azonosítójának keresése közben. Az előfizetés neve helyett próbálkozzon újra a paranccsal az előfizetés GUID azonosítójával.
AZCM0061
AZCM0064
AZCM0065
AZCM0066
AZCM0070
 Az ügynökszolgáltatás nem válaszol vagy nem érhető el Ellenőrizze, hogy a parancs rendszergazdai/gyökérszintű felhasználói környezetben fut-e. Győződjön meg arról, hogy a HIMDS szolgáltatás fut (szükség szerint indítsa el vagy indítsa újra a HIMDS szolgáltatást), majd próbálkozzon újra a paranccsal.
AZCM0081 Hiba történt a Microsoft Entra által felügyelt identitástanúsítvány letöltése közben Ha ez az üzenet a kiszolgáló Azure-hoz való csatlakoztatása során jelenik meg, az ügynök nem tud kommunikálni az Azure Arc szolgáltatással. Törölje az erőforrást az Azure-ban, és próbálkozzon újra a csatlakozással.
AZCM0101 A parancs elemzése nem sikerült Futtassa azcmagent <command> --help a parancs szintaxisának áttekintéséhez.
AZCM0102 Hiba történt a számítógép gazdagépnevének beolvasása közben Próbálkozzon újra a paranccsal, és adjon meg egy erőforrásnevet (paraméterrel --resource-name vagy –nparaméterrel). Csak alfanumerikus karaktereket, kötőjeleket és/vagy aláhúzásjeleket használjon; vegye figyelembe, hogy az erőforrás neve nem végződhet kötőjellel vagy aláhúzásjellel.
AZCM0103 Hiba történt az RSA-kulcsok létrehozása közben Segítségért forduljon a Microsoft ügyfélszolgálatához .
AZCM0105 Hiba történt a Microsoft Entra ID felügyelt azonosító tanúsítványának letöltése közben Törölje az Azure-ban létrehozott erőforrást, és próbálkozzon újra.
AZCM0147-
AZCM0152		 Hiba történt az Azcmagent windowsos telepítése során További információkért tekintse át a kimenetben megjelenő hibaüzenetet.
AZCM0127-
AZCM0146		 Hiba történt az Azcmagent linuxos telepítése során További információkért tekintse át a kimenetben megjelenő hibaüzenetet.
AZCM0150 Általános hiba a telepítés során Küldjön támogatási jegyet segítségért.
AZCM0153 A rendszerplatform nem támogatott A támogatott platformok előfeltételeinek áttekintése
AZCM0154 A rendszeren telepített PowerShell-verzió túl régi Frissítsen a PowerShell 4-re vagy újabb verzióra, és próbálkozzon újra.
AZCM0155 A telepítési szkriptet futtató felhasználó nem rendelkezik rendszergazdai engedélyekkel Futtassa újra a szkriptet rendszergazdaként.
AZCM0156 Az ügynök telepítése nem sikerült Ellenőrizze, hogy a gép nem fut-e az Azure-ban. Részletes hibák a telepítési naplóban találhatók a következő helyen %TEMP%\installationlog.txt: .
AZCM0157 Nem lehet letölteni a Microsoft Linux-szoftvertárház adattárának adattár metaadatait Ellenőrizze, hogy egy tűzfal blokkolja-e a hozzáférést, packages.microsoft.com és próbálkozzon újra.

Ügynök kilépési kódjai

Az Azure Connected Machine Agent (azcmagent) parancsainak futtatásakor a folyamat leállhat egy kilépési kóddal. Ezek a kódok jelzik a művelet eredményét, és segítenek a problémák diagnosztizálásában. A hibakódokkal ellentétben az operációs rendszer a kilépési kódokat adja vissza az ügynökfolyamat kilépésekor.

Kilépési kód Description Javasolt szervizelés
0 Nem történt hiba. Nincs szükség beavatkozásra.
1 Alapértelmezett hiba Győződjön meg arról, hogy teljesülnek az előfeltételek, ellenőrizze az ügynöknaplókat, és próbálkozzon újra.
2 Belső hiba az ügynökben. Indítsa újra az ügynökszolgáltatást.
3 A művelet nem támogatott. Ellenőrizze, hogy a parancs érvényes-e az operációs rendszerre és az ügynök verziójára.
4 Az Arc proxyszolgáltatás nem fut. Győződjön meg arról, hogy Hybrid Instance Metadata Service (himds) a szolgáltatás fut.
5 A fájlnaplózó nem érhető el. Ellenőrizze a lemezterületet és a naplókönyvtár engedélyeit.
6 Az inicializálás nem sikerült. Ellenőrizze az előfeltételeket (hálózat, engedélyek). Javítsa ki a problémákat, majd futtassa újra a azcmagent connect parancsot.
11 Felhasználó által megszakított művelet (Ctrl+C). Futtassa újra a parancsot megszakítás nélkül.
12 Érvénytelen hozzáférési jogkivonat van megadva. Frissítse Azure-hitelesítő adatait az az login használatával, vagy adjon meg egy érvényes jogkivonatot.
18 Rendszergazdai jogosultságok szükségesek. Futtassa a parancsot emelt szintű jogosultságokkal (sudo vagy emelt szintű parancssorral).
19 A konfigurációs fájl nem található. Ellenőrizze a konfigurációs fájl elérési útját, vagy generálja újra a azcmagent config segítségével.
20 Ismeretlen régió van megadva. Ellenőrizze a régió helyesírását, és győződjön meg arról, hogy a régió támogatott.
23 Érvénytelen argumentumokat adott meg. A azcmagent --help segítségével tekintse át a parancs szintaxisát.
26 Hálózati hiba történt. Az Azure-végpontokhoz való kapcsolódás ellenőrzése. Ellenőrizze a tűzfal és a proxy beállításait.
27 Konfigurációs ütközés észlelhető. Távolítsa el az ütköző beállításokat /etc/azcmagent/config.json vagy %ProgramData%\AzureConnectedMachineAgent\Config\localconfig.json és próbálkozzon újra.
41 Nem sikerült megszerezni a hozzáférési tokent. Győződjön meg arról, hogy az login sikeres, és ha alkalmazható, az MSI engedélyezett.
42 Nem sikerült létrehozni az Azure-erőforrást. Ellenőrizze az előfizetési engedélyeket és az erőforráskvótát.
43 Nem sikerült törölni az Azure-erőforrást. Ellenőrizze, hogy létezik-e erőforrás, és rendelkezik-e törlési engedélyekkel.
44 Az erőforrás már létezik. azcmagent reconnecthelyett használja connect.
45 Nem sikerült frissíteni az újracsatlakozás nyilvános kulcsát. A hálózati kapcsolat és az ügynöknaplók ellenőrzése után próbálkozzon újra.
61 Ügynökkommunikációs hiba. Indítsa újra a himds szolgáltatást.
62 Nem sikerült csatlakoztatni a gépet az Azure-hoz. Ellenőrizze a hálózati kapcsolatot és az előfizetési engedélyeket.
63 Nem sikerült leválasztani a gépet az Azure-ról. A gép online állapotának és az ügynök kifogástalan állapotának biztosítása után próbálkozzon újra.
64 Nem sikerült kapcsolatot létesíteni a HIMDS-kiszolgálóval. Indítsa újra himds a szolgáltatást, és ellenőrizze a naplókat.
65 Nem sikerült beszerezni az ügynök metaadatait. Ellenőrizze az ügynöknaplókat, és próbálkozzon újra.
66 Nem sikerült megszerezni az ügynök állapotát. Indítsa újra az ügynököt, és ellenőrizze a kapcsolatot.
67 A gép már csatlakoztatva van. azcmagent reconnecthelyett használja connect.
68 Nem sikerült beolvasni az előfizetés azonosítóját. Ellenőrizze az Azure hitelesítő adatait, és próbálkozzon újra.
69 Hiba történt a helyi konfiguráció frissítésekor. Ellenőrizze a fájlengedélyeket, és próbálkozzon újra.
70 Nem sikerült megszerezni a helyi konfigurációt. Ellenőrizze a konfigurációs fájl integritását, és próbálkozzon újra.
72 Hiba történt a bővítményeszköz futtatásakor. Ellenőrizze a bővítménynaplókat, és próbálkozzon újra.
73 Nem sikerült beszerezni a partnerkonfigurációt. Partnerintegrációs beállítások ellenőrzése.
74 Hiba történt a bővítmény hozzáadásakor. Győződjön meg arról, hogy a bővítménycsomag érvényes, és próbálkozzon újra.
75 Nem sikerült beszerezni a felhőkonfigurációt. Ellenőrizze az Azure-végpontokhoz való kapcsolódást.
81 Nem sikerült lekérni az MSI-tanúsítványt a HIS-ből. Győződjön meg arról, hogy a HIS szolgáltatás fut, és próbálkozzon újra.
101 Parancsvégrehajtási hiba. Ellenőrizze a parancs szintaxisát, és ellenőrizze a naplókat a részletekért.
102 Nem sikerült létrehozni az erőforrás nevét. Győződjön meg arról, hogy a gazdagépnév megfelel az Azure elnevezési követelményeinek.
104 Nem sikerült lekérni a titkos kulcsot. Ellenőrizze a kulcstárolót, és próbálkozzon újra.
105 Nem sikerült lekérni az aláírt üzenetet. Ellenőrizze a kapcsolatot, és próbálkozzon újra.
106 Nem sikerült menteni a paraméterfájlt. Ellenőrizze a lemezterületet és az engedélyeket.
107 Nem sikerült lekérni a tanúsítványt. Ellenőrizze a tanúsítványtárolót, és próbálkozzon újra.

Ügynök részletes és bőbeszédű naplója

A cikk későbbi részében ismertetett hibaelhárítási lépések követéséhez a szükséges minimális információ a részletes napló. Ez a napló tartalmazza az azcmagent eszköz parancsainak kimenetét, amikor a részletes (-v) argumentum kerül használatra. A naplófájlok a Windows rendszerben a %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log, a Linux rendszerben pedig a /var/opt/azcmagent/log/azcmagent.log könyvtárba vannak írva.

Windows

Az alábbi parancs egy példa, amely lehetővé teszi a részletes naplózást a Windows csatlakoztatott gép ügynökével interaktív telepítéskor.

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose

Az alábbi parancs egy példa, amely részletes naplózást tesz lehetővé a Windows csatlakoztatottgép-ügynökével, amikor nagy léptékű telepítést hajt végre egy szolgáltatásnévvel.

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
  --service-principal-id "{serviceprincipalAppID}" `
  --service-principal-secret "{serviceprincipalPassword}" `
  --resource-group "{ResourceGroupName}" `
  --tenant-id "{tenantID}" `
  --location "{resourceLocation}" `
  --subscription-id "{subscriptionID}"
  --verbose

Linux

Az alábbi parancs egy példa, amely lehetővé teszi a részletes naplózást a Linux csatlakoztatott gép ügynökével egy interaktív telepítés végrehajtásakor.

Feljegyzés

Az azcmagent futtatásához gyökérelérési engedélyekkel kell rendelkeznie Linux rendszerű gépeken.

azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose

Az alábbi parancs egy példa, amely lehetővé teszi a részletes naplózást a Linux csatlakoztatottgép-ügynökével, amikor nagy léptékű telepítést hajt végre egy szolgáltatásnévvel.

azcmagent connect \
  --service-principal-id "{serviceprincipalAppID}" \
  --service-principal-secret "{serviceprincipalPassword}" \
  --resource-group "{ResourceGroupName}" \
  --tenant-id "{tenantID}" \
  --location "{resourceLocation}" \
  --subscription-id "{subscriptionID}"
  --verbose

Ügynökkapcsolati problémák a szolgáltatásban

Az alábbi táblázat különböző hibákat és javaslatokat tartalmaz a hibaelhárítással és a megoldásukkal kapcsolatban.

Hiba Valószínű ok Megoldás
Nem sikerült beszerezni az engedélyezési jogkivonat eszközfolyamatát:
Error occurred while sending request for Device Authorization Code: Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/devicecode?api-version=1.0: dial tcp 40.126.9.7:443: connect: network is unreachable.		 Nem érhető el login.windows.net a végpont Futtassa azcmagent check annak ellenőrzésére, hogy egy tűzfal blokkolja-e a Microsoft Entra ID-hez való hozzáférést.
Nem sikerült beszerezni az engedélyezési jogkivonat eszközfolyamatát:
Error occurred while sending request for Device Authorization Code: Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/devicecode?api-version=1.0: dial tcp 40.126.9.7:443: connect: network is Forbidden.		 A proxy vagy tűzfal blokkolja a végponthoz login.windows.net való hozzáférést. Futtassa azcmagent check annak ellenőrzésére, hogy egy tűzfal blokkolja-e a Microsoft Entra ID-hez való hozzáférést.
Nem sikerült beolvasni az engedélyezési jogkivonatot a Szolgáltatási Azonosítóról (SPN):
Failed to execute the refresh request. Error = 'Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/token?api-version=1.0: Forbidden'		 A proxy vagy tűzfal blokkolja a végponthoz login.windows.net való hozzáférést. Futtassa azcmagent check annak ellenőrzésére, hogy egy tűzfal blokkolja-e a Microsoft Entra ID-hez való hozzáférést.
Nem sikerült beolvasni az engedélyezési jogkivonatot a Szolgáltatási Azonosítóról (SPN):
Invalid client secret is provided		 Hibás vagy érvénytelen szolgáltatásnév-titkos kód. Ellenőrizze a szolgáltatási főazonosító titkos kulcsát.
Nem sikerült beolvasni az engedélyezési jogkivonatot a Szolgáltatási Azonosítóról (SPN):
Application with identifier 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' wasn't found in the directory 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. This can happen if the application has not been installed by the administrator of the tenant or consented to by any user in the tenant		 Helytelen szolgáltatásnév és/vagy bérlőazonosító. Ellenőrizze a szolgáltatásnevet és/vagy a bérlőazonosítót.
ARM-erőforrás válaszának lekérése:
The client 'username@domain.com' with object id 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' does not have authorization to perform action 'Microsoft.HybridCompute/machines/read' over scope '/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/myResourceGroup/
providers/Microsoft.HybridCompute/machines/MSJC01' or the scope is invalid. If access was recently granted, please refresh your credentials."}}" Status Code=403		 Helytelen hitelesítő adatok és/vagy engedélyek Ellenőrizze, hogy Ön vagy a szolgáltatásnév tagja-e az Azure Connected Machine Onboarding szerepkörnek .
Nem sikerült az AzcmagentConnect ARM erőforráshoz csatlakozni.
The subscription isn't registered to use namespace 'Microsoft.HybridCompute'		 Az Azure-erőforrás-szolgáltatók nincsenek regisztrálva. Regisztrálja az erőforrás-szolgáltatókat.
Nem sikerült az AzcmagentConnect ARM erőforráshoz csatlakozni.
Get https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/myResourceGroup/providers/
Microsoft.HybridCompute/machines/MSJC01?api-version=2019-03-18-preview: Forbidden		 A proxykiszolgáló vagy a tűzfal blokkolja a végponthoz management.azure.com való hozzáférést. Futtassa azcmagent check, hogy ellenőrizze, blokkolja-e egy tűzfal az Azure Resource Managerhez való hozzáférést.

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:

  • Last updated on