Cihaz gruplarını yönetme
Önemli
Bu, Azure Sphere (Eski) belgeleridir. Azure Sphere (Eski) 27 Eylül 2027'de kullanımdan kaldırılıyor ve kullanıcıların bu zamana kadar Azure Sphere'e (Tümleşik) geçmeleri gerekiyor. Azure Sphere (Tümleşik) belgelerini görüntülemek için İçindekiler tablosu üzerinde bulunan Sürüm seçiciyi kullanın.
Bu konu başlığında, CLI veya Azure Sphere Gezgini'ni kullanarak cihaz gruplarınızın nasıl yönetileceğinin belgeleri yer almaktadır. Bu konudaki adımlarda Azure Sphere kiracıları, ürünleri ve cihaz grupları kavramları hakkında bilgi sahibi olduğunuz varsayılır.
Cihaz gruplarını listeleme
Azsphere device-group list komutunu veya Cihaz Grubu - Liste API'sini kullanarak Azure Sphere kiracınızdaki tüm cihaz gruplarını listeleyin.
Tüm cihaz gruplarını listelemek için:
azsphere device-group list
Azsphere product device-group list komutunu veya Product - List Groups API'sini kullanarak belirli bir üründeki cihaz gruplarını listeleyin.
azsphere product device-group list --product <product-name>
İlgilendiğiniz kiracı için Kiracı düğümünü genişletin.
İlgilendiğiniz kiracı için Kiracı düğümünü genişletin.
Kiracının ürünlerini ve cihaz gruplarını görüntülemek için:
İlgilendiğiniz kiracı için Kiracı düğümünü genişletin.
Listede ürün yoksa bir ürün oluşturun.
Cihaz zaten bir ürünle ilişkiliyse ve bir gruba atanmışsa, cihaz grubunu istediğiniz zaman güncelleştirebilirsiniz.
Kiracının ürünlerini ve cihaz gruplarını görüntülemek için:
İlgilendiğiniz kiracı için Kiracı düğümünü genişletin.
Listede ürün yoksa bir ürün oluşturun.
Cihaz zaten bir ürünle ilişkiliyse ve bir gruba atanmışsa, cihaz grubunu istediğiniz zaman güncelleştirebilirsiniz.
Cihaz grubu oluşturma
azsphere device-group create komutunu veya Cihaz Grubu - Oluşturma API'sini kullanarak bir cihaz grubu oluşturun.
Cihaz grubu oluşturmak için:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Cihaz gruplarının adları yalnızca alfasayısal karakterler ve boşluklar içerebilir. 50 karakteri aşamaz. Ad veya açıklama boşluk içeriyorsa, tırnak içine alın.
Aşağıdaki isteğe bağlı parametreleri ekleyebilirsiniz:
--os-feed
işletim sistemi güncelleştirmeleri için kullanılacak işletim sistemi akışı türünü belirtir.--application-update
bu cihaz grubu için uygulama güncelleştirmeleri ilkesini ayarlar.
İlgilendiğiniz kiracı için Ürün düğümünü genişletin.
İlgilendiğiniz ürün için sağ tıklayın ve Yeni Cihaz Grubu'na tıklayın.
Cihaz grubu için bir ad belirtin ve Enter tuşuna basın. Cihaz gruplarının adları yalnızca alfasayısal karakterler ve boşluklar içerebilir. 50 karakteri aşamaz. Geçersiz bir ad belirtirseniz, Çıkış penceresinde bir hata bildirilir.
Visual Studio Code'da bir cihaz grubu oluşturabilir, ancak silemezsiniz. Bir cihaz grubunu silmek için azsphere device-group delete komutunu veya Azure Sphere Genel API'sini kullanın.
İlgilendiğiniz kiracı için Ürün düğümünü genişletin.
İlgilendiğiniz ürün için sağ tıklayın ve Yeni Cihaz Grubu'na tıklayın.
Cihaz grubu için bir ad belirtin ve Enter tuşuna basın veya Uygula'ya tıklayın. Cihaz gruplarının adları yalnızca alfasayısal karakterler ve boşluklar içerebilir. 50 karakteri aşamaz. Geçersiz bir ad belirtirseniz, Çıkış penceresinde bir hata bildirilir.
Visual Studio'da bir cihaz grubu oluşturabilir, ancak silemezsiniz. Ürünleri silmek için azsphere device-group delete komutunu veya Azure Sphere Genel API'sini kullanın.
Cihaz grubunu güncelleştirme
Azsphere device-group update komutunu veya Cihaz Grubu - Yama API'sini kullanarak bir cihaz grubunun adını veya açıklamasını değiştirebilirsiniz.
Cihaz grubunun adını ve açıklamasını güncelleştirmek için:
azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>
azsphere device-group update os-feed
komutunu kullanarak ve application-update
parametrelerini de güncelleştirebilirsiniz.
İlgilendiğiniz kiracı için Ürün düğümünü genişletin.
İlgilendiğiniz ürün için ürün düğümünü genişleterek dahil edilen cihaz gruplarını gösterin. Cihaz grubunu yeniden adlandırabilir veya açıklamasını, işletim sistemi akış türünü veya güncelleştirme ilkesini güncelleştirebilirsiniz:
Bir cihaz grubunu yeniden adlandırmak için, cihaz grubu adına sağ tıklayın ve Yeniden Adlandır'ı seçin, yeni bir ad yazın ve Enter tuşuna basın. Cihaz gruplarının adları yalnızca alfasayısal karakterler ve boşluklar içerebilir. 50 karakteri aşamaz. Geçersiz bir ad belirtirseniz, Çıkış penceresinde bir hata bildirilir.
Cihaz grubunun açıklamasını güncelleştirmek için, cihaz grubu adına sağ tıklayın ve Açıklamayı Güncelleştir'i seçin, yeni bir açıklama yazın ve Enter tuşuna basın.
İşletim sistemi akışı türünü güncelleştirmek için cihaz grubunu genişletin, işletim sistemi akışı türü'ne sağ tıklayın, Güncelleştir'i seçin ve ardından menüden Perakende veya PerakendeEval'ı seçin.
Güncelleştirme ilkesini değiştirmek için cihaz grubunu genişletin, İlkeyi güncelleştir'e sağ tıklayın, Güncelleştir'i seçin ve ardından menüden No3rdPartyAppUpdates veya UpdateAll'ı seçin. (Üçüncü seçenek, NoUpdates, şu anda iç kullanım için ayrılmıştır. Bu seçeneği belirlerseniz, Çıkış penceresinde bir hata bildirilir.)
azsphere device update komutunu veya Cihazlar - Taşıma API'sini kullanarak bir cihazı farklı bir cihaz grubuna taşıyın.
İlgilendiğiniz kiracı için Ürün düğümünü genişletin.
İlgilendiğiniz ürün için ürün düğümünü genişleterek dahil edilen cihaz gruplarını gösterin. Cihaz grubunu yeniden adlandırabilir veya açıklamasını, işletim sistemi akış türünü veya güncelleştirme ilkesini güncelleştirebilirsiniz:
Bir cihaz grubunu yeniden adlandırmak için, cihaz grubu adını seçin ve F2 tuşuna basın veya cihaz grubu adına sağ tıklayın ve Yeniden Adlandır'ı seçin, yeni bir ad yazın ve enter tuşuna basın veya Uygula'ya tıklayın. Cihaz gruplarının adları yalnızca alfasayısal karakterler ve boşluklar içerebilir. 50 karakteri aşamaz. Geçersiz bir ad belirtirseniz, Çıkış penceresinde bir hata bildirilir.
Cihaz grubunun açıklamasını güncelleştirmek için cihaz grubunu genişletin, Açıklama'yı seçin ve F2 tuşuna basın veya Açıklama'ya sağ tıklayın ve Değiştir'i seçin, yeni bir açıklama yazın ve enter tuşuna basın veya Uygula'ya tıklayın.
İşletim sistemi akışı türünü güncelleştirmek için cihaz grubunu genişletin, işletim sistemi akışı türünü seçin ve F2 tuşuna basın veya işletim sistemi akışı türü'ne sağ tıklayın ve Değiştir'i seçin, menüden Perakende veya PerakendeEval'ı seçin ve enter tuşuna basın veya Uygula'ya tıklayın.
Güncelleştirme ilkesini değiştirmek için cihaz grubunu genişletin, İlkeyi güncelleştir'i seçin ve F2 tuşuna basın veya İlkeyi güncelleştir'e sağ tıklayın ve Değiştir'i seçin, menüden No3rdPartyAppUpdates veya UpdateAll'ı seçin ve ardından Enter tuşuna basın veya Uygula'ya tıklayın. (Üçüncü seçenek, NoUpdates, şu anda iç kullanım için ayrılmıştır. Bu seçeneği belirlerseniz, Çıkış penceresinde bir hata bildirilir).
azsphere device update komutunu veya Cihazlar - Taşıma API'sini kullanarak bir cihazı farklı bir cihaz grubuna taşıyın.
Cihazı farklı bir cihaz grubuna taşıma
azsphere device update komutunu veya Cihazlar - Taşıma API'sini kullanarak bir cihazı farklı bir cihaz grubuna taşıyın.
Cihaz grubu kimliğini veya ürün adı ile cihaz grubu adının <bir bileşimini ürün-adı>/<cihaz-grubu-adı> biçiminde belirtin:
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
Cihaz grubunu silme
Azsphere device-group delete komutunu veya Cihaz Grubu - Silme API'sini kullanarak Azure Sphere kiracınızda belirtilen cihaz grubunu silin.
Cihaz grubu yalnızca şu durumlarda silinebilir:
- Kullanıcının kiracıda yönetici izinleri vardır.
- Cihaz grubu boş ve içinde cihaz yok. azsphere device-group device list komutu, bir cihaz grubundaki tüm cihazları listeler. Cihazı farklı bir cihaz grubuna taşımak için azsphere device update --device-group komutunu çalıştırın.
Cihaz grubu kimliğini veya ürün adı ile cihaz grubu adının <bir bileşimini ürün-adı>/<cihaz-grubu-adı> biçiminde belirtin:
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>