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 ekstensi Azure CLI dan Azure Sphere
Untuk memperoleh ekstensi Azure Sphere untuk Azure CLI:
Instal Azure CLI jika Anda belum melakukannya.
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 nilainya ada $HOME/.azure/cliextensions di Linux dan macOS, dan %USERPROFILE%\.azure\cliextensions di Windows.
Tips
Setelah masuk, Anda akan melihat daftar langganan yang terkait dengan akun Azure Anda. Pastikan bahwa Anda memilih langganan dengan izin yang diperlukan menggunakan az account set perintah agar ekstensi Azure Sphere berfungsi dengan benar. Untuk informasi selengkapnya tentang pilihan langganan, lihat Menggunakan beberapa langganan Azure.
Mengelola ekstensi Azure Sphere
Untuk melihat versi ekstensi Azure CLI yang terinstal, 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 Umum Azure Sphere CLI
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). CLI memiliki penyelesaian tab penuh untuk perintah di bawah shell bash.
Tabel ini mencantumkan beberapa perintah dan tautan umum Azure Sphere ke dokumentasi referensi mereka.
| Perintah | Deskripsi |
|---|---|
az sphere catalog |
Kelola katalog Anda. |
az sphere ca-certificate |
Kelola sertifikat di katalog Anda. |
az sphere deployment |
Kelola penyebaran di katalog Anda. |
az sphere device |
Kelola perangkat Azure Sphere. |
az sphere device-group |
Kelola grup perangkat di katalog Anda. |
az sphere image |
Kelola 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, --subscription, atau --catalog.
Perintah dependen perangkat
Perintah ini berfungsi dengan perangkat Azure Sphere yang terpasang secara lokal. Jika Anda mencoba perintah tanpa perangkat yang dilampirkan, Anda akan menerima kesalahan. Untuk informasi selengkapnya tentang perintah perangkat, lihat perangkat bola az
az sphere device claimaz sphere device recoveraz sphere device restartaz sphere device show-attachedaz sphere device show-os-versionaz sphere device app show-memory-statusaz sphere device app show-quotaaz sphere device app show-statusaz sphere device app startaz sphere device app stopaz sphere device capability show-attachedaz sphere device capability updateaz sphere device certificate addaz sphere device certificate deleteaz sphere device certificate listaz sphere device certificate showaz sphere device certificate show-quotaaz sphere device image list-installedaz sphere image-package showaz sphere device manufacturing-state showaz sphere device manufacturing-state updateaz sphere device network proxy applyaz sphere device network proxy deleteaz sphere device network proxy showaz sphere device network disableaz sphere device network enableaz sphere device network list-firewall-rulesaz sphere device network list-interfacesaz sphere device network show-diagnosticsaz sphere device network show-statusaz sphere device network update-interfaceaz sphere device sideload deleteaz sphere device sideload deployaz sphere device wifi addaz sphere device wifi disableaz sphere device wifi enableaz sphere device wifi forgetaz sphere device wifi listaz sphere device wifi reload-configaz sphere device wifi scanaz sphere device wifi showaz sphere device wifi show-status
Argumen yang tersedia secara global
Parameter global berikut ini tersedia untuk ekstensi Azure Sphere:
| Parameter | Deskripsi |
|---|---|
--debug |
Tingkatkan pembuatan log verbositas untuk memperlihatkan semua log debug. |
--help -h |
Memperlihatkan pesan bantuan. |
--only-show-errors |
Hanya memperlihatkan kesalahan, menyembunyikan peringatan. |
--output -o |
Format output. Nilai yang diperbolehkan: json, , jsoncnone, tabletsv, . yamlcyaml Default: json. |
--query |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya. |
--subscription |
: Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID. |
--verbose |
Meningkatkan verbositas pembuatan log. Gunakan --debug untuk log debug penuh. |