Bagikan melalui


Mulai Cepat - IoT Hub Device Provisioning Service menggunakan Azure CLI

Azure CLI digunakan untuk membuat dan mengelola sumber daya Azure dari baris perintah atau dalam skrip. Detail mulai cepat ini menggunakan Azure CLI untuk membuat hub IoT dan instans IoT Hub Device Provisioning Service, dan untuk menautkan dua layanan bersama-sama.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Penting

Hub IoT dan layanan provisi yang Anda buat dalam quickstart ini akan dapat ditemukan secara publik sebagai titik akhir DNS. Pastikan untuk menghindari informasi sensitif jika Anda memutuskan untuk mengubah nama yang digunakan untuk sumber daya ini.

Prasyarat

Buat grup sumber daya

Buat grup sumber daya dengan perintah az group create. Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure disebarkan dan dikelola.

Contoh berikut ini menampilkan cara membuat grup sumber daya bernama my-sample-resource-group di lokasi westus.

az group create --name my-sample-resource-group --location westus

Tip

Contohnya membuat grup sumber daya di lokasi AS Barat. Anda bisa menampilkan daftar lokasi yang tersedia dengan menjalankan az account list-locations -o table perintah.

Membuat IoT Hub

Buat IoT Hub menggunakan perintah az iot hub create.

Contoh berikut membuat hub IoT bernama my-sample-hub di lokasi westus. Nama hub IoT harus unik secara global di Azure, jadi tambahkan awalan atau akhiran unik ke nama contoh atau pilih nama baru sama sekali. Pastikan nama Anda mengikuti konvensi penamaan yang tepat untuk hub IoT: panjangnya harus 3-50 karakter, dan hanya dapat berisi karakter alfanumerik huruf besar atau kecil atau tanda hubung ('-').

az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus

Membuat instans Device Provisioning Service

Buat instans Device Provisioning Service dengan perintah az iot dps create .

Contoh berikut membuat instans Device Provisioning Service bernama my-sample-dps di lokasi westus . Anda juga harus memilih nama unik global untuk instans Anda sendiri. Pastikan mengikuti konvensi penamaan yang tepat untuk IoT Hub Device Provisioning Service: panjangnya harus 3-64 karakter dan hanya dapat berisi karakter alfanumerik huruf besar atau kecil atau tanda hubung ('-').

az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus

Tip

Contohnya membuat layanan provisi di lokasi AS Barat. Anda dapat melihat daftar lokasi yang tersedia dengan menjalankan perintah az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table atau dengan membuka laman Status Azure dan mencari "Device Provisioning Service". Dalam perintah, lokasi dapat ditentukan baik dalam format satu kata atau multi-kata; misal: westus, US Barat, US BARAT, dll. Nilainya tidak peka huruf besar/kecil. Jika Anda menggunakan format multi-kata untuk menentukan lokasi, sertakan nilai dalam tanda kutip; misalnya, --location "West US".

Untuk ketahanan dan keandalan, sebaiknya sebarkan ke salah satu wilayah yang mendukung Zona Ketersediaan.

Dapatkan string koneksi untuk hub IoT

Anda memerlukan string koneksi hub IoT Anda untuk menautkannya dengan Device Provisioning Service. Gunakan perintah az iot hub connection-string show untuk mendapatkan string koneksi dan menggunakan outputnya untuk mengatur variabel yang digunakan nanti, saat Anda menautkan dua sumber daya.

Contoh berikut menetapkan variabel hubConnectionString ke nilai string koneksi untuk kunci utama kebijakan iothubowner hub --policy-name (parameter dapat digunakan untuk menentukan kebijakan yang berbeda). Perdagangkan my-sample-hub untuk nama hub IoT unik yang Anda pilih sebelumnya. Perintah ini menggunakan kueri Azure CLI dan opsi output untuk mengekstrak string koneksi dari output perintah.

hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)

Anda dapat menggunakan echo perintah untuk melihat string koneksi.

echo $hubConnectionString

Catatan

Kedua perintah ini berlaku untuk host yang berjalan di bawah Bash.

Jika Anda menggunakan shell Windows/CMD lokal atau host PowerShell, ubah perintah untuk menggunakan sintaks yang benar untuk lingkungan tersebut.

Jika Anda menggunakan Azure Cloud Shell, periksa apakah lingkungan turun bawah di sisi kiri jendela shell mengatakan Bash.

Tautkan hub IoT dan layanan provisi Anda dengan perintah buat hub tertaut az iot dps.

Contoh berikut menautkan hub IoT bernama my-sample-hubdi lokasi westus dan Device Provisioning Service bernama my-sample-dps. Perdagangkan nama-nama ini untuk hub IoT unik dan nama Device Provisioning Service yang Anda pilih sebelumnya. Perintah ini menggunakan string koneksi untuk hub IoT Anda yang disimpan dalam variabel hubConnectionString pada langkah sebelumnya.

az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus

Perintah ini mungkin perlu waktu beberapa menit untuk diselesaikan.

Memverifikasi layanan provisi

Dapatkan detail layanan provisi Anda dengan perintah pertunjukan az iot dps.

Contoh berikut mendapatkan detail layanan provisi bernama my-sample-dps. Ganti nama ini dengan nama Device Provisioning Service Anda sendiri.

az iot dps show --name my-sample-dps

Hub IoT yang ditautkan ditampilkan dalam koleksi properties.iotHubs.

Memverifikasi Layanan Provisi

Membersihkan sumber daya

Panduan mulai cepat yang lain dalam koleksi ini dibangun berdasarkan panduan mulai cepat ini. Jika Anda berencana untuk terus bekerja dengan mulai cepat berikutnya atau dengan tutorial, jangan bersihkan sumber daya yang dibuat dalam mulai cepat ini. Jika Anda tidak berencana untuk melanjutkan, Anda dapat menggunakan perintah berikut untuk menghapus layanan provisi, hub IoT, atau grup sumber daya dan semua sumber dayanya. Ganti nama sumber daya yang disertakan dalam perintah berikut dengan nama sumber daya Anda sendiri.

Untuk menghapus layanan provisi, jalankan perintah hapus az iot dps:

az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group

Untuk menghapus IoT hub, jalankan perintah hapus az iot dps:

az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group

Untuk menghapus grup sumber daya dan semua sumber dayanya, jalankan perintah hapus grup az:

az group delete --name my-sample-resource-group

Langkah berikutnya

Dalam mulai cepat ini, Anda menyebarkan hub IoT dan instans Device Provisioning Service, dan menautkan dua sumber daya. Untuk mempelajari cara menggunakan penyetelan ini untuk provisikan perangkat, lanjutkan ke mulai cepat untuk membuat perangkat.