Kelola penyewa
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).
Penyewa Azure Sphere menyediakan cara yang aman bagi organisasi Anda untuk mengelola perangkat Azure Sphere dari jarak jauh dalam isolasi dari perangkat pelanggan lain. Organisasi Anda harus membuat penyewa Azure Sphere lalu mengklaim setiap perangkatnya ke dalam penyewa tersebut, sehingga Anda dapat mengelola perangkat tersebut dari jarak jauh dan aman.
Prasyarat
- Instal Azure Sphere SDK untuk Windows atau untuk Linux.
- Anda harus memiliki perangkat yang tidak diklaim yang sebelumnya belum digunakan untuk membuat penyewa.
Membuat penyewa Azure Sphere
Penyewa Azure Sphere mengisolasi perangkat Azure Sphere Anda dan menyediakan cara bagi Anda untuk mengatur dan menyebarkan aplikasi. Akun yang membuat penyewa secara otomatis diberi peran administrator untuk penyewa.
Tip
- Setelah penyewa dibuat, penyewa tidak dapat dihapus, dan perangkat tidak dapat dimigrasikan antar penyewa. Jika tim atau organisasi Anda sudah memiliki penyewa Azure Sphere, pertimbangkan untuk meminta akses ke tim atau organisasi Anda daripada membuat penyewa tambahan.
Untuk membuat penyewa Azure Sphere:
Sambungkan perangkat Azure Sphere ke komputer Anda dengan USB.
Buka Azure Sphere CLI menggunakan PowerShell, Windows Command Prompt, atau shell perintah Linux.
Masuk ke CLI, ikuti instruksi di sini.
Untuk membuat penyewa, masukkan perintah berikut:
azsphere tenant create --name <tenant-name or tenant-ID>Ganti <nama> penyewa dengan nama yang dapat dikenali pengguna lain, seperti "Contoso Ltd" atau "Contoso Dishwasher Division." Saat Anda memberi nama penyewa, gunakan hanya karakter dan spasi alfanumerik. Jika Anda menyertakan spasi, sertakan nama dalam tanda kutip. Nama tidak boleh dimulai dengan spasi atau melebihi 50 karakter. Karakter khusus tidak diizinkan. Nama peka dengan huruf besar/kecil.
Saat Anda membuat penyewa, Azure Sphere Security Service merekam ID perangkat perangkat yang terpasang. Setiap ID perangkat hanya dapat digunakan untuk membuat satu penyewa Azure Sphere.
Jika akun Anda sudah memiliki akses ke penyewa Azure Sphere, maka perintah akan gagal, menyarankan Anda untuk menggunakan penyewa yang ada. Jika Anda yakin ingin membuat penyewa baru, Anda dapat menggunakan --force-additional parameter untuk memaksa penyewa Azure Sphere baru dibuat.
Perintah buat penyewa azsphere membuat penyewa tetapi tidak mengklaim perangkat ke penyewa. Untuk informasi selengkapnya, lihat Mengklaim perangkat Anda.
Untuk membuat penyewa menggunakan API, gunakan operasi Penyewa - Buat .
Perlihatkan dan pilih penyewa default
Jalankan azsphere tenant show-selected untuk memverifikasi bahwa penyewa yang dipilih harus digunakan sebagai default pada PC ini.
Untuk mengubah atau memilih penyewa default, jalankan azsphere tenant select.
Tip
Jika Anda keluar dan masuk lagi ke Azure Sphere Security Service, Anda mungkin diminta untuk memilih penyewa default. Pastikan untuk masuk dengan akun yang ingin Anda gunakan untuk mengelola perangkat Azure Sphere Anda.
Daftar penyewa
Anda bisa mencantumkan penyewa Azure Sphere yang tersedia menggunakan opsi berikut:
Jalankan perintah berikut untuk mencantumkan penyewa Azure Sphere yang tersedia.
azsphere tenant list
Untuk mencantumkan penyewa menggunakan API, gunakan operasi Penyewa - Dapatkan .
Memperbarui penyewa yang sudah ada
Anda dapat menggunakan Azure Sphere CLI atau Azure Sphere Public API untuk mengganti nama penyewa Azure Sphere yang ada. Saat menamai penyewa, gunakan karakter alfanumerik. Karakter khusus tidak diizinkan. Nama tidak boleh melebihi 50 karakter dan peka huruf besar/kecil.
Untuk memperbarui penyewa menggunakan CLI, jalankan perintah :
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
Tip
Pesan dapat ditampilkan jika penyewa default tidak dipilih. Pilih penyewa yang diperlukan dari daftar dan coba lagi perintah .
Untuk memperbarui penyewa menggunakan API, gunakan operasi Penyewa - Patch .
Mengunduh laporan kesalahan untuk penyewa
Untuk mendapatkan laporan kesalahan untuk semua perangkat dalam penyewa, gunakan perintah azsphere tenant download-error-report.