Rövid útmutató: Az IoT Hub Device Provisioning Service beállítása az Azure CLI-vel

Az Azure CLI az Azure-erőforrások parancssorból vagy szkriptekkel történő létrehozására és kezelésére használható. Ez a rövid útmutató részletesen ismerteti az Azure CLI használatával egy IoT Hub és egy IoT Hub Device Provisioning Service-példány létrehozását, valamint a két szolgáltatás összekapcsolását.

Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.

Fontos

Mind az IoT Hub, mind az ebben a rövid útmutatóban létrehozott kiépítési szolgáltatás nyilvánosan felderíthető LESZ DNS-végpontként. Ha úgy dönt, hogy megváltoztatja ezen erőforrások nevét, ügyeljen arra, hogy ne adjon meg bizalmas adatokat.

Előfeltételek

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Erőforráscsoport létrehozása

Hozzon létre egy erőforráscsoportot az az group create paranccsal. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat.

A következő példában létrehozunk egy my-sample-resource-group nevű erőforráscsoportot a westus helyen.

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

Tipp.

Ebben a példában az erőforráscsoport az USA nyugati régiójában jön létre. Az az account list-locations -o table parancs futtatásával megtekintheti az elérhető helyek listáját.

IoT Hub létrehozása

Egy IoT Hubot az az iot hub create paranccsal hozhat létre.

A következő példában létrehozunk egy my-sample-hub nevű IoT Hubot a westus helyen. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban, ezért adjon hozzá egy egyedi előtagot vagy utótagot a példanévhez, vagy válasszon teljesen új nevet. Győződjön meg arról, hogy a neve megfelel az IoT Hub megfelelő elnevezési konvencióinak: 3–50 karakter hosszúságúnak kell lennie, és csak kis- vagy nagybetűs alfanumerikus karaktereket vagy kötőjeleket ('-' ) tartalmazhat.

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

Device Provisioning Service-példány létrehozása

Hozzon létre egy Device Provisioning Service-példányt az az iot dps create paranccsal.

Az alábbi példa létrehoz egy Device Provisioning Service-példányt my-sample-dps néven a Westus-helyen. Globálisan egyedi nevet is ki kell választania a saját példányához. Győződjön meg arról, hogy megfelel az IoT Hub Device Provisioning Service megfelelő elnevezési konvencióinak: 3–64 karakter hosszúságúnak kell lennie, és csak kis- vagy nagybetűs alfanumerikus karaktereket vagy kötőjeleket ('-' ) tartalmazhat.

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

Tipp.

Ebben a példában az eszközkiépítési szolgáltatás az USA nyugati régiójában jön létre. Az elérhető helyek listáját az az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table parancs futtatásával vagy az Azure állapotlapjának megnyitásával, majd a „Device Provisioning Service” kifejezésre való kereséssel tekintheti meg. A parancsokban a helyek egy vagy többszavas formátumban is megadhatóak; például: westus, USA nyugati régiója, USA nyugati régiója stb. Az érték nem megkülönbözteti a kis- és nagybetűk értékét. Ha többszavas formátumot használ a hely megadásához, tegye idézőjelek közé az értéket, például: --location "West US".

A rugalmasság és a megbízhatóság érdekében javasoljuk, hogy a rendelkezésre állási zónákat támogató régiók egyikében telepítsen.

Az IoT Hub kapcsolati sztringjének lekérése

Szükség van az IoT Hub kapcsolati sztringjére a Device Provisioning Service-szel való összekapcsoláshoz. Az az iot hub connection-string show parancsával kérje le a kapcsolati sztring, és a kimenetével állítson be egy később használt változót, amikor összekapcsolja a két erőforrást.

Az alábbi példa a hub Csatlakozás ionString változót a hub iothubowner-szabályzatának elsődleges kulcsához tartozó kapcsolati sztring értékére állítja (a --policy-name paraméter egy másik szabályzat megadására használható). A korábban kiválasztott egyedi IoT Hub-névhez adja meg a saját mintaközpontot . A parancs az Azure CLI lekérdezés és kimenet lehetőségeinek használatával nyeri ki a kapcsolati sztringet a parancskimenetből.

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

A echo paranccsal megtekintheti a kapcsolati sztringet:

echo $hubConnectionString

Feljegyzés

Ez a két parancs a Bash alatt futó gazdagépek esetében érvényesek.

Ha helyi Windows/CMD-rendszerhéjat vagy PowerShell-gazdagépet használ, módosítsa a parancsokat az adott környezet megfelelő szintaxisának használatára.

Ha Azure Cloud Shellt használ, ellenőrizze, hogy a rendszerhéj ablakának bal oldalán található környezet legördülő menüben a Bash látható-e.

Az IoT Hub és az eszközkiépítési szolgáltatás csatolása

Az IoT Hub és az eszközkiépítési szolgáltatás csatolása az az iot dps linked-hub create paranccsal.

Az alábbi példa egy my-sample-hub nevű IoT Hubot kapcsol össze a Westus-helyen, és egy Device Provisioning Service-t a my-sample-dps néven. Ezeket a neveket a korábban kiválasztott egyedi IoT Hub- és Device Provisioning Service-nevekre cserélheti. A parancs a kapcsolati sztring használja a hubban tárolt IoT Hub Csatlakozás ionString változóhoz az előző lépésben.

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

A parancs végrehajtása eltarthat néhány percig.

Eszközkiépítési szolgáltatás ellenőrzése

Eszközkiépítési szolgáltatás adatainak lekérése az az iot dps show paranccsal.

Az alábbi példa lekéri a my-sample-dps nevű eszközkiépítési szolgáltatás adatait. Adja meg ezt a nevet a saját Device Provisioning Service-nevének.

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

A csatolt IoT Hub a properties.iotHubs gyűjteményben jelenik meg.

Az erőforrások eltávolítása

Az ebben a gyűjteményben lévő többi rövid útmutató erre a rövid útmutatóra épül. Ha folytatni szeretné a munkát az ezt követő rövid útmutatókkal vagy az oktatóanyagokkal, ne törölje az ebben a rövid útmutatóban létrehozott erőforrásokat. Ha nem tervezi a folytatást, az alábbi parancsokkal törölheti a kiépítési szolgáltatást, az IoT Hubot vagy az erőforráscsoportot és annak összes erőforrását. Cserélje le a következő parancsokban szereplő erőforrások nevét a saját erőforrásai nevére.

Az eszközkiépítési szolgáltatás törléséhez futtassa az az iot dps delete parancsot:

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

Az IoT Hub törléséhez futtassa az az iot hub delete parancsot:

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

Erőforráscsoport és az ahhoz tartozó összes erőforrás törléséhez futtassa az az group delete parancsot:

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

Következő lépések

Ebben a rövid útmutatóban üzembe helyezett egy IoT Hubot és egy Device Provisioning Service-példányt, és összekapcsolta a két erőforrást. Ha szeretné megtudni, hogyan használhatja ezt a beállítást egy eszköz kiépítéséhez, folytassa az eszköz létrehozásának rövid útmutatójával.

Rövid útmutató: Szimulált szimmetrikus kulcsú eszköz kiépítése