az iot central user

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.37.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az iot central user . Pelajari lebih lanjut tentang ekstensi.

Mengelola dan mengonfigurasi pengguna IoT Central.

Perintah

Nama Deskripsi Jenis Status
az iot central user create

Tambahkan pengguna ke aplikasi.

 Ekstensi GA
az iot central user delete

Menghapus pengguna dari aplikasi.

 Ekstensi GA
az iot central user list

Dapatkan daftar pengguna untuk aplikasi IoT Central.

 Ekstensi GA
az iot central user show

Dapatkan detail pengguna berdasarkan ID.

 Ekstensi GA
az iot central user update

Perbarui peran untuk pengguna dalam aplikasi.

 Ekstensi GA

az iot central user create

Tambahkan pengguna ke aplikasi.

az iot central user create --app-id
                           --assignee
                           --role
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--org-id]
                           [--tenant-id]
                           [--token]

Contoh

Menambahkan pengguna melalui email ke aplikasi

az iot central user create --user-id {userId} --app-id {appId} --email {emailAddress} --role admin

Menambahkan perwakilan layanan ke aplikasi

az iot central user create --user-id {userId} --app-id {appId} --tenant-id {tenantId} --object-id {objectId} --role operator

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

--assignee --user-id

ID yang terkait dengan pengguna.

--role -r

Peran yang akan dikaitkan dengan token atau pengguna ini. Anda dapat menentukan salah satu peran bawaan, atau menentukan ID peran peran peran kustom. Lihat selengkapnya di https://aka.ms/iotcentral-customrolesdocs.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--email

Alamat email pengguna yang akan ditambahkan ke aplikasi. Jika ini ditentukan, parameter perwakilan layanan (tenant_id dan object_id) akan diabaikan.

--object-id --oid

ID objek untuk perwakilan layanan yang akan ditambahkan ke aplikasi. ID Penyewa juga harus ditentukan. Jika email ditentukan, ini akan diabaikan dan pengguna tidak akan menjadi pengguna perwakilan layanan tetapi pengguna "email" standar.

--org-id --organization-id

ID organisasi untuk penetapan peran pengguna. Hanya tersedia untuk api-version == 1.1-preview.

--tenant-id --tnid

ID penyewa untuk perwakilan layanan yang akan ditambahkan ke aplikasi. ID objek juga harus ditentukan. Jika email ditentukan, ini akan diabaikan dan pengguna tidak akan menjadi pengguna perwakilan layanan tetapi pengguna "email" standar.

--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot central user delete

Menghapus pengguna dari aplikasi.

az iot central user delete --app-id
                           --assignee
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--token]

Contoh

Menghapus pengguna

az iot central user delete --app-id {appid} --user-id {userId}

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

--assignee --user-id

ID yang terkait dengan pengguna.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot central user list

Dapatkan daftar pengguna untuk aplikasi IoT Central.

az iot central user list --app-id
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri]
                         [--token]

Contoh

Daftar pengguna

az iot central user list --app-id {appid}

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot central user show

Dapatkan detail pengguna berdasarkan ID.

az iot central user show --app-id
                         --assignee
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri]
                         [--token]

Contoh

Mendapatkan detail pengguna

az iot central user show --app-id {appid} --user-id {userId}

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

--assignee --user-id

ID yang terkait dengan pengguna.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot central user update

Perbarui peran untuk pengguna dalam aplikasi.

Perbarui pengguna dengan peran yang berbeda. Memperbarui tenantId atau objectId untuk pengguna perwakilan layanan tidak diizinkan. Memperbarui alamat email untuk pengguna email tidak diizinkan.

az iot central user update --app-id
                           --assignee
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--roles]
                           [--tenant-id]
                           [--token]

Contoh

Perbarui peran untuk pengguna melalui email atau perwakilan layanan dalam aplikasi.

az iot central user update --user-id {userId} --app-id {appId} --roles "org1\admin"

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

--assignee --user-id

ID yang terkait dengan pengguna.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--email

Alamat email pengguna yang akan ditambahkan ke aplikasi. Jika ini ditentukan, parameter perwakilan layanan (tenant_id dan object_id) akan diabaikan.

--object-id --oid

ID objek untuk perwakilan layanan yang akan ditambahkan ke aplikasi. ID Penyewa juga harus ditentukan. Jika email ditentukan, ini akan diabaikan dan pengguna tidak akan menjadi pengguna perwakilan layanan tetapi pengguna "email" standar.

--roles

Daftar peran yang dipisahkan koma yang akan dikaitkan dengan pengguna ini. Anda dapat menentukan salah satu peran bawaan, atau menentukan ID peran peran peran kustom. Lihat selengkapnya di https://aka.ms/iotcentral-customrolesdocs. Organisasi dapat ditentukan bersama peran saat berjalan dengan versi API == 1.1-pratinjau. Misalnya, "organization_id\role".

--tenant-id --tnid

ID penyewa untuk perwakilan layanan yang akan ditambahkan ke aplikasi. ID objek juga harus ditentukan. Jika email ditentukan, ini akan diabaikan dan pengguna tidak akan menjadi pengguna perwakilan layanan tetapi pengguna "email" standar.

--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.