Azure Sphere CLI'ya genel bakış
Azure Sphere CLI, Azure Sphere kaynaklarınızı yönetmek için kullanılan bir komut kümesidir.
Aşağıdaki komutlar kullanılabilir:
- ca-certificate
- Aygıt
- device-group
- Geribildirim
- get-support-data
- donanım tanımı
- Görüntü
- image-package
- interactive (Komut önizlemede)
- Oturum açma
- Oturum kapatma
- Ürün
- register-user
- Rolü
- show-user
- show-version
- Ayarı
- Kiracı
Azure Sphere CLI ve Azure Sphere klasik CLI
Azure Sphere CLI, hem Windows hem de Linux'ta mevcut CLI ile birlikte yüklenir, bu nedenle her iki arabirime de erişebilirsiniz. Azure Sphere klasik CLI her zaman olduğu gibi çalışmaya devam eder.
Azure Sphere CLI'yi kullanmak için:
- Windows'da PowerShell veya standart bir Windows Komut İstemi kullanın.
- Linux'ta herhangi bir komut kabuğunu kullanın. SDK yüklemesi sırasında Azure Sphere CLI'yi varsayılan olarak ayarlarsanız azsphere komutunu veya Azure Sphere klasik CLI'sini varsayılan olarak ayarladıysanız azsphere_v2 komutunu belirtin.
Azure Sphere CLI tarafından desteklenen özellikler ve komutlar hakkında ayrıntılı bilgi için bkz. Azure Sphere CLI.
Önemli
- Windows'ta, kullanımdan kaldırılacak Azure Sphere Klasik Geliştirici Komut İstemi kısayolu yalnızca Azure Sphere klasik CLI ile kullanılabilir.
Komut satırı biçimi
azsphere komut satırı aşağıdaki biçime sahiptir:
azsphere [command] [subcommand] operation [parameters]
Genel olarak, komut ve alt komut isimdir ve işlem bir fiildir, böylece birleşim hem eylemi hem de eylemin nesnesini tanımlar. Çoğu komut ve işlemin hem tam adı hem de kısaltması vardır. Örneğin , cihaz komutu d olarak kısaltılır.
Çoğu parametrenin hem uzun adı hem de kısaltması vardır. Komut satırında, iki kısa çizgi içeren uzun adı ve tek bir kısa çizgiyle kısaltmayı ekleyin. Örneğin, aşağıdaki iki komut eşdeğerdir:
azsphere device wifi add --ssid MyNetwork --psk mynetworkkey
azsphere device wifi add -s MyNetwork -p mynetworkkey
Bazı komutlar tek bir parametre için birden çok değere izin verir. Azure Sphere CLI'de tek bir parametre ve ardından boşluklarla ayrılmış değerlerin listesini sağlayabilirsiniz ve Azure Sphere klasik CLI'da değer listesi virgülle ayrılır. Örneğin:
azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2
Tırnak işaretleri ve kaçış karakterleri
Azure Sphere CLI komutlarıyla çalışırken kabuğunuzun tırnak işaretlerini ve kaçış karakterlerini nasıl kullandığını unutmayın. Farklı kabuklarda kullanılan betikleri destekliyorsanız bunların nasıl farklılık gösterdiğini anlamanız gerekir.
Örneğin:
- Bash: Alıntılama
- PowerShell: Kuralları Alıntılama Hakkında
- Windows Komut İstemi: Nasıl Yapılır: Windows komut satırında Kaçış Karakterleri, Sınırlayıcılar ve Tırnak İşaretleri
Buluta bağımlı komutlar
Aşağıdaki azsphere komutları için bulut bağlantısı ve Azure Sphere Güvenlik Hizmeti'ne oturum açma gerekir:
- ca-certificate
- device-group
- get-support-data
- Görüntü
- Oturum açma
- Oturum kapatma
- Ürün
- register-user
- Rolü
- show-user
- Kiracı
Ayrıca, aşağıdaki azsphere cihaz komutları da bulut bağlantısı gerektirir:
azsphere device command | Yorum |
---|---|
Yeteneği | Cihaz özelliği indirmesi için Azure Sphere Güvenlik Hizmeti gerekir |
Iddia | |
enable-cloud-test | |
geliştirmeyi etkinleştirme | |
Görüntü | |
Liste | |
Kurtarmak | İnternet bağlantısı gerektirir, ancak Azure Sphere Güvenlik Hizmeti'ne oturum açmaz |
Göster | |
show-count | |
show-deployment-status | |
show-os-version | İnternet bağlantısı gerektirir, ancak Azure Sphere Güvenlik Hizmeti'ne oturum açmaz |
Güncelleştirme |
Cihaz özelliğine bağımlı komutlar
Aşağıdaki azsphere cihaz komutları, DeviceComplete üretim durumundaki cihazlar için bir cihaz özelliği kullanılmasını gerektirir:
Işlem | Açıklama |
---|---|
App | Ekli cihazdaki uygulamaları yönetin. |
Yeteneği | Cihaz yetenek yapılandırmalarını yönetme. Yetenek güncelleştirmesi için gereklidir. |
Sertifika | Cihaz sertifika deposunu yönetin. |
Görüntü | Cihaz görüntülerini yönetme. |
üretim durumu | Bağlı cihazların üretim durumunu yönetin. Üretim durumu güncelleştirmesi için gereklidir. |
Yeni -den başlatın | Bağlı cihazı yeniden başlatın. |
show-deployment-status | bağlı cihazdaki işletim sisteminin ve uygulamaların dağıtım durumunu gösterin. |
show-os-version | bağlı cihazda işletim sistemi sürümünü gösterin. |
dışarıdan yükleme | Ekli cihazda uygulamaları dağıtın ve yönetin. Dışarıdan yükleme dağıtımı ve dışarıdan yükleme silme için gereklidir. |
Wifi | Bağlı cihaz için Wi-Fi yapılandırmalarını yönetin. |
Bu komutları bir yetenek olmadan çalıştırmayı denerseniz, cihaz için bir yetenek dosyası indirip seçmek için komutunu çalıştırmanızı azsphere device enable-development
veya kullanmanızı azsphere device capability
bildiren bir hata iletisi alırsınız.