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.