Kelola IoT Central dari Azure CLI atau PowerShell
Daripada membuat dan mengelola aplikasi IoT Central di situs web Azure IoT Central application manager, Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk mengelola aplikasi Anda.
Jika Anda lebih suka menggunakan bahasa seperti JavaScript, Python, C#, Ruby, atau Go, lihat repositori Sampel Azure IoT Central ARM SDK untuk sampel kode yang menunjukkan cara membuat, memperbarui, membuat daftar, dan hapus aplikasi Azure IoT Central.
Prasyarat
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi lebih lanjut, lihat Mulai Cepat Azure Cloud Shell - Bash.
Jika Anda lebih memilih untuk menjalankan perintah referensi CLI secara lokal, pasang Azure CLI. Jika Anda menjalankan di Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
Saat diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.
Peringatan
Anda akan memerlukan akses Kontributor ke Langganan Azure Anda untuk membuat aplikasi IoT Central. Meskipun mungkin terdapat tingkat akses alternatif untuk membuat aplikasi, memiliki akses tingkat Kontributor ke Langganan adalah jalur yang direkomendasikan.
Membuat aplikasi
Gunakan perintah buat aplikasi az iot central untuk membuat aplikasi IoT Central di langganan Azure Anda. Contohnya:
# Create a resource group for the IoT Central application
az group create --location "East US" \
--name "MyIoTCentralResourceGroup"
# Create an IoT Central application
az iot central app create \
--resource-group "MyIoTCentralResourceGroup" \
--name "myiotcentralapp" --subdomain "mysubdomain" \
--sku ST1 --template "iotc-pnp-preview" \
--display-name "My Custom Display Name"
Perintah ini pertama-tama membuat grup sumber daya di wilayah AS timur untuk aplikasi. Tabel berikut ini menjelaskan parameter yang digunakan dengan perintah buat aplikasi az iot central:
| Parameter | Deskripsi |
|---|---|
| resource-group | Grup sumber daya yang berisi aplikasi. Grup sumber daya ini harus sudah ada di langganan Anda. |
| lokasi | Secara default, perintah ini menggunakan lokasi dari grup sumber daya. Saat ini, Anda dapat membuat aplikasi IoT Central di Australia Timur, Kanada Tengah, AS Tengah, US Timur, US Timur 2, Jepang Timur, Eropa Utara, US Tengah Selatan, Asia Tenggara, UK Selatan, Eropa Barat, dan AS Barat. |
| nama | Nama aplikasi di portal Microsoft Azure. Hindari karakter khusus - sebagai gantinya, gunakan huruf kecil (a-z), angka (0-9), dan tanda hubung (-). |
| subdomain | Subdomain di URL aplikasi. Dalam contoh, URL aplikasi adalah https://mysubdomain.azureiotcentral.com. |
| sku | Saat ini, Anda dapat menggunakan ST1 atau ST2. Lihat Harga Azure IoT Central. |
| templat | Templat aplikasi yang akan digunakan. Untuk informasi selengkapnya, lihat tabel berikut ini. |
| display-name | Nama aplikasi seperti yang ditampilkan di UI. |
Templat aplikasi
| ID Templat | Nama | Industri | Deskripsi |
|---|---|---|---|
| iotc-pnp-pratinjau | Aplikasi kustom | T/A | Membuat aplikasi kosong untuk Anda isi dengan templat perangkat dan perangkat Anda sendiri. |
| iotc-kondisi | Analitik dalam toko - Pemantauan Kondisi | Retail | Membuat aplikasi untuk menghubungkan dan memantau lingkungan toko. |
| iotc-konsumsi | Pemantauan Konsumsi Air | Pemerintahan | Membuat aplikasi untuk memantau dan mengontrol aliran air. |
| iotc-distribusi | Pusat Distribusi Digital | Retail | Membuat aplikasi untuk meningkatkan efisiensi output gudang dengan mendigitalkan aset dan tindakan kunci. |
| iots-inventaris | Manajemen inventaris cerdas | Retail | Membuat aplikasi untuk mengotomatiskan penerimaan, pergerakan produk, penghitungan siklus, dan pelacakan. |
| iots-logistik | Logistik yang Terhubung | Retail | Membuat aplikasi untuk melacak pengiriman Anda secara real time di udara, air, dan darat dengan pemantauan lokasi dan kondisi. |
| iotc-meter | Analitik Meter Pintar | Energi | Membuat aplikasi untuk memantau konsumsi energi, status jaringan, dan mengidentifikasi tren untuk meningkatkan dukungan pelanggan dan manajemen meteran pintar. |
| iotc-mfc | Pusat Pemenuhan Mikro | Retail | Membuat aplikasi untuk menghubungkan dan mengelola pusat pemenuhan otomatis sepenuhnya secara digital. |
| iotc-pasien | Pemantauan Pasien Berkelanjutan | Kesehatan | Membuat aplikasi untuk memperpanjang perawatan pasien, mengurangi perujukan kembali, dan mengelola penyakit. |
| iotc-daya | Pemantauan Tenaga Surya | Energi | Membuat aplikasi untuk memantau status panel surya dan tren pembangkit energi. |
| iotc-kualitas | Pemantauan Kualitas Air | Pemerintahan | Membuat aplikasi untuk memantau kualitas air secara digital. |
| iotc-toko | Analitik dalam Toko - Tahap Selesai | Retail | Membuat aplikasi untuk memantau dan mengelola alur tahap selesai di dalam toko Anda. |
| iotc-limbah | Pengelolaan Limbah yang Terhubung | Pemerintahan | Membuat aplikasi untuk memantau tempat sampah dan mengirim operator lapangan. |
Jika Anda telah membuat templat aplikasi Anda sendiri, Anda dapat menggunakannya untuk membuat aplikasi baru. Saat dimintai templat aplikasi, masukkan ID aplikasi yang ditampilkan di tautan yang dapat dibagikan URL aplikasi yang diekspor di bagian Ekspor templat aplikasi di aplikasi Anda.
Lihat aplikasi
Gunakan perintah daftar aplikasi az iot central untuk mencantumkan aplikasi IoT Central Anda dan melihat metadata.
Mengubah aplikasi
Gunakan perintah pembaruan aplikasi az iot central untuk memperbarui metadata aplikasi IoT Central. Misalnya, untuk mengubah nama tampilan aplikasi Anda:
az iot central app update --name myiotcentralapp \
--resource-group MyIoTCentralResourceGroup \
--set displayName="My new display name"
Hapus aplikasi
Gunakan perintah hapus aplikasi az iot central untuk menghapus aplikasi IoT Central. Contohnya:
az iot central app delete --name myiotcentralapp \
--resource-group MyIoTCentralResourceGroup
Mengonfigurasi identitas terkelola
Aplikasi IoT Central dapat menggunakan identitas terkelola yang ditetapkan sistem untuk mengamankan koneksi ke tujuan ekspor data.
Untuk mengaktifkan identitas terkelola, gunakan portal Azure - Mengonfigurasi identitas terkelola atau CLI. Anda dapat mengaktifkan identitas terkelola saat membuat aplikasi IoT Central:
# Create an IoT Central application with a managed identity
az iot central app create \
--resource-group "MyIoTCentralResourceGroup" \
--name "myiotcentralapp" --subdomain "mysubdomain" \
--sku ST1 --template "iotc-pnp-preview" \
--display-name "My Custom Display Name" \
--mi-system-assigned
Atau, Anda dapat mengaktifkan identitas terkelola pada aplikasi IoT Central yang ada:
# Enable a system-assigned managed identity
az iot central app identity assign --name "myiotcentralapp" \
--resource-group "MyIoTCentralResourceGroup" \
--system-assigned
Setelah Anda mengaktifkan identitas terkelola, Anda dapat menggunakan CLI untuk mengonfigurasi penetapan peran.
Gunakan perintah az role assignment create untuk membuat penetapan peran. Misalnya, perintah berikut terlebih dahulu mengambil ID utama dari identitas terkelola. Perintah kedua menetapkan peran Azure Event Hubs Data Sender ke ID utama dalam cakupan grup sumber daya MyIoTCentralResourceGroup:
scope=$(az group show -n "MyIoTCentralResourceGroup" --query "id" --output tsv)
spID=$(az iot central app identity show \
--name "myiotcentralapp" \
--resource-group "MyIoTCentralResourceGroup" \
--query "principalId" --output tsv)
az role assignment create --assignee $spID --role "Azure Event Hubs Data Sender" \
--scope $scope
Untuk mempelajari lebih lanjut tentang tugas peran, lihat:
- Peran bawaan untuk Azure Event Hubs
- Peran bawaan untuk Bus Layanan Azure
- Peran bawaan untuk Layanan Azure Storage
Langkah berikutnya
Sekarang setelah Anda mempelajari cara mengelola aplikasi Azure IoT Central dari Azure CLI atau PowerShell, berikut adalah langkah berikutnya yang disarankan: