Azure Bağlı Makine aracısında bağlantı sorunlarını giderme
Bu makalede, Windows veya Linux için Azure Connected Machine aracısını yapılandırırken oluşabilecek sorunları gidermeye yönelik bilgiler sağlanır. Hizmete bağlantı yapılandırılırken hem etkileşimli hem de uygun ölçekte yükleme yöntemleri dahil edilir. Genel bilgi için bkz . Azure Arc özellikli sunuculara genel bakış.
Aracı hata kodları
Konsola veya betik çıkışına yazdırılan ("0000" dört basamaklı bir sayı olabilir) hata kodunu kullanarak AZCM0000 Azure Bağlı Makine aracısını yapılandırırken karşılaşılan sorunları belirlemek ve çözmek için aşağıdaki tabloyu kullanın.
| Hata kodu | Olası neden | Önerilen düzeltme |
|---|---|---|
| AZCM0000 | Eylem başarılı oldu | Yok |
| AZCM0001 | Bilinmeyen bir hata oluştu | Yardım için Microsoft Desteği'ne başvurun. |
| AZCM0011 | Kullanıcı eylemi iptal etti (CTRL+C) | Önceki komutu yeniden deneyin. |
| AZCM0012 | Erişim belirteci geçersiz | Erişim belirteci aracılığıyla kimlik doğrulaması gerçekleştiriliyorsa yeni bir belirteç alın ve yeniden deneyin. Hizmet sorumlusu veya cihaz oturum açma bilgileri aracılığıyla kimlik doğrulaması yaparsanız yardım için Microsoft Desteği başvurun. |
| AZCM0016 | Zorunlu parametre eksik | Hangi parametrelerin eksik olduğunu belirlemek için çıktıdaki hata iletisini gözden geçirin. Komutun tam söz dizimi için komutunu çalıştırın azcmagent <command> --help. |
| AZCM0018 | Komut yönetici ayrıcalıkları olmadan yürütüldü | Komutu yükseltilmiş bir kullanıcı bağlamında (yönetici/kök) yeniden deneyin. |
| AZCM0019 | Yapılandırma dosyasının yolu yanlış | Yapılandırma dosyasının yolunun doğru olduğundan emin olun ve yeniden deneyin. |
| AZCM0023 | Parametre (bağımsız değişken) için sağlanan değer geçersiz | Daha ayrıntılı bilgi için hata iletisini gözden geçirin. Geçerli değerler için komutun (azcmagent <command> --help) söz dizimine veya bağımsız değişkenler için beklenen biçime bakın. |
| AZCM0026 | Ağ yapılandırmasında bir hata var veya bazı kritik hizmetler geçici olarak kullanılamıyor | Gerekli uç noktaların erişilebilir olup olmadığını denetleyin (örneğin, konak adları çözümlenebilir, uç noktalar engellenmez). Ağ Özel Bağlantı Kapsamı için yapılandırılmışsa, parametresi kullanılarak --private-link-scope ekleme için bir Özel Bağlantı Kapsamı kaynak kimliği sağlanmalıdır. |
| AZCM0041 | Sağlanan kimlik bilgileri geçersiz | Cihaz oturum açma işlemleri için, belirtilen kullanıcı hesabının sunucu kaynağının oluşturulacağı kiracıya ve aboneliğe erişimi olduğunu doğrulayın. Hizmet sorumlusu oturum açma işlemleri için istemci kimliğini ve gizli diziyi doğru olup olmadığını, gizli dizinin son kullanma tarihini ve hizmet sorumlusunun sunucu kaynağının oluşturulacağı kiracıdan olduğunu denetleyin. |
| AZCM0042 | Azure Arc özellikli sunucu kaynağı oluşturulamadı | Kaynak oluşturma hatasının nedenini ve önerilen düzeltmeyi belirlemek için çıktıdaki hata iletisini gözden geçirin. Daha fazla bilgi için bkz . Bağlı Makine aracısı önkoşulları için gerekli izinler . |
| AZCM0043 | Azure Arc özellikli sunucu kaynağı silinemedi | Belirtilen kullanıcı/hizmet sorumlusunun belirtilen gruptaki Azure Arc özellikli sunucuyu/kaynakları silme izinlerine sahip olduğunu doğrulayın. Daha fazla bilgi için bkz . Bağlı Makine aracısı önkoşulları için gerekli izinler. Kaynak artık Azure'da yoksa devam etmek için bayrağını --force-local-only kullanın. |
| AZCM0044 | Aynı ada sahip bir kaynak zaten var | Parametre için --resource-name farklı bir ad belirtin veya Azure'da mevcut Azure Arc özellikli sunucuyu silin ve yeniden deneyin. |
| AZCM0062 | Sunucu bağlanırken bir hata oluştu | Daha ayrıntılı bilgi için çıktıdaki hata iletisini gözden geçirin. Azure kaynağı oluşturulduktan sonra hata oluştuysa, yeniden denemeden önce bu kaynağı silin. |
| AZCM0063 | Sunucunun bağlantısı kesilirken bir hata oluştu | Daha ayrıntılı bilgi için çıktıdaki hata iletisini gözden geçirin. Bu hata devam ederse Azure'daki kaynağı silin ve sunucuda çalıştırın azcmagent disconnect --force-local-only . |
| AZCM0067 | Makine zaten Azure'a bağlı | Geçerli bağlantıyı kaldırmak için komutunu çalıştırın azcmagent disconnect ve yeniden deneyin. |
| AZCM0068 | Abonelik adı sağlandı ve ilgili abonelik GUID'sine bakılırken bir hata oluştu. | Komutu abonelik adı yerine abonelik GUID'siyle yeniden deneyin. |
| AZCM0061 AZCM0064 AZCM0065 AZCM0066 AZCM0070 |
Aracı hizmeti yanıt vermiyor veya kullanılamıyor | Komutun yükseltilmiş bir kullanıcı bağlamında (yönetici/kök) çalıştırıldığından emin olun. HIMDS hizmetinin çalıştığından emin olun (gerektiğinde HIMDS'yi başlatın veya yeniden başlatın) ardından komutu yeniden deneyin. |
| AZCM0081 | Microsoft Entra yönetilen kimlik sertifikası indirilirken bir hata oluştu | Sunucuyu Azure'a bağlamaya çalışırken bu iletiyle karşılaşılırsa aracı Azure Arc hizmetiyle iletişim kuramaz. Azure'da kaynağı silin ve yeniden bağlanmayı deneyin. |
| AZCM0101 | Komut başarıyla ayrıştırılamıyor | Komutunu çalıştırarak azcmagent <command> --help komut söz dizimini gözden geçirin. |
| AZCM0102 | Bilgisayar ana bilgisayar adı alınırken bir hata oluştu | komutunu yeniden deneyin ve bir kaynak adı belirtin (--resource-name veya –n parametresiyle). Yalnızca alfasayısal karakterler, kısa çizgiler ve/veya alt çizgi kullanın; Kaynak adının kısa çizgi veya alt çizgiyle bitemeceğini unutmayın. |
| AZCM0103 | RSA anahtarları oluşturulurken bir hata oluştu | Yardım için Microsoft Desteği'ne başvurun. |
| AZCM0105 | Microsoft Entra Id yönetilen tanımlama sertifikası indirilirken bir hata oluştu | Azure'da oluşturulan kaynağı silin ve yeniden deneyin. |
| AZCM0147- AZCM0152 |
Windows'a Azcmagent yüklenirken bir hata oluştu | Daha ayrıntılı bilgi için çıktıdaki hata iletisini gözden geçirin. |
| AZCM0127- AZCM0146 |
Linux'a Azcmagent yüklenirken bir hata oluştu | Daha ayrıntılı bilgi için çıktıdaki hata iletisini gözden geçirin. |
| AZCM0150 | Yükleme sırasında genel hata | Yardım almak için bir destek bileti gönderin. |
| AZCM0153 | Sistem platformu desteklenmiyor | Desteklenen platformlar için önkoşulları gözden geçirin |
| AZCM0154 | Sistemde yüklü PowerShell sürümü çok eski | PowerShell 4 veya sonraki bir sürüme yükseltin ve yeniden deneyin. |
| AZCM0155 | Yükleme betiğini çalıştıran kullanıcının yönetici izinleri yok | Betiği yönetici olarak yeniden çalıştırın. |
| AZCM0156 | Aracı yüklenemedi | Makinenin Azure'da çalışmadığını onaylayın. Ayrıntılı hatalar konumundaki %TEMP%\installationlog.txtyükleme günlüğünde bulunabilir. |
| AZCM0157 | Microsoft Linux yazılım deposu için depo meta verileri indirilemiyor | Güvenlik duvarının erişimi packages.microsoft.com engelleyip engellemediğini denetleyin ve yeniden deneyin. |
Aracı ayrıntılı günlüğü
Bu makalenin devamında açıklanan sorun giderme adımlarını izlemeden önce, ihtiyacınız olan en düşük bilgiler ayrıntılı günlük olacaktır. Ayrıntılı (-v) bağımsız değişkeni kullanıldığında azcmagent araç komutlarının çıkışını içerir. Günlük dosyaları Windows için, %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log Linux ise öğesine /var/opt/azcmagent/log/azcmagent.logyazılır.
Windows
Aşağıda, etkileşimli bir yükleme gerçekleştirirken Windows için Connected Machine aracısıyla ayrıntılı günlük kaydını etkinleştirmeye yönelik bir komut örneği verilmiştir.
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose
Aşağıda, hizmet sorumlusu kullanarak ölçekli bir yükleme gerçekleştirirken Windows için Connected Machine aracısı ile ayrıntılı günlük kaydını etkinleştirmeye yönelik bir komut örneği verilmiştir.
& "$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
Aşağıda, etkileşimli bir yükleme gerçekleştirirken Linux için Connected Machine aracısı ile ayrıntılı günlüğe kaydetmeyi etkinleştirme komutunun bir örneği verilmiştir.
Not
azcmagent'ı çalıştırmak için Linux makinelerinde kök erişim izinlerine sahip olmanız gerekir.
azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose
Aşağıda, hizmet sorumlusu kullanarak ölçekli bir yükleme gerçekleştirirken Linux için Bağlı Makine aracısı ile ayrıntılı günlüğe kaydetmeyi etkinleştirme komutunun bir örneği verilmiştir.
azcmagent connect \
--service-principal-id "{serviceprincipalAppID}" \
--service-principal-secret "{serviceprincipalPassword}" \
--resource-group "{ResourceGroupName}" \
--tenant-id "{tenantID}" \
--location "{resourceLocation}" \
--subscription-id "{subscriptionID}"
--verbose
Hizmete aracı bağlantısı sorunları
Aşağıdaki tabloda, bazı bilinen hataların ve bunların nasıl giderilip çözüleceğini gösteren öneriler listelenmektedir.
| İleti | Hata | Olası neden | Çözüm |
|---|---|---|---|
| Yetkilendirme belirteci cihaz akışı alınamadı | 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. |
Uç noktaya ulaşılamıyor login.windows.net |
Bir güvenlik duvarının Microsoft Entra Id'ye erişimi engelleyip engellemediğini görmek için azcmagent check komutunu çalıştırın. |
| Yetkilendirme belirteci cihaz akışı alınamadı | 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. |
Ara sunucu veya güvenlik duvarı uç noktaya erişimi login.windows.net engelliyor. |
Bir güvenlik duvarının Microsoft Entra Id'ye erişimi engelleyip engellemediğini görmek için azcmagent check komutunu çalıştırın. |
| SPN'den yetkilendirme belirteci alınamadı | Failed to execute the refresh request. Error = 'Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/token?api-version=1.0: Forbidden' |
Ara sunucu veya güvenlik duvarı uç noktaya erişimi login.windows.net engelliyor. |
Bir güvenlik duvarının Microsoft Entra Id'ye erişimi engelleyip engellemediğini görmek için azcmagent check komutunu çalıştırın. |
| SPN'den yetkilendirme belirteci alınamadı | Invalid client secret is provided |
Yanlış veya geçersiz hizmet sorumlusu gizli dizisi. | Hizmet sorumlusu gizli dizisini doğrulayın. |
| SPN'den yetkilendirme belirteci alınamadı | 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 |
Yanlış hizmet sorumlusu ve/veya Kiracı Kimliği. | Hizmet sorumlusunu ve/veya kiracı kimliğini doğrulayın. |
| ARM Kaynak Yanıtı Alma | 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 |
Yanlış kimlik bilgileri ve/veya izinler | Sizin veya hizmet sorumlusunun Azure Bağlı Makine Ekleme rolünün bir üyesi olduğunuzu doğrulayın. |
| AzcmagentConnect ARM kaynağı başarısız oldu | The subscription isn't registered to use namespace 'Microsoft.HybridCompute' |
Azure kaynak sağlayıcıları kaydedilmez. | Kaynak sağlayıcılarını kaydedin. |
| AzcmagentConnect ARM kaynağı başarısız oldu | 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 |
Ara sunucu veya güvenlik duvarı uç noktaya erişimi management.azure.com engelliyor. |
Güvenlik duvarının Azure Resource Manager'a erişimi engelleyip engellemediğini görmek için azcmagent check komutunu çalıştırın. |
Sonraki adımlar
Sorununuzu burada görmüyorsanız veya sorununuzu çözemiyorsanız daha fazla destek için aşağıdaki kanallardan birini deneyin:
Microsoft Soru-Cevap aracılığıyla Azure uzmanlarından yanıt alın.
Müşteri deneyimini geliştirmeye yönelik resmi Microsoft Azure hesabı @AzureSupport ile bağlantı kurun. Azure Desteği, Azure topluluğunun yanıtlara, desteğe ve uzmanlara bağlanmasını sağlar.
bir Azure desteği olayı dosyala. Azure desteği sitesine gidin ve Destek Al'ı seçin.