Rozwiązywanie problemów z połączeniem agenta Azure Connected Machine Agent
Ten artykuł zawiera informacje dotyczące rozwiązywania problemów, które mogą wystąpić podczas konfigurowania agenta połączonej maszyny platformy Azure dla systemu Windows lub Linux. Dostępne są metody instalacji interakcyjnej i na dużą skalę podczas konfigurowania połączenia z usługą. Aby uzyskać ogólne informacje, zobacz Omówienie serwerów z obsługą usługi Azure Arc.
Kody błędów agenta
Skorzystaj z poniższej tabeli, aby zidentyfikować i rozwiązać problemy podczas konfigurowania agenta maszyny połączonej platformy Azure przy użyciu AZCM0000 ("0000" może być dowolnym czterocyfrowym numerem) kod błędu wydrukowany w konsoli lub danych wyjściowych skryptu.
| Kod błędu | Prawdopodobna przyczyna | Sugerowane korygowanie |
|---|---|---|
| AZCM0000 | Akcja zakończyła się pomyślnie | Nie dotyczy |
| AZCM0001 | Wystąpił nieznany błąd | Skontaktuj się z pomocą techniczną firmy Microsoft w celu uzyskania wsparcia. |
| AZCM0011 | Użytkownik anulował akcję (CTRL+C) | Ponów próbę poprzedniego polecenia. |
| AZCM0012 | Token dostępu jest nieprawidłowy | W przypadku uwierzytelniania za pośrednictwem tokenu dostępu uzyskaj nowy token i spróbuj ponownie. W przypadku uwierzytelniania za pośrednictwem jednostki usługi lub identyfikatorów logowania urządzenia skontaktuj się z pomoc techniczna firmy Microsoft, aby uzyskać pomoc. |
| AZCM0016 | Brak obowiązkowego parametru | Przejrzyj komunikat o błędzie w danych wyjściowych, aby zidentyfikować brakujące parametry. Aby uzyskać pełną składnię polecenia, uruchom polecenie azcmagent <command> --help. |
| AZCM0018 | Polecenie zostało wykonane bez uprawnień administracyjnych | Ponów próbę polecenia w kontekście użytkownika z podwyższonym poziomem uprawnień (administrator/katalog główny). |
| AZCM0019 | Ścieżka do pliku konfiguracji jest niepoprawna | Upewnij się, że ścieżka do pliku konfiguracji jest poprawna i spróbuj ponownie. |
| AZCM0023 | Wartość podana dla parametru (argument) jest nieprawidłowa | Przejrzyj komunikat o błędzie, aby uzyskać bardziej szczegółowe informacje. Zapoznaj się ze składnią polecenia (azcmagent <command> --help) dla prawidłowych wartości lub oczekiwanego formatu argumentów. |
| AZCM0026 | W konfiguracji sieci występuje błąd lub niektóre krytyczne usługi są tymczasowo niedostępne | Sprawdź, czy wymagane punkty końcowe są osiągalne (na przykład nazwy hostów można rozpoznać, punkty końcowe nie są blokowane). Jeśli sieć jest skonfigurowana dla zakresu usługi Private Link, należy podać identyfikator zasobu zakresu usługi Private Link do dołączania przy użyciu parametru --private-link-scope . |
| AZCM0041 | Podane poświadczenia są nieprawidłowe | W przypadku logowań urządzeń sprawdź, czy określone konto użytkownika ma dostęp do dzierżawy i subskrypcji, w której zostanie utworzony zasób serwera. W przypadku identyfikatorów logowania jednostki usługi sprawdź identyfikator klienta i wpis tajny pod kątem poprawności, datę wygaśnięcia wpisu tajnego oraz czy jednostka usługi pochodzi z tej samej dzierżawy, w której zostanie utworzony zasób serwera. |
| AZCM0042 | Tworzenie zasobu serwera z obsługą usługi Azure Arc nie powiodło się | Przejrzyj komunikat o błędzie w danych wyjściowych, aby zidentyfikować przyczynę niepowodzenia utworzenia zasobu i sugerowane korygowanie. Aby uzyskać więcej informacji, zobacz Wymagania wstępne agenta połączonego maszyny wymagane uprawnienia , aby uzyskać więcej informacji. |
| AZCM0043 | Usunięcie zasobu serwera z obsługą usługi Azure Arc nie powiodło się | Sprawdź, czy określony użytkownik/jednostka usługi ma uprawnienia do usuwania serwera/zasobów z włączoną usługą Azure Arc w określonej grupie. Aby uzyskać więcej informacji, zobacz Connected Machine agent prerequisites-required permissions (Wymagane uprawnienia agenta połączonego komputera). Jeśli zasób nie istnieje już na platformie Azure, użyj flagi --force-local-only , aby kontynuować. |
| AZCM0044 | Zasób o tej samej nazwie już istnieje | Określ inną nazwę parametru --resource-name lub usuń istniejący serwer z obsługą usługi Azure Arc na platformie Azure i spróbuj ponownie. |
| AZCM0062 | Wystąpił błąd podczas nawiązywania połączenia z serwerem | Przejrzyj komunikat o błędzie w danych wyjściowych, aby uzyskać bardziej szczegółowe informacje. Jeśli po utworzeniu zasobu platformy Azure wystąpił błąd, usuń ten zasób przed ponowną próbą. |
| AZCM0063 | Wystąpił błąd podczas odłączania serwera | Przejrzyj komunikat o błędzie w danych wyjściowych, aby uzyskać bardziej szczegółowe informacje. Jeśli ten błąd będzie się powtarzać, usuń zasób na platformie Azure, a następnie uruchom azcmagent disconnect --force-local-only go na serwerze. |
| AZCM0067 | Maszyna jest już połączona z platformą Azure | Uruchom polecenie azcmagent disconnect , aby usunąć bieżące połączenie, a następnie spróbuj ponownie. |
| AZCM0068 | Podano nazwę subskrypcji i wystąpił błąd podczas wyszukiwania odpowiedniego identyfikatora GUID subskrypcji. | Ponów próbę polecenia za pomocą identyfikatora GUID subskrypcji zamiast nazwy subskrypcji. |
| AZCM0061 AZCM0064 AZCM0065 AZCM0066 AZCM0070 |
Usługa agenta nie odpowiada ani nie jest niedostępna | Sprawdź, czy polecenie jest uruchamiane w kontekście użytkownika z podwyższonym poziomem uprawnień (administrator/główny). Upewnij się, że usługa HIMDS jest uruchomiona (uruchom lub uruchom ponownie usługę HIMDS zgodnie z potrzebami), a następnie spróbuj ponownie wykonać polecenie. |
| AZCM0081 | Wystąpił błąd podczas pobierania certyfikatu tożsamości zarządzanej firmy Microsoft Entra | Jeśli ten komunikat zostanie napotkany podczas próby połączenia serwera z platformą Azure, agent nie będzie mógł komunikować się z usługą Azure Arc. Usuń zasób na platformie Azure i spróbuj ponownie nawiązać połączenie. |
| AZCM0101 | Polecenie nie zostało pomyślnie przeanalizowane | Uruchom polecenie azcmagent <command> --help , aby przejrzeć składnię polecenia. |
| AZCM0102 | Wystąpił błąd podczas pobierania nazwy hosta komputera | Spróbuj ponownie wykonać polecenie i określ nazwę zasobu (z parametrem --resource-name lub –n). Używaj tylko znaków alfanumerycznych, łączników i/lub podkreśleń; Należy pamiętać, że nazwa zasobu nie może kończyć się łącznikiem ani podkreślenia. |
| AZCM0103 | Wystąpił błąd podczas generowania kluczy RSA | Skontaktuj się z pomocą techniczną firmy Microsoft w celu uzyskania wsparcia. |
| AZCM0105 | Wystąpił błąd podczas pobierania zarządzanego certyfikatu identyfikacji identyfikatora entra firmy Microsoft | Usuń zasób utworzony na platformie Azure i spróbuj ponownie. |
| AZCM0147— AZCM0152 |
Wystąpił błąd podczas instalowania narzędzia Azcmagent w systemie Windows | Przejrzyj komunikat o błędzie w danych wyjściowych, aby uzyskać bardziej szczegółowe informacje. |
| AZCM0127- AZCM0146 |
Wystąpił błąd podczas instalowania narzędzia Azcmagent w systemie Linux | Przejrzyj komunikat o błędzie w danych wyjściowych, aby uzyskać bardziej szczegółowe informacje. |
| AZCM0150 | Błąd ogólny podczas instalacji | Prześlij bilet pomocy technicznej, aby uzyskać pomoc. |
| AZCM0153 | Platforma systemowa nie jest obsługiwana | Zapoznaj się z wymaganiami wstępnymi dotyczącymi obsługiwanych platform |
| AZCM0154 | Wersja programu PowerShell zainstalowana w systemie jest zbyt stara | Uaktualnij program PowerShell do wersji 4 lub nowszej i spróbuj ponownie. |
| AZCM0155 | Użytkownik z uruchomionym skryptem instalacji nie ma uprawnień administratora | Uruchom ponownie skrypt jako administrator. |
| AZCM0156 | Instalacja agenta nie powiodła się | Upewnij się, że maszyna nie jest uruchomiona na platformie Azure. Szczegółowe błędy można znaleźć w dzienniku instalacji pod adresem %TEMP%\installationlog.txt. |
| AZCM0157 | Nie można pobrać metadanych repozytorium oprogramowania microsoft Linux | Sprawdź, czy zapora blokuje dostęp i packages.microsoft.com spróbuj ponownie. |
Pełny dziennik agenta
Przed wykonaniem kroków rozwiązywania problemów opisanych w dalszej części tego artykułu potrzebne są minimalne informacje to pełny dziennik. Zawiera on dane wyjściowe poleceń narzędzia azcmagent , gdy jest używany pełny argument (-v). Pliki dziennika są zapisywane %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log w systemach Windows i Linux w systemie /var/opt/azcmagent/log/azcmagent.log.
Windows
Poniżej przedstawiono przykład polecenia umożliwiającego pełne rejestrowanie za pomocą agenta połączonej maszyny dla systemu Windows podczas przeprowadzania instalacji interaktywnej.
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose
Poniżej przedstawiono przykład polecenia umożliwiającego pełne rejestrowanie za pomocą agenta połączonej maszyny dla systemu Windows podczas przeprowadzania instalacji na dużą skalę przy użyciu jednostki usługi.
& "$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
Poniżej przedstawiono przykład polecenia umożliwiającego pełne rejestrowanie za pomocą agenta połączonej maszyny dla systemu Linux podczas przeprowadzania instalacji interaktywnej.
Uwaga
Aby uruchomić polecenie azcmagent, musisz mieć uprawnienia dostępu głównego na maszynach z systemem Linux.
azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose
Poniżej przedstawiono przykład polecenia umożliwiającego pełne rejestrowanie za pomocą agenta połączonej maszyny dla systemu Linux podczas przeprowadzania instalacji na dużą skalę przy użyciu jednostki usługi.
azcmagent connect \
--service-principal-id "{serviceprincipalAppID}" \
--service-principal-secret "{serviceprincipalPassword}" \
--resource-group "{ResourceGroupName}" \
--tenant-id "{tenantID}" \
--location "{resourceLocation}" \
--subscription-id "{subscriptionID}"
--verbose
Problemy z połączeniem agenta z usługą
W poniższej tabeli wymieniono niektóre znane błędy i sugestie dotyczące rozwiązywania problemów i ich rozwiązywania.
| Wiadomość | Błąd | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|---|
| Nie można uzyskać przepływu urządzenia tokenu autoryzacji | 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. |
Nie można uzyskać dostępu do login.windows.net punktu końcowego |
Uruchom polecenie azcmagent check , aby sprawdzić, czy zapora blokuje dostęp do identyfikatora Entra firmy Microsoft. |
| Nie można uzyskać przepływu urządzenia tokenu autoryzacji | 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. |
Serwer proxy lub zapora blokuje dostęp do login.windows.net punktu końcowego. |
Uruchom polecenie azcmagent check , aby sprawdzić, czy zapora blokuje dostęp do identyfikatora Entra firmy Microsoft. |
| Nie można uzyskać tokenu autoryzacji z głównej nazwy usługi | Failed to execute the refresh request. Error = 'Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/token?api-version=1.0: Forbidden' |
Serwer proxy lub zapora blokuje dostęp do login.windows.net punktu końcowego. |
Uruchom polecenie azcmagent check , aby sprawdzić, czy zapora blokuje dostęp do identyfikatora Entra firmy Microsoft. |
| Nie można uzyskać tokenu autoryzacji z głównej nazwy usługi | Invalid client secret is provided |
Nieprawidłowy lub nieprawidłowy wpis tajny jednostki usługi. | Sprawdź wpis tajny jednostki usługi. |
| Nie można uzyskać tokenu autoryzacji z głównej nazwy usługi | 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 |
Nieprawidłowa jednostka usługi i/lub identyfikator dzierżawy. | Sprawdź jednostkę usługi i/lub identyfikator dzierżawy. |
| Uzyskiwanie odpowiedzi na zasób usługi ARM | 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 |
Nieprawidłowe poświadczenia i/lub uprawnienia | Sprawdź, czy ty lub jednostka usługi jest członkiem roli dołączania maszyny połączonej platformy Azure. |
| Nie można nawiązać połączenia z zasobem ARM azcmagentConnect | The subscription isn't registered to use namespace 'Microsoft.HybridCompute' |
Dostawcy zasobów platformy Azure nie są zarejestrowani. | Zarejestruj dostawców zasobów. |
| Nie można nawiązać połączenia z zasobem ARM azcmagentConnect | 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 |
Serwer proxy lub zapora blokuje dostęp do management.azure.com punktu końcowego. |
Uruchom polecenie azcmagent check , aby sprawdzić, czy zapora blokuje dostęp do usługi Azure Resource Manager. |
Następne kroki
Jeśli w tym miejscu nie widzisz problemu lub nie możesz rozwiązać problemu, spróbuj wykonać jedną z następujących kanałów, aby uzyskać więcej pomocy technicznej:
Uzyskaj odpowiedzi od ekspertów platformy Azure za pośrednictwem pytań i odpowiedzi firmy Microsoft.
Połącz się z @AzureSupport oficjalnym kontem platformy Microsoft Azure, aby poprawić jakość obsługi klienta. Pomoc techniczna platformy Azure łączy społeczność platformy Azure z odpowiedziami, pomocą techniczną i ekspertami.
Zgłoś zdarzenie pomoc techniczna platformy Azure. Przejdź do witryny pomoc techniczna platformy Azure i wybierz pozycję Uzyskaj pomoc techniczną.