Bagikan melalui

Bermigrasi dari CLI klasik ke CLI Azure Sphere

  • Artikel

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).

Jika Anda masih menggunakan CLI klasik Azure Sphere, kami sarankan Anda bermigrasi ke Azure Sphere CLI baru. Saat ini, kedua versi CLI dapat diinstal dan digunakan berdampingan, tetapi CLI klasik tidak lagi diperbarui atau dipelihara dan akan dihapus dari SDK pada tanggal mendatang (tidak sebelum akhir 2022). Kami mendorong Anda untuk membiasakan diri dengan perbedaan ini dan memigrasikan proses dan skrip Anda sebelum akhir 2022 untuk menghindari gangguan.

Untuk memperbarui ke SDK terbaru, lihat Menginstal SDK Azure Sphere di Linux atau Menginstal SDK Azure Sphere untuk Windows.

Untuk menggunakan Azure Sphere CLI di Windows, gunakan PowerShell atau Windows Command Prompt standar. Untuk Linux, gunakan sembarang shell perintah. Untuk informasi lebih lengkap, lihat Menjalankan CLI Azure Sphere.

Di Windows, Prompt Perintah Pengembang Klasik Azure Sphere kustom yang dihentikan (tersedia sebagai pintasan di menu Mulai di bawah Azure Sphere) dapat digunakan hanya dengan CLI klasik Azure Sphere. Untuk informasi lebih lengkap, lihat Menjalankan CLI klasik Azure Sphere.

Perbedaan utama

  • Di CLI klasik Azure Sphere, beberapa parameter dapat digunakan untuk mengidentifikasi setiap jenis objek. Di Azure Sphere CLI, satu parameter digunakan untuk mengidentifikasi setiap jenis objek. Ini berarti Anda dapat menggunakan nama atau ID untuk menentukan nilai parameter. Ini telah diimplementasikan untuk --deviceparameter , --tenant, --product, dan --device-group .

    Tipe objek Azure Sphere CLI CLI klasik Azure Sphere (dihentikan)
    Perangkat --device --deviceid, --deviceip, atau --devicelocation
    Grup perangkat --device-group --devicegroupid atau --devicegroupname
    Produk --product --productid atau --productname
    Penyewa --tenant --tenantid

  • Formulir pendek untuk perintah didukung dalam versi klasik. Di Azure Sphere CLI, kami sarankan Anda menggunakan fitur Penyelesaian tab atau interaktif untuk melihat daftar perintah yang tersedia. Misalnya, di CLI klasik, Anda dapat menggunakan perintah azsphere device enable-development atau azsphere dev edv , sedangkan di Azure Sphere CLI baru Anda dapat menggunakan lengkapi otomatis untuk mengetik azsphere device enable-development perintah dengan cepat.

  • 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

  • Di CLI baru, penyewa default tidak dipilih secara otomatis saat penyewa dibuat. Anda harus menjalankan perintah azsphere tenant select untuk memilih penyewa default yang akan digunakan untuk pengguna saat ini di PC. Ini untuk memastikan bahwa penyewa default adalah penyewa yang benar untuk digunakan saat melakukan operasi satu kali yang tidak dapat Anda batalkan seperti klaim perangkat.

    Saat menggunakan skrip, Anda dapat memilih penyewa default menggunakan --tenant <tenant ID or tenant name> parameter .

    Atur penyewa default di awal skrip menggunakan:

    azsphere tenant select --tenant <tenant ID or tenant name>

    Anda juga dapat menimpa penyewa default atau menentukan penyewa yang diperlukan saat menjalankan perintah. Contohnya:

    azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>

  • Parameter --device-group mengidentifikasi grup perangkat. ID grup perangkat menyediakan GUID, yang secara unik mengidentifikasi grup perangkat di semua produk. Atau, Anda dapat menggunakan nama produk dan pasangan nama grup perangkat dalam <format nama produk/<nama-grup> perangkat>. Pasangan nama ini secara unik mengidentifikasi grup perangkat untuk produk tertentu.

  • Perintah berikut adalah perintah gabungan di CLI klasik. Ini berarti satu perintah melakukan beberapa tugas. Di CLI baru, Anda perlu menjalankan dua perintah.

    • Di CLI klasik, perintah azsphere device-group deployment create mengunggah paket gambar dan membuat penyebaran baru.

      Di CLI baru, Anda perlu:

      1. Unggah paket gambar ke penyewa Azure Sphere Anda dengan menggunakan azsphere image add.
      2. Buat penyebaran baru untuk grup perangkat untuk gambar yang diunggah menggunakan azsphere device-group deployment create.

    • Di CLI klasik, unduhan kemampuan perangkat azsphere --pilih perintah diunduh dan konfigurasi kemampuan perangkat yang dipilih sementara untuk perangkat yang terpasang.

      Di CLI baru, Anda perlu:

      1. Unduh file kemampuan dengan menggunakan unduhan kemampuan perangkat azsphere.
      2. Pilih kemampuan dengan menggunakan azsphere device capability select.

    • Di CLI klasik, unduhan kemampuan perangkat azsphere --apply perintah diunduh dan terapkan konfigurasi kemampuan perangkat untuk perangkat yang terpasang.

      Di CLI baru, Anda perlu:

      1. Unduh file kemampuan dengan menggunakan unduhan kemampuan perangkat azsphere.
      2. Terapkan kemampuan dengan menggunakan pembaruan kemampuan perangkat azsphere.

  • Di CLI -o klasik, parameter atau --output digunakan untuk menentukan jalur dan nama file untuk menyimpan file. Di Azure Sphere CLI baru, parameter khusus konteks digunakan seperti --destination untuk menentukan jalur input dan output.

  • Dalam CLI -d klasik, parameter atau --debug digunakan dalam perintah mulai aplikasi perangkat azsphere untuk memulai aplikasi dalam mode debug. Di Azure Sphere CLI baru, --debug-mode parameter digunakan untuk memulai aplikasi dalam mode debug dan --debug parameter digunakan sebagai parameter global untuk meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

  • Di CLI klasik tidak ada kontrol atas format output. Di Azure Sphere CLI, -o parameter atau --output digunakan untuk menentukan format output untuk memformat output CLI.

  • Dari rilis 21.02 dan seterusnya nomor versi eksplisit telah dihapus dari nama produk Azure Sphere CLI. Perubahan ini menghilangkan kebingungan dalam mengacu pada berbagai versi produk.

    • Azure Sphere CLI v2 dan yang lebih baru sekarang disebut hanya sebagai "Azure Sphere CLI".
    • Versi Azure Sphere CLI sebelumnya (CLI v1 dan yang lebih rendah) sekarang disebut sebagai "CLI klasik Azure Sphere".

  • Jika Anda menggunakan skrip, skrip mungkin tidak kompatibel dengan Azure Sphere CLI baru karena perbedaan yang dijelaskan di atas. Buat pembaruan yang diperlukan agar skrip berjalan dengan benar di CLI baru.

Lihat juga