Az Azure Csatlakozás gépügynök kapcsolati problémáinak elhárítása

  • Cikk

Ez a cikk az Azure Csatlakozás ed Machine Agent windowsos vagy linuxos 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ódszerek is megtalálhatók. Általános információkért tekintse meg az Azure Arc-kompatibilis kiszolgálók áttekintését.

Ügynök hibakódjai

Az alábbi táblázattal azonosíthatja és megoldhatja az Azure Csatlakozás-alapú gépügynök konfigurálásával kapcsolatos problémákat ("AZCM00000000" bármely négyjegyű szám lehet), 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ányzik egy 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/gyökér).
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ókért tekintse át a hibaüzenetet. 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 privát kapcsolat hatókörhöz van konfigurálva, a paraméter használatával történő előkészítéshez meg kell adni a --private-link-scope 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ásnév-bejelentkezések esetén ellenőrizze az ügyfél-azonosítót és a titkos kulcsot a helyesség, a titkos kód lejárati dátuma, valamint hogy a szolgáltatásnév 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ó: Csatlakozás gépügynök előfeltételeihez szükséges engedélyek további információkért.
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ó: Csatlakozás gépügynök előfeltételeihez szükséges engedélyek. Ha az erőforrás már nem létezik az Azure-ban, használja a jelölőt a --force-local-only 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 kiszolgáló 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 (--resource-name vagy -n paramé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 a segítségkéréshez.
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 részletes naplója

A cikk későbbi részében ismertetett hibaelhárítási lépések végrehajtása előtt a szükséges minimális információ a részletes napló. Az azcmagent eszközparancsok kimenetét tartalmazza a részletes (-v) argumentum használatakor. A naplófájlok windowsos, linuxos és linuxos rendszerekre /var/opt/azcmagent/log/azcmagent.logvannak beírva%ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log.

Ablakok

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

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

Az alábbiakban egy példa látható arra a parancsra, amely lehetővé teszi a részletes naplózást a Windows Csatlakozás gépi ügynökével, amikor egy szolgáltatásnév használatával végez nagy léptékű telepítést.

& "$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ábbiakban egy példa látható arra a parancsra, amely lehetővé teszi a részletes naplózást a Linux Csatlakozás gépi ügynökével interaktív telepítéskor.

Megjegyzé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 példa egy parancsra, amely lehetővé teszi a részletes naplózást a linuxos Csatlakozás ed machine agenttel, amikor egy szolgáltatásnévvel végzett nagy léptékű telepítést hajt végre.

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 felsorol néhány ismert hibát és javaslatot a hibaelhárításra és a megoldásukra vonatkozóan.

Üzenet 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-ellenőrzést annak ellenőrzéséhez, hogy egy tűzfal blokkolja-e a Microsoft Entra-azonosítóhoz 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-ellenőrzést annak ellenőrzéséhez, hogy egy tűzfal blokkolja-e a Microsoft Entra-azonosítóhoz való hozzáférést.
Nem sikerült beszerezni az engedélyezési jogkivonatot az SPN-ből 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-ellenőrzést annak ellenőrzéséhez, hogy egy tűzfal blokkolja-e a Microsoft Entra-azonosítóhoz való hozzáférést.
Nem sikerült beszerezni az engedélyezési jogkivonatot az SPN-ből Invalid client secret is provided Hibás vagy érvénytelen szolgáltatásnév-titkos kód. Ellenőrizze a szolgáltatásnév titkos kulcsát.
Nem sikerült beszerezni az engedélyezési jogkivonatot az SPN-ből 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 Csatlakozás gép előkészítési szerepkörének.
Nem sikerült az Azcmagent Csatlakozás ARM-erőforrás 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 Azcmagent Csatlakozás ARM-erőforrás 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-ellenőrzést annak ellenőrzéséhez, hogy egy tűzfal blokkolja-e az Azure Resource Managerhez való hozzáférést.

További 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 csatornák egyikével további támogatásért: