Azure Bağlı Makine aracısı bağlantı sorunlarını giderme

Bu makalede, Azure Bağlı Makine aracısını Windows veya Linux için yapılandırırken oluşabilecek sorunları gidermeye yönelik bilgiler sağlanır. Hizmete bağlantı yapılandırırken hem etkileşimli hem de uygun ölçekte yükleme yöntemlerine yönelik ipuçları içerir.

Genel bilgi için bkz. Azure Arc özellikli sunuculara genel bakış, Azure Connected Machine aracıya genel bakış ve Bağlı Makine aracısını yönetme ve bakımını yapma.

Temsilci hata kodları

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. Konsol veya betik çıkışı hata kodunu görüntüler AZCM0000 ; burada "0000" dört basamaklı bir sayı olabilir.

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.
AZCM0002	Ajan içinde bir iç hata oluştu	HIMDS aracı hizmetini yeniden başlatın ve tekrar deneyin. Sorun devam ederse Microsoft Desteği'ne başvurun.
AZCM0003	İstenen işlem desteklenmiyor	Komutun işletim sisteminiz ve aracı sürümünüz için geçerli olduğunu doğrulayın.
AZCM0004	Azure Arc proxy hizmeti çalışmıyor	Karma Örnek Meta Veri Hizmeti'nin (HIMDS) çalıştığından emin olun ve yeniden deneyin.
AZCM0005	Kullanılabilir dosya günlükçü yok	Günlük dizininin mevcut olup olmadığını ve yeterli disk alanına ve izinlere sahip olup olmadığını denetleyin.
AZCM0006	Aracı başlatılamadı	Önkoşulları (ağ bağlantısı, izinler) denetleyin ve komutu yeniden çalıştırın.
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 ilkesi veya cihaz oturum açma bilgileri aracılığıyla kimlik doğrulaması yapıyorsanız, yardım için Microsoft Desteği'ne 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.
AZCM0020	Bilinmeyen bir bölge belirtildi	Yazım hataları için bölge adını denetleyin ve bölgenin desteklendiğinden emin olun.
AZCM0023	Parametre (bağımsız değişken) için sağlanan değer geçersiz	Hata iletisinde daha ayrıntılı bilgi olup olmadığını denetleyin. 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ı kontrol edin (örneğin, ana bilgisayar adları çözümlenebilir ve uç noktaların engellenmediğini). Ağ, Özel Bağlantı Kapsamı için yapılandırılmışsa, --private-link-scope parametresi kullanılarak ekleme yapılması için bir Özel Bağlantı Kapsamı kaynak kimliği sağlanmalıdır.
AZCM0027	Yapılandırma çakışması algılandı	Aracı yapılandırma dosyasında çakışan ayarları kaldırın ve yeniden deneyin.
AZCM0028	TPM cihazı açılamadı	Güvenilen Platform Modülü'nin (TPM) etkin ve erişilebilir olduğunu doğrulayın ve yeniden deneyin.
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 ve geçerli bir son kullanma tarihi açısından denetleyin ve hizmet sorumlusunun sunucu kaynağının oluşturulacağı kiracıdan olduğundan emin olun.
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. Gerekli izinler.
AZCM0043	Azure Arc özellikli sunucu kaynağının silinme işlemi başarısız oldu	Belirtilen kullanıcı veya hizmet sorumlusunun, belirtilen gruptaki Azure Arc etkin sunucuyu veya kaynakları silme izinlerine sahip olduğunu doğrulayın. Daha fazla bilgi için bkz. Gerekli izinler. Azure'de artık mevcut olmayan bir kaynak varsa, devam etmek için --force-local-only bayrağını 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.
AZCM0045	Yeniden bağlanmak için yeni ortak anahtarla hizmet güncelleştirilemedi	Ağ bağlantısını doğrulayın ve yeniden deneyin. Ayrıntılar için aracı günlüklerini gözden geçirin.
AZCM0061	Hizmet aracı yanıt vermiyor veya kullanım dışı.	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.
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 .
AZCM0064	Hizmet aracı yanıt vermiyor veya kullanım dışı.	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.
AZCM0065	Hizmet aracı yanıt vermiyor veya kullanım dışı.	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.
AZCM0066	Hizmet aracı yanıt vermiyor veya kullanım dışı.	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.
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.
AZCM0069	Yerel yapılandırma güncelleştirmesi tamamlanırken bir hata oluştu	Aracı yapılandırma dizini için dosya izinlerini denetleyin ve yeniden deneyin.
AZCM0070	Hizmet aracı yanıt vermiyor veya kullanım dışı.	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.
AZCM0072	Uzantı aracı çalıştırılırken hata oluştu	Ayrıntılar için uzantı günlüklerini gözden geçirin ve yeniden deneyin.
AZCM0073	İş ortağı yapılandırma özellikleri alınamıyor	İş ortağı entegrasyon ayarlarını doğrulayın ve yeniden deneyin.
AZCM0074	Uzantılar eklenirken bir hata oluştu	Uzantı paketinin geçerli olduğundan emin olun ve yeniden deneyin.
AZCM0075	Bulut yapılandırması alınamıyor	Gerekli Azure uç noktalarına bağlantıyı denetleyin ve yeniden deneyin.
AZCM0076	TPM tabanlı kimlik doğrulaması kullanılarak makine Azure’a bağlanamadı	Güvenilen Platform Modülü'nin (TPM) etkin ve erişilebilir olduğunu doğrulayın ve 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.
AZCM0082	TPM kullanılarak Karma Örnek Meta Veri Hizmeti'nden (HIMDS) yönetilen kimlik sertifikası alınamadı	HIMDS hizmetinin çalıştığından ve TPM'nin erişilebilir olduğundan emin olun ve yeniden deneyin.
AZCM0083	Arc kalıcı kimlik bilgisi hizmete kaydedilemedi	Ağ bağlantısını doğrulayın ve yeniden deneyin. Ayrıntılar için aracı günlüklerini gözden geçirin.
AZCM0101	Komut yürütülürken bir hata oluştu	Daha ayrıntılı bilgi için komut söz dizimini (azcmagent <command> --help) gözden geçirin ve aracı günlüklerini denetleyin.
AZCM0102	Bilgisayar host adı alınırken bir hata oluştu	Komutu yeniden deneyin ve bir kaynak adı belirtin (parametre --resource-name veya –n ile). 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	İmzalı ileti alınamadı	Azure Arc hizmetine ağ bağlantısını doğrulayın ve yeniden deneyin.
AZCM0107	Sertifika alınamadı	Sertifika deposunu doğrulayın ve yeniden deneyin.
AZCM0108	TPM anahtarları işlenemedi	Güvenilen Platform Modülü'nin (TPM) etkin ve erişilebilir olduğunu doğrulayın ve yeniden deneyin.
AZCM0130	Aracı systemd gerektirir, ancak systemctl komutu PATH'te bulunamadı (Linux).	Desteklenen bir dağıtımda systemd tabanlı bir başlatma sistemi kullanın.
AZCM0131	Linux dağıtımı yükleme sırasında belirlenemedi.	İşletim sisteminin desteklenen bir dağıtım olduğunu doğrulayın.
AZCM0132	İşlemci mimarisi veya platformu desteklenmez (Linux).	Desteklenen bir platform/mimari kullanın.
AZCM0133	Linux dağıtımı veya ARM64 değişkeni desteklenmez.	Desteklenen bir dağıtım ve mimari kullanın.
AZCM0141	Aracı bir Azure sanal makinesine (Linux) yüklenemez.	Azure VM'ler yerel olarak yönetilir; Bunlara Bağlı Makine aracısını yüklemeyin. Yalnızca test için bkz https://aka.ms/azcmagent-testwarning. .
AZCM0143	Paket yöneticisi (apt/dnf/zypper), azcmagent paketini (Linux) yükleyemedi.	Ayrıntılar için package-manager komut günlüklerini gözden geçirin ve yeniden deneyin.
AZCM0145	apt/dpkg kilidi 5 dakika sonra bile hâlâ tutuluyordu (Linux).	Başka bir apt/dpkg işleminin çalışmadığından emin olun ve yeniden deneyin.
AZCM0146	Microsoft paket deposu yapılandırması () (packages-microsoft-prodLinux) indirilemedi.	Güvenlik duvarının engelleyip engellemediğini packages.microsoft.com denetleyin ve yeniden deneyin.
AZCM0147	Linux'ta istenen --desiredversion bulunamadı; Windows aracı Azure bir sanal makineye yüklenemiyor.	Linux: Kullanılabilir bir sürüm belirtin. Windows: Azure VM'lere yüklemeyin (yalnızca test için bkzhttps://aka.ms/azcmagent-testwarning. ).
AZCM0148	Aracı yükleyicisi (.msi) (Windows) indirilemedi.	İndirme uç noktasına ağ, ara sunucu, güvenlik duvarı erişimini doğrulayın ve yeniden deneyin.
AZCM0149	Windows yükleyicisi (msiexec) beklenmeyen bir hata kodu döndürdü.	Yükleme günlüğünü ve bildirilen msiexec çıkış kodunu gözden geçirin ve sonra yeniden deneyin.
AZCM0150	Yükleme sırasında genel hata.	Yardım almak için bir destek bileti gönderin.
AZCM0151	Gerekli .NET Framework sürümü yüklü değil (Windows).	Gerekli .NET Framework sürümünü veya sonraki bir sürümünü yükleyin ve yeniden deneyin.
AZCM0152	Sunucu Azure Stack HCI (Windows) çalıştırıyor.	Yerleşik kayıt deneyimini kullanarak onu Azure Arc’a bağlayın: https://aka.ms/install-arc-on-hci-host
AZCM0153	İşletim sistemi mimarisi desteklenmez; aracı 64 bit (x64) işletim sistemi (Windows) gerektirir.	Desteklenen bir x64 işletim sistemine yükleyin.
AZCM0154	Yüklü PowerShell sürümü çok eski (Windows).	PowerShell 3.0 veya sonraki bir sürümüne yükseltin ve yeniden deneyin.
AZCM0155	Yükleme yönetici izinleriyle (Windows) çalıştırılamıyordu.	Yükleme betiğini yönetici olarak yeniden çalıştırın.
AZCM0156	MSI yüklemesi sırasında önemli bir hata oluştu (Windows; msiexec 1603).	Ayrıntılar için konumundaki %SystemRoot%\AzureConnectedMachineAgent\temp\installationlog.txt yükleme günlüğünü gözden geçirin ve yeniden deneyin.
AZCM0157	Yükleyici bir izin hatası (Linux) nedeniyle çalışamadı curl .	curl öğesinin yüklemeyi yapan kullanıcı tarafından yüklü ve yürütülebilir olduğundan emin olun, ardından yeniden deneyin.
AZCM0158	Yetersiz disk alanı (Windows; msiexec 112) nedeniyle yükleme başarısız oldu.	Diskte yer açın ve yeniden deneyin.
AZCM0159	Başka bir yükleme zaten devam ediyor (Windows; msiexec 1618).	Diğer yüklemenin tamamlanmasını bekleyin ve sonra yeniden deneyin.
AZCM0160	Yükleyici günlük dosyasını açamadı (Windows; msiexec 1622).	Günlük dizininin var olduğunu ve yazılabilir olduğunu doğrulayın ve sonra yeniden deneyin.
AZCM0171	Aracı MSI imza doğrulaması başarısız oldu (Windows).	Yükleyicinin orijinal, Microsoft imzalı paket olduğundan ve üzerinde oynanmadığından emin olun ve sonra yeniden deneyin.

Aracı çıkış kodları

Bağlı Makine Aracısı (azcmagent) komutlarını Azure çalıştırdığınızda, işlem bir çıkış koduyla sonlandırabilir. Bu kodlar işlemin sonucunu gösterir ve sorunların tanılanabilmesine yardımcı olur. Hata kodlarından farklı olarak, aracı işlemi çıktığında işletim sistemi çıkış kodlarını döndürür.

Çıkış Kodu	Description	Önerilen Düzeltme
0	Hata oluşmadi.	Eylem gerekmez.
1	Varsayılan hata.	Önkoşulların karşılandığından emin olun, aracı günlüklerini denetleyin ve yeniden deneyin.
2	Ajans içi hata.	Aracı hizmetini yeniden başlatın.
3	İşlem desteklenmiyor.	Komutun işletim sisteminiz ve aracı sürümünüz için geçerli olduğunu doğrulayın.
4	Arc proxy hizmeti çalışmıyor.	Hizmetin çalıştığından emin olun Hybrid Instance Metadata Service (himds) .
5	Dosya günlükçü kullanılamıyor.	Günlük dizini için disk alanını ve izinleri denetleyin.
6	Başlatma başarısız oldu.	Ağ ve izinler gibi önkoşulları denetleyin. Sorunları düzelttikkten sonra yeniden çalıştırın azcmagent connect .
11	İşlem kullanıcı tarafından kesildi (Ctrl+C).	Komutu kesintisiz olarak yeniden çalıştırın.
12	Geçersiz erişim belirteci sağlandı.	Azure kimlik bilgilerinizi az login kullanarak yenileyin veya geçerli bir belirteç sağlayın.
18	Yönetim ayrıcalıkları gerekli.	Komutu yükseltilmiş ayrıcalıklarla (sudo veya yükseltilmiş komut istemiyle) çalıştırın.
19	Yapılandırma dosyası bulunamadı.	Yapılandırma dosyası yolunu doğrulayın veya azcmagent config kullanarak yeniden oluşturun.
20	Bilinmeyen bölge belirtildi.	Bölge yazımını denetleyin ve bölgenin desteklendiğinden emin olun.
23	Geçersiz bağımsız değişkenler sağlandı.	komutunu kullanarak azcmagent --helpkomut söz dizimlerini gözden geçirin.
26	Ağ hatası oluştu.	Azure uç noktalarına bağlantıyı doğrulayın. Güvenlik duvarı ve ara sunucu ayarlarını denetleyin.
27	Yapılandırma çakışması algılandı.	/etc/azcmagent/config.json veya %ProgramData%\AzureConnectedMachineAgent\Config\localconfig.json içindeki çakışan ayarları kaldırın ve yeniden deneyin.
28	TPM cihazı açılamadı.	Güvenilen Platform Modülü'nin (TPM) etkin ve erişilebilir olduğunu doğrulayın, sonra yeniden deneyin.
41	Erişim belirteci alınamadı.	az login başarılı olduğundan ve geçerliyse MSI'nin etkinleştirildiğinden emin olun.
42	Azure kaynağı oluşturulamadı.	Abonelik izinlerini ve kaynak kotalarını denetleyin.
43	Azure kaynağı silinemedi.	Kaynağın var olduğunu ve silme izinlerinizin olduğunu doğrulayın.
44	Kaynak zaten var.	parametresi için --resource-name farklı bir ad belirtin veya mevcut Azure Arc etkin sunucu kaynağını silin ve yeniden çalıştırınazcmagent connect.
45	Yeniden bağlanacak ortak anahtar güncellenemedi.	Ağ bağlantısını ve aracı günlüklerini doğruladıktan sonra yeniden deneyin.
61	Aracı iletişim hatası.	Himds hizmetini yeniden başlatın.
62	Makine Azure'a bağlanamadı.	Ağ bağlantısı ve abonelik izinlerini denetleyin.
63	Makinenin Azure bağlantısı kesilemedi.	Makinenin çevrimiçi olduğundan ve aracının iyi durumda olduğundan emin olduktan sonra yeniden deneyin.
64	HIMDS sunucusuyla iletişim kurulamıyor.	Hizmeti himds yeniden başlatın ve günlükleri doğrulayın.
65	Aracı meta verileri alınamıyor.	Aracı günlüklerini denetleyin ve yeniden deneyin.
66	Ajan durumu alınamıyor.	Aracıyı yeniden başlatın ve bağlantıyı doğrulayın.
67	Makine zaten bağlı.	Geçerli bağlantıyı kaldırmak için komutunu çalıştırın azcmagent disconnect , ardından komutunu yeniden çalıştırın azcmagent connect.
68	Abonelik kimliği getirilemiyor.	Azure kimlik bilgilerini doğrulayın ve yeniden deneyin.
69	Yerel yapılandırma güncelleştirilirken hata oluştu.	Dosya izinlerini denetleyin ve yeniden deneyin.
70	Yerel yapılandırma alınamıyor.	Yapılandırma dosyası bütünlüğünü doğrulayın ve yeniden deneyin.
72	Uzantı aracı çalıştırılırken hata oluştu.	Uzantı günlüklerini denetleyin ve yeniden deneyin.
73	İş ortağı yapılandırması alınamıyor.	İş ortağı tümleştirme ayarlarını doğrulayın.
74	Uzantı ekleme hatası.	Uzantı paketinin geçerli olduğundan emin olun ve yeniden deneyin.
75	Bulut yapılandırması alınamıyor.	Azure uç noktalarına bağlantıyı denetleyin.
76	Makine, TPM tabanlı kimlik doğrulaması kullanılarak Azure'a bağlanamadı.	TPM'nin etkin ve erişilebilir olduğunu doğrulayın ve yeniden deneyin.
81	HIS'den MSI sertifikası alınamadı.	HIS hizmetinin çalıştığından emin olun ve yeniden deneyin.
82	TPM kullanılarak HIS'den MSI sertifikası alınamadı.	HIS hizmetinin çalıştığından ve TPM'nin erişilebilir olduğundan emin olun ve yeniden deneyin.
83	Arc kalıcı kimlik bilgileri hizmete kaydedilemedi.	Ağ bağlantısını doğrulayın ve yeniden deneyin.
101	Komut yürütme hatası.	Komut söz dizimlerini doğrulayın ve ayrıntılar için günlükleri denetleyin.
102	Kaynak adı oluşturulamıyor.	Azure adlandırma gereksinimlerini karşıladığından emin olun.
103	RSA anahtarları işlenemedi.	Yardım için Microsoft Desteği'ne başvurun.
104	Özel anahtar alınamadı.	Anahtar depolamayı doğrulayın ve yeniden deneyin.
105	İmzalı ileti alınamadı.	Bağlantıyı denetleyin ve yeniden deneyin.
106	Parametre dosyası kaydedilemedi.	Disk alanını ve izinleri doğrulayın.
107	Sertifika alınamadı.	Sertifika deposunu doğrulayın ve yeniden deneyin.
108	TPM anahtarları işlenemedi.	TPM'nin etkin ve erişilebilir olduğunu doğrulayın ve yeniden deneyin.

Ayrıntılı aracı günlüğü

Bu makalenin devamında açıklanan sorun giderme adımlarını izlemek için ayrıntılı günlüğe ihtiyacınız vardır. Bu günlük, ayrıntılı () argümanını kullandığınızda -v aracının komutlarının çıktısı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ğıdaki komut, etkileşimli kurulum sırasında Windows için Bağlı Makine aracısını kullanarak ayrıntılı günlük kaydını etkinleştirmenin bir örneğidir.

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

Aşağıdaki komut, hizmet sorumlusu hesabı kullanarak geniş ölçekte bir yükleme gerçekleştirirken Windows için Bağlı Makine aracısı ile ayrıntılı günlük kaydını etkinleştiren bir örnektir.

& "$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ğıdaki komut, etkileşimli bir yükleme sırasında Linux için Connected Machine aracısını kullanarak ayrıntılı günlük kaydını etkinleştiren bir örnektir.

Uyarı

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ğıdaki komut, hizmet sorumlusu hesabı kullanarak geniş ölçekte kurulum gerçekleştirirken Linux için Bağlı Makine aracısı ile ayrıntılı günlük kaydını etkinleştiren bir örnektir.

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, çeşitli hataların ve bunların nasıl giderilip çözüleceğini gösteren öneriler listelenmektedir.

Hata	Olası neden	Çözüm
Yetkilendirme belirteci cihaz akışı işlemi başarısız oldu. 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 komutunu çalıştırın azcmagent check .
Yetkilendirme belirteci cihaz akışı işlemi başarısız oldu. 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 komutunu çalıştırın azcmagent check .
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 komutunu çalıştırın azcmagent check .
SPN'den yetkilendirme belirteci alınamadı: Invalid client secret is provided	Yanlış veya geçersiz hizmet sorumlusu parolası.	Hizmet asıl gizli anahtarını 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 temsilcisi ve/veya Kiracı Kimliği.	Hizmet sorumlusunu ve/veya kiracı kimliğini doğrulayın.
ARM Kaynak Yanıtını Al: 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	Proxy sunucu veya güvenlik duvarı management.azure.com uç noktasına erişimi engelliyor.	Bir güvenlik duvarının Azure Resource Manager'a erişimi engelleyip engellemediğini görmek için komutunu çalıştırın azcmagent check .

Sonraki adımlar

Sorununuzu burada görmüyorsanız veya sorununuzu çözemiyorsanız destek için aşağıdaki kanallardan birini deneyin:

• Microsoft Soru-Cevap aracılığıyla Azure uzmanlarından yanıt alın.
• Yardım almak için bir destek isteği açın. Daha fazla bilgi için bkz. Azure destek isteği oluşturma.