Gambaran umum Azure Sphere CLI
Penting
Ini adalah dokumentasi Azure Sphere (Warisan). Azure Sphere (Warisan) dihentikan pada 27 September 2027, dan pengguna harus bermigrasi ke Azure Sphere (Terintegrasi) saat ini. Gunakan pemilih Versi yang terletak di atas TOC untuk melihat dokumentasi Azure Sphere (Terintegrasi).
Azure Sphere CLI adalah sekumpulan perintah yang digunakan untuk mengelola sumber daya Azure Sphere Anda.
Perintah berikut ini tersedia:
- ca-certificate
- alat
- grup perangkat
- umpan balik
- get-support-data
- definisi perangkat keras
- gambar
- paket gambar
- interaktif (Perintah dalam pratinjau)
- masuk
- Logout
- product
- role
- show-user
- show-version
- setting
- penyewa
Catatan
Perintah register-user sekarang tidak digunakan lagi.
CLI Azure Sphere dan CLI klasik Azure Sphere
Azure Sphere CLI diinstal bersama CLI yang ada di Windows dan Linux, sehingga Anda memiliki akses ke salah satu antarmuka. CLI klasik Azure Sphere terus berfungsi seperti biasa.
Untuk menggunakan Azure Sphere CLI:
- Di Windows, gunakan PowerShell atau Prompt Perintah Windows standar.
- Di Linux, gunakan shell perintah apa pun. Tentukan perintah azsphere jika Anda mengatur Azure Sphere CLI sebagai default selama penginstalan SDK, atau perintah azsphere_v2 jika Anda mengatur CLI klasik Azure Sphere sebagai default.
Lihat Azure Sphere CLI untuk detail tentang fitur dan perintah yang didukung oleh Azure Sphere CLI.
Penting
- Di Windows, pintasan Prompt Perintah Pengembang Klasik Azure Sphere yang dihentikan hanya dapat digunakan dengan CLI klasik Azure Sphere.
Format baris perintah
Baris perintah azsphere memiliki format berikut:
azsphere [command] [subcommand] operation [parameters]
Secara umum, perintah dan subperintah adalah kata benda dan operasi adalah kata kerja, sehingga kombinasi mengidentifikasi tindakan dan objek tindakan. Sebagian besar perintah dan operasi memiliki nama lengkap dan singkatan. Misalnya, perintah perangkat disingkat d.
Sebagian besar parameter memiliki nama panjang dan singkatan. Pada baris perintah, perkenalkan nama panjang dengan dua tanda hubung dan singkatan dengan satu tanda hubung. Misalnya, dua perintah berikut setara:
azsphere device wifi add --ssid MyNetwork --psk mynetworkkey
azsphere device wifi add -s MyNetwork -p mynetworkkey
Beberapa perintah memungkinkan beberapa nilai untuk satu parameter. Di Azure Sphere CLI Anda dapat menyediakan satu parameter diikuti dengan daftar nilai yang dipisahkan oleh spasi dan di CLI klasik Azure Sphere daftar nilai dipisahkan oleh koma. Contohnya:
azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2
Tanda kutip dan karakter escape
Saat Anda bekerja dengan perintah Azure Sphere CLI, ketahui bagaimana shell Anda menggunakan tanda kutip dan karakter escape. Jika Anda mendukung skrip yang digunakan dalam shell yang berbeda, Anda perlu memahami perbedaannya.
Contohnya:
- Bash: Mengutip
- PowerShell: Tentang Aturan Kutipan
- Prompt Perintah Windows: Panduan: Karakter Escape, Pemisah, dan Kutipan di baris perintah Windows
Perintah yang bergantung pada cloud
Perintah azsphere berikut memerlukan koneksi cloud dan masuk ke Azure Sphere Security Service:
- ca-certificate
- grup perangkat
- get-support-data
- gambar
- masuk
- keluar
- product
- role
- show-user
- penyewa
Selain itu, perintah perangkat azsphere berikut juga memerlukan koneksi cloud:
| perintah perangkat azsphere | Komentar |
|---|---|
| kemampuan | Memerlukan Azure Sphere Security Service untuk unduhan kemampuan perangkat |
| klaim | |
| enable-cloud-test | |
| enable-development | |
| gambar | |
| daftar | |
| sembuh | Memerlukan konektivitas internet, tetapi tidak masuk ke Azure Sphere Security Service |
| memperlihatkan | |
| show-count | |
| show-deployment-status | |
| show-os-version | Memerlukan konektivitas internet, tetapi tidak masuk ke Azure Sphere Security Service |
| memperbarui |
Perintah yang bergantung pada kemampuan perangkat
Perintah perangkat azsphere berikut memerlukan kemampuan perangkat yang digunakan untuk perangkat dalam status manufaktur DeviceComplete:
| Operasi | Deskripsi |
|---|---|
| aplikasi | Mengelola aplikasi pada perangkat yang terpasang. |
| kemampuan | Mengelola konfigurasi kemampuan perangkat. Diperlukan untuk pembaruan kemampuan. |
| sertifikat | Mengelola penyimpanan sertifikat perangkat. |
| gambar | Mengelola gambar perangkat. |
| negara manufaktur | Mengelola status manufaktur perangkat yang terpasang. Diperlukan untuk pembaruan status manufaktur. |
| hidupkan ulang | Mulai ulang perangkat yang terpasang. |
| show-deployment-status | Tampilkan status penyebaran sistem operasi dan aplikasi pada perangkat yang terpasang. |
| show-os-version | Tampilkan versi sistem operasi pada perangkat yang terpasang. |
| sideload | Menyebarkan dan mengelola aplikasi pada perangkat yang terpasang. Diperlukan untuk penyebaran sideload dan penghapusan sideload. |
| wifi | Mengelola konfigurasi Wi-Fi untuk perangkat yang terpasang. |
Jika Anda mencoba menjalankan perintah ini tanpa kemampuan, Anda menerima pesan kesalahan yang memberi tahu Anda untuk menjalankan azsphere device enable-development atau menggunakan azsphere device capability untuk mengunduh dan memilih file kemampuan untuk perangkat.