Azure Sphere CLI'ya genel bakış

  • Makale

Azure Sphere CLI, Azure Sphere kaynaklarınızı yönetmek için kullanılan bir komut kümesidir.

Aşağıdaki komutlar kullanılabilir:

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:

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.