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).
Mengelola penyewa Azure Sphere.
Penting
Perintah azsphere tenant download-ca-certificate, azsphere tenant download-ca-certificate-chain, dan azsphere tenant download-validation-certificate usang. Gunakan azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proof, dan azsphere ca-certificate list sebagai gantinya.
Di Azure Sphere CLI, 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 mengklaim perangkat.
| Operasi | Deskripsi |
|---|---|
| buat | Membuat penyewa baru. |
| download-error-report | Mengembalikan informasi kesalahan untuk perangkat dalam penyewa saat ini. |
| daftar | Mencantumkan penyewa Azure Sphere yang tersedia. |
| pilih | Memilih penyewa Azure Sphere default yang akan digunakan pada komputer ini. |
| perlihatkan terpilih | Memperlihatkan penyewa Azure Sphere default untuk komputer ini. |
| memperbarui | Memperbarui detail penyewa, seperti nama penyewa. |
buat
Membuat penyewa Azure Sphere baru. Perangkat terpasang diperlukan untuk menjalankan perintah ini. Untuk informasi selengkapnya, lihat Membuat penyewa Azure Sphere.
Jika Anda sudah memiliki penyewa dan yakin menginginkan penyewa lain, gunakan --force-additional parameter . Saat ini, Anda tidak dapat menghapus penyewa Azure Sphere.
Setelah penyewa dibuat, jalankan penyewa azsphere pilih untuk memilih penyewa default yang akan digunakan untuk pengguna saat ini di PC ini. Anda dapat menambahkan peran untuk pengguna di penyewa Azure Sphere saat ini menggunakan perintah azsphere role add .
Perintah buat penyewa azsphere berfungsi dengan perangkat Azure Sphere yang terpasang secara lokal. Jika Anda mencoba perintah tanpa perangkat yang terpasang, Anda akan menerima kesalahan. ID perangkat direkam saat Anda membuat penyewa, dan hanya satu penyewa yang dapat dibuat per perangkat.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -n, --nama | String | Menentukan nama untuk penyewa. Saat menamai penyewa, gunakan karakter alfanumerik. Karakter khusus tidak diizinkan. Nama tidak boleh melebihi 50 karakter dan peka huruf besar/kecil. |
Parameter opsional
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -d, --device | String | Menentukan perangkat tempat menjalankan perintah ketika beberapa perangkat terpasang. Parameter ini diperlukan ketika beberapa perangkat terpasang. Perangkat yang saat ini terpasang digunakan secara default. Anda dapat menentukan ID perangkat, alamat IP, atau ID Koneksi Lokal perangkat yang terpasang. Azure Sphere CLI mendukung beberapa perangkat MT3620 di Windows, tetapi Anda hanya dapat menyambungkan satu perangkat pada satu waktu di Linux. Untuk alasan ini, parameter ini didukung untuk Windows tetapi tidak untuk Linux. Kesalahan dikembalikan jika Anda menggunakan parameter ini dengan perintah di Linux. |
| --force-additional | Boolean | Memaksa pembuatan penyewa Azure Sphere baru. Gunakan perintah ini hanya jika Anda yakin ingin menggunakan akun saat ini untuk membuat penyewa Azure Sphere baru menggunakan perangkat yang terpasang. |
| --disable-confirm-prompt | Boolean | Menonaktifkan permintaan konfirmasi pengguna. |
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere tenant create --name MyTenant
--force-additional Gunakan parameter dan --disable-confirm-prompt jika Anda yakin ingin menggunakan akun ini untuk membuat penyewa Azure Sphere baru menggunakan perangkat yang terpasang. Perangkat yang sebelumnya telah digunakan untuk membuat penyewa Azure Sphere tidak dapat digunakan untuk membuat penyewa baru.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
Tip
Setelah Anda membuat penyewa, pastikan Anda menjalankan penyewa azsphere pilih untuk memilih penyewa default yang akan digunakan untuk pengguna saat ini di PC ini.
download-error-report
Mengembalikan informasi tentang kesalahan yang dilaporkan oleh perangkat dalam penyewa saat ini.
Perintah ini menarik data peristiwa dari cloud Azure Sphere Security Service dan tidak memerlukan koneksi fisik ke perangkat tertentu. Perintah azsphere tenant download-error-report berfungsi dalam konteks penyewa saat ini dan mengembalikan laporan kesalahan untuk semua perangkat dalam penyewa tersebut.
Catatan
Mungkin perlu waktu hingga 24 jam agar peristiwa yang dilaporkan baru-baru ini tersedia untuk diunduh. Untuk informasi selengkapnya, lihat Mengumpulkan dan menginterpretasikan data kesalahan.
Parameter opsional
| Parameter | Jenis | Deskripsi |
|---|---|---|
| --tujuan | String | Menentukan jalur dan nama file file output. |
| -t, --tenant | GUID atau nama | Menentukan penyewa untuk melakukan operasi ini. Mengesampingkan penyewa default yang dipilih. Anda dapat menentukan ID penyewa atau nama penyewa. |
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
list
Mencantumkan penyewa Azure Sphere.
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
select
Memilih penyewa Azure Sphere default yang akan digunakan untuk pengguna saat ini pada PC ini.
Untuk menampilkan penyewa default saat ini, gunakan azsphere tenant show-selected.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -t, --tenant | GUID atau nama | Menentukan penyewa untuk melakukan operasi ini. Mengesampingkan penyewa default yang dipilih. Anda dapat menentukan ID penyewa atau nama penyewa. |
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
perlihatkan terpilih
Menampilkan detail penyewa Azure Sphere default untuk pengguna saat ini pada PC ini.
Ini adalah penyewa yang dipilih dengan perintah pilih penyewa azsphere.
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
update
Memperbarui detail penyewa, seperti nama penyewa.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -n, --new-name | String | Menentukan nama baru untuk penyewa. Saat menamai penyewa, gunakan karakter alfanumerik. Karakter khusus tidak diizinkan. Nama tidak boleh melebihi 50 karakter dan peka huruf besar/kecil. |
Parameter opsional
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -t, --tenant | GUID atau nama | Menentukan penyewa untuk melakukan operasi ini. Mengesampingkan penyewa default yang dipilih. Anda dapat menentukan ID penyewa atau nama penyewa. |
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Tip
Jika Anda belum memilih penyewa default, daftar penyewa yang tersedia akan ditampilkan. Atur penyewa default Anda dengan memilih salah satu opsi.