role
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 peran pengguna dalam penyewa untuk kontrol akses berbasis peran (RBAC).
| Operasi | description |
|---|---|
| penambahan | Menambahkan peran untuk pengguna. |
| hapus | Menghapus peran pengguna. |
| daftar | Menampilkan daftar pengguna dan peran mereka. |
| memperlihatkan | Mengembalikan peran yang ditetapkan ke akun pengguna tertentu. |
| show-type | Menampilkan daftar peran yang didukung untuk penyewa ini. |
tambahkan
Menambahkan peran ke pengguna.
- Administrator memiliki akses penuh ke semua perangkat dan operasi dalam penyewa, termasuk izin untuk menambahkan atau menghapus pengguna lain. Peran Administrator ditetapkan secara default kepada pengguna yang membuat penyewa.
- Kontributor dapat menambahkan perangkat dan membuat dan mengubah penyebaran. Pengembang perangkat lunak dan perangkat keras yang membuat aplikasi, mengelola perangkat yang terhubung, dan memperbarui penyebaran, tetapi tidak bertanggung jawab untuk mengelola akses penyewa, harus memiliki peran Kontributor.
- Pembaca memiliki akses ke informasi tentang penyewa, termasuk perangkat yang diklaim, penyebaran, dan, jika tersedia, data pelaporan kesalahan apa pun dari perangkat. Peran ini sesuai untuk personel pemeliharaan dan operasi yang bertanggung jawab untuk melacak performa perangkat yang terhubung pada penginstalan pengguna akhir.
Catatan
Perintah ini akan secara otomatis mendaftarkan akun Microsoft pengguna dengan Azure Sphere, jika belum terdaftar. Sebelumnya, perintah register-user digunakan untuk mendaftarkan pengguna baru dengan Azure Sphere; ini sekarang secara otomatis dilakukan saat menambahkan pengguna ke peran baru dalam penyewa yang ada, dan perintah register-user sekarang tidak digunakan lagi.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -u, --user | String | Menentukan nama pengguna (alamat email). |
| -r, --role | String | Menentukan peran yang akan ditetapkan kepada pengguna yang dipilih. Peran yang mungkin adalah: Administrator, Kontributor, dan Pembaca. |
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 role add --user john@contoso.com --role Administrator
hapus
Menghapus peran dari pengguna di penyewa Azure Sphere saat ini atau yang dipilih.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -u, --user | String | Menentukan ID atau email pengguna untuk mengidentifikasi pengguna tempat peran dihapus. |
| -r, --role | Enum | Menentukan peran yang akan dihapus. Peran yang mungkin adalah: Administrator, Kontributor, dan Pembaca. |
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. |
Catatan
Peran Administrator pengguna saat ini hanya dapat dihapus oleh administrator lain.
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 role delete --user bob@contoso.com --role contributor --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
list
Menampilkan daftar peran pengguna di penyewa saat ini atau yang dipilih.
Daftar akan dipotong setelah 500 entri pertama.
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 role list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
--------------------- -------------
Name Roles
===================================
bob@contoso.com Administrator
Contributor
--------------------- -------------
show
Menampilkan informasi peran untuk pengguna terpilih.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| -u, --user | String | Nama pengguna untuk ditampilkan (alamat email). |
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 role show --user john@contoso.com --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
-------------
Roles
=============
Administrator
Contributor
-------------
show-type
Menampilkan peran yang dapat ditetapkan dalam penyewa ini.
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 role show-types
-------------
Result
=============
Administrator
-------------
Contributor
-------------
Reader
-------------