Cihaz yönetimi için Azure CLI için IoT Azure IoT Hub kullanma

Uz-uza diyagramı

Bu makalede, geliştirme makineniz üzerinde çeşitli yönetim seçenekleriyle Azure CLI için IoT uzantısını kullanmayı öğrenirsiniz. Azure CLI için IoT uzantısı, Azure CLI'nin özelliklerine ekleyen bir açık kaynak IoT uzantısıdır. Azure CLI, uç noktaları ve yönetim uç noktalarıyla Azure Resource Manager komutları içerir. Örneğin, Bir Azure VM veya IoT hub'ı oluşturmak için Azure CLI kullanabilirsiniz. CLI uzantısı, bir Azure hizmetinin Azure CLI'sini genişletmesine olanak sağlar ve hizmete özgü ek özelliklere erişmeniz için size erişim sağlar. IoT uzantısı, IoT geliştiricilerine cihaz sağlama hizmeti IoT Hub, IoT Edge ve IoT Hub komut satırı erişimi verir.

Yönetim seçeneği Görev
Doğrudan yöntemler Bir cihazı ileti göndermeyi başlatma veya durdurma ya da cihazı yeniden başlatma gibi bir eylemde bulundurabilirsiniz.
İstenen ikizi özellikleri LED'i yeşile ayarlama veya telemetri gönderme aralığını 30 dakikaya ayarlama gibi belirli durumlara cihaz koyabilirsiniz.
İkiz bildirilen özellikler Bir cihazın bildirilen durumunu elde edin. Örneğin, cihaz LED ışığının yanıp sönüyor olduğunu rapor ediyor.
İkiz etiketleri Cihaza özgü meta verileri bulutta depolar. Örneğin, bir satış makinesinin dağıtım konumu.
Cihaz ikizi sorguları Kullanılabilir cihazları tanımlama gibi rastgele koşullarla bu ikizleri almak için tüm cihaz ikizlerini sorgular.

Bu seçeneklerin kullanımıyla ilgili farklılıklar ve rehberlik hakkında daha ayrıntılı bir açıklama için bkz. Cihazdan buluta iletişim kılavuzu ve Buluttan cihaza iletişim kılavuzu.

Cihaz çiftleri, cihaz durumu bilgilerini (meta veriler, yapılandırmalar ve koşullar) depolayan JSON belgelerdir. IoT Hub cihaza bağlanan her cihaz için bir cihaz ikizi kalıcı olur. Cihaz ikizleri hakkında daha fazla bilgi için bkz. Kullanmaya başlayın ikizleri ile bağlantı.

Not

Bu öğreticiye başlamadan önce Raspberry PI Çevrimiçi simülatör öğreticisini veya cihaz öğreticilerinin birini doldurun. Örneğin, node.jsIle Raspberry Pi 'ye gidebilir veya Telemetriyi gönder hızlı başlangıçlarından birine gidebilirsiniz. Bu makalelerde, Azure IoT cihazınızı ve IoT Hub 'ınızı ayarlarsınız ve cihazınızda çalıştırmak üzere bir örnek uygulama dağıtırsınız. Uygulama, toplanan algılayıcı verilerini IoT Hub 'ınıza gönderir.

Not

Bu makalede, adlı Azure IoT uzantısının en yeni sürümü kullanılmıştır azure-iot . Eski sürüm çağrılır azure-cli-iot-ext . Aynı anda yalnızca bir sürümü yüklü olmalıdır. az extension listŞu anda yüklü olan uzantıları doğrulamak için komutunu kullanabilirsiniz.

az extension remove --name azure-cli-iot-extUzantının eski sürümünü kaldırmak için kullanın.

az extension add --name azure-iotUzantının yeni sürümünü eklemek için kullanın.

Yüklediğiniz uzantıları görmek için kullanın az extension list .

Not

Bu makalede açıklanan özellikler yalnızca IoT Hub standart katmanında kullanılabilir. Temel ve standart/ücretsiz IoT Hub katmanları hakkında daha fazla bilgi için bkz. doğru IoT Hub katmanını seçme.

Önkoşullar

Not

Bu makalede, adlı Azure IoT uzantısının en yeni sürümü kullanılmıştır azure-iot . Eski sürüm çağrılır azure-cli-iot-ext . Aynı anda yalnızca bir sürümü yüklü olmalıdır. az extension listŞu anda yüklü olan uzantıları doğrulamak için komutunu kullanabilirsiniz.

az extension remove --name azure-cli-iot-extUzantının eski sürümünü kaldırmak için kullanın.

az extension add --name azure-iotUzantının yeni sürümünü eklemek için kullanın.

Yüklediğiniz uzantıları görmek için kullanın az extension list .

  • IoT uzantısını yükleyin. En basit yol az extension add --name azure-iot komutunu çalıştırmaktır. IoT uzantısı benioku dosyası, uzantıyı yüklemenin birkaç yolunu açıklar.

Azure hesabınızda oturum açma

Aşağıdaki komutu çalıştırarak Azure hesabınızla oturum açın:

az login

Doğrudan yöntemler

az iot hub invoke-device-method --device-id <your device id> \
  --hub-name <your hub name> \
  --method-name <the method name> \
  --method-payload <the method payload>

Cihaz ikizi istenen özellikler

Aşağıdaki komutu çalıştırarak istenen özellik aralığını = 3000 olarak ayarlayın:

az iot hub device-twin update -n <your hub name> \
  -d <your device id> --set properties.desired.interval=3000

Bu özellik, cihazdan okunabilir.

Cihaz ikizi bildirilen özellikler

Aşağıdaki komutu çalıştırarak cihazın bildirilen özelliklerini elde edin:

az iot hub device-twin show -n <your hub name> -d <your device id>

İkiz tarafından bildirilen özelliklerden biri $metadata.$lastUpdated'dır ve cihaz uygulamasının bildirilen özellik kümesi son güncelleştirmesini gösterir.

Cihaz ikizi etiketleri

Aşağıdaki komutu çalıştırarak cihazın etiketlerini ve özelliklerini görüntüler:

az iot hub device-twin show --hub-name <your hub name> --device-id <your device id>

Aşağıdaki komutu çalıştırarak cihaza bir&rolü = sıcaklık ve nem ekleyin:

az iot hub device-twin update \
  --hub-name <your hub name> \
  --device-id <your device id> \
  --set tags='{"role":"temperature&humidity"}'

Cihaz ikizi sorguları

Aşağıdaki komutu çalıştırarak cihazları role = 'temperature&nem' etiketiyle sorgular:

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role = 'temperature&humidity'"

Aşağıdaki komutu çalıştırarak rol = 'temperature&nem' etiketine sahip olanlar dışındaki tüm cihazları sorgular:

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role != 'temperature&humidity'"

Sonraki adımlar

Cihazdan buluta iletileri izlemeyi ve IoT cihazınızla IoT cihazınız arasında buluttan cihaza iletiler göndermeyi Azure IoT Hub.

Azure IoT Hub kullanmaya başlayın ve tüm genişletilmiş IoT senaryolarını araştırmak için aşağıdakilere bakın: