Gambaran umum ekstensi Azure Sphere untuk Azure CLI

Alat baris perintah untuk mengelola perangkat terlampir Azure Sphere dan penyebaran cloud didistribusikan sebagai ekstensi Azure CLI.

Menginstal Azure CLI dan ekstensi Azure Sphere

Untuk memperoleh ekstensi Azure Sphere untuk Azure CLI:

1. Instal Azure CLI jika Anda belum melakukannya.

2. Untuk menambahkan ekstensi Azure Sphere, jalankan perintah berikut:

   az extension add --name azure-sphere
   

Anda harus Masuk dengan Azure CLI untuk masuk ke langganan Azure yang ingin Anda gunakan untuk mengelola perangkat Azure Sphere.

Setelah ekstensi diinstal, lokasinya ditemukan di bawah nilai $AZURE_EXTENSION_DIR variabel shell. Jika variabel ini tidak diatur, secara default, nialinya menjadi $HOME/.azure/cliextensions di Linux dan macOS, dan %USERPROFILE%\.azure\cliextensions di Windows.

Tip

Setelah masuk, Anda akan melihat daftar langganan yang terkait dengan akun Azure Anda. Pastikan Anda memilih langganan dengan izin yang diperlukan menggunakan az account set perintah agar ekstensi Azure Sphere berfungsi dengan benar. Untuk informasi selengkapnya tentang pemilihan langganan, lihat Menggunakan beberapa langganan Azure.

Mengelola ekstensi Azure Sphere

Untuk melihat versi ekstensi Azure CLI yang diinstal, gunakan perintah :

az version

Untuk memperbarui ekstensi Azure Sphere ke versi terbaru, gunakan:

az extension update --name azure-sphere

Untuk menghapus instalan ekstensi Azure Sphere, gunakan:

az extension remove --name azure-sphere

Perintah Azure Sphere CLI umum

Anda dapat menggunakan perintah Azure Sphere dengan mengetik az sphere dari prompt perintah Windows atau PowerShell. Di Linux, Anda dapat menggunakan antarmuka baris perintah (CLI) apa pun. CLI memiliki penyelesaian tab penuh untuk perintah di bawah shell bash.

Tabel ini mencantumkan beberapa perintah dan tautan Azure Sphere umum ke dokumentasi referensinya.

Perintah	Deskripsi
az sphere catalog	Kelola katalog Anda.
az sphere ca-certificate	Mengelola sertifikat di katalog Anda.
az sphere deployment	Mengelola penyebaran di katalog Anda.
az sphere device	Mengelola perangkat Azure Sphere.
az sphere device-group	Mengelola grup perangkat di katalog Anda.
az sphere image	Mengelola gambar di katalog Anda.
az sphere product	Kelola produk di katalog Anda.
az sphere get-support-data	Kumpulkan data diagnostik tentang konfigurasi sistem, cloud, dan perangkat Anda.

Azure CLI memungkinkan Anda menyiapkan opsi konfigurasi yang menyederhanakan penggunaan perintah Azure Sphere CLI dengan menyediakan default untuk parameter seperti --resource-group, , --subscriptionatau --catalog.

Perintah dependen perangkat

Perintah ini berfungsi dengan perangkat Azure Sphere yang terpasang secara lokal. Jika Anda mencoba perintah tanpa perangkat yang terpasang, Anda akan menerima kesalahan. Untuk informasi selengkapnya tentang perintah perangkat lihat, az sphere device

• az sphere device claim
• az sphere device recover
• az sphere device restart
• az sphere device show-attached
• az sphere device show-os-version
• az sphere device app show-memory-status
• az sphere device app show-quota
• az sphere device app show-status
• az sphere device app start
• az sphere device app stop
• az sphere device capability show-attached
• az sphere device capability update
• az sphere device certificate add
• az sphere device certificate delete
• az sphere device certificate list
• az sphere device certificate show
• az sphere device certificate show-quota
• az sphere device image list-installed
• az sphere image-package show
• az sphere device manufacturing-state show
• az sphere device manufacturing-state update
• az sphere device network proxy apply
• az sphere device network proxy delete
• az sphere device network proxy show
• az sphere device network disable
• az sphere device network enable
• az sphere device network list-firewall-rules
• az sphere device network list-interfaces
• az sphere device network show-diagnostics
• az sphere device network show-status
• az sphere device network update-interface
• az sphere device sideload delete
• az sphere device sideload deploy
• az sphere device wifi add
• az sphere device wifi disable
• az sphere device wifi enable
• az sphere device wifi forget
• az sphere device wifi list
• az sphere device wifi reload-config
• az sphere device wifi scan
• az sphere device wifi show
• az sphere device wifi show-status

Argumen yang tersedia secara global

Parameter global berikut tersedia untuk ekstensi Azure Sphere:

Parameter	Deskripsi
--debug	Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
--help -h	Menampilkan pesan bantuan.
--only-show-errors	Hanya menunjukkan kesalahan, menekan peringatan.
--output -o	Format output. Nilai yang diizinkan: json, , nonejsonc, table, tsv, yaml, yamlc. Default: json.
--query	String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
--subscription	: Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
--verbose	Meningkatkan verbositas pengelogan. Gunakan --debug untuk log debug yang lengkap.