Hızlı Başlangıç: Azure CLI IoT Hub Cihaz Sağlama Hizmetini ayarlama
Azure CLI, komut satırından veya betik içindeki Azure kaynaklarını oluşturmak ve yönetmek için kullanılır. Bu hızlı başlangıçta Azure CLI kullanarak bir IoT hub'ı ve IoT Hub Cihaz Sağlama Hizmeti oluşturma ve iki hizmeti bir araya bağlama hakkında ayrıntılı bilgi ve bilgiler yer alır.
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Önemli
Bu hızlı başlangıçta hem IoT hub'ı hem de sizin oluşturycuz sağlama hizmeti, DNS uç noktaları olarak genel olarak keşfedilebilir. Bu kaynaklar için kullanılan adları değiştirmeye karar verirseniz, hassas bilgiler kullanmaktan kaçının.
Önkoşullar
Azure Cloud Shell'Da Bash ortamını kullanın.
Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.
Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.
İstendiğinde, ilk kullanımda Azure CLI uzantılarını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
Kaynak grubu oluşturma
az group create komutuyla bir kaynak grubu oluşturun. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır.
Aşağıdaki örnek westus konumunda my-sample-resource-group adlı bir kaynak grubu oluşturur.
az group create --name my-sample-resource-group --location westus
İpucu
Örnekte kaynak grubu Batı ABD konumunda oluşturulur. az account list-locations -o table komutunu çalıştırarak kullanılabilir konumların listesini görüntüleyebilirsiniz.
IoT hub oluşturma
az iot hub create komutuyla bir IoT hub oluşturun.
Aşağıdaki örnekte, westus konumunda my-sample-hub adlı bir IoT hub oluşturulur. IoT hub'ı adının Azure'da genel olarak benzersiz olması gerekir, bu nedenle örnek adına benzersiz bir ön ek veya son ek eklemek ya da tamamen yeni bir ad seçmek istiyor olabilir. Adınız bir IoT hub'ı için uygun adlandırma kurallarına uygun olduğundan emin olun: 3-50 karakter uzunluğunda olmalıdır ve yalnızca büyük veya küçük harf alfasayısal karakterler veya kısa çizgi ('-') içerebilir.
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Cihaz Sağlama Hizmeti oluşturma
az iot dps create komutuyla bir Cihaz Sağlama Hizmeti oluşturun.
Aşağıdaki örnek westus konumda my-sample-dps adlı bir sağlama hizmeti oluşturur. Ayrıca kendi sağlama hizmetiniz için genel olarak benzersiz bir ad da seçmeniz gerekir. IoT Hub Cihaz Sağlama Hizmeti için uygun adlandırma kurallarına uygun olduğundan emin olun: 3-64 karakter uzunluğunda olmalıdır ve yalnızca büyük veya küçük harf alfasayısal karakterler veya kısa çizgi ('-') içerebilir.
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
İpucu
Örnekte sağlama hizmeti Batı ABD konumunda oluşturulur. az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table komutunu çalıştırarak veya Azure Durumu sayfasına gidip "Cihaz Sağlama Hizmeti" için arama yaparak kullanılabilir konumların listesini görüntüleyebilirsiniz. Komutlarda, konumlar tek sözcük veya çok sözcüklü biçimde belirtilebilir; örneğin: westus, Batı ABD, WEST US vb. Değer büyük/büyük/büyük harfe duyarlı değildir. Konumu belirtirken birden çok sözcük biçimini kullanırsanız, değeri çift tırnak içine alın; örneğin, --location "West US".
IoT hub için bağlantı dizesini alma
Cihaz Sağlama Hizmeti ile arasında bağlantı kurmak için IoT hub'ınızın bağlantı dizesine ihtiyacınız vardır. Bağlantı dizesini almak için az iot hub show-connection-string komutunu kullanın ve komutunu çıkışını kullanarak iki kaynağı bağlarken kullanacağınız değişkeni ayarlayın.
Aşağıdaki örnek hubConnectionString değişkenini hub'ın iothubowner ilkesi birincil anahtarı için bağlantı dizesinin değerine ayarlar (parametresi farklı bir ilke belirtmek --policy-name için kullanılabilir). My-sample-hub yerine daha önce seçtiğiniz benzersiz IoT hub adını yazın. Komut, komut çıkışından bağlantı dizesini ayıklamak için Azure CLI query ve output seçeneklerini kullanır.
hubConnectionString=$(az iot hub show-connection-string --name my-sample-hub --key primary --query connectionString -o tsv)
Bağlantı dizesini görmek için echo komutunu kullanabilirsiniz.
echo $hubConnectionString
Not
Bu iki komut, Bash altında çalışan konaklar için geçerlidir.
Yerel bir Windows/CMD kabuğu veya PowerShell ana bilgisayarı kullanıyorsanız, komutları bu ortam için doğru söz dizimlerini kullanmak üzere değiştirebilirsiniz.
Ortam denetimi Azure Cloud Shell, kabuk penceresinin sol tarafındaki ortam açılan listesinde Bash ifadesinin olup olamay olduğunu kontrol edin.
IoT hub ile cihaz sağlama hizmetini bağlama
IoT hub ile sağlama hizmetinizi bağlamak için az iot dps linked-hub create komutunu kullanın.
Aşağıdaki örnek westus konumda my-sample-hub adlı bir IoT hub'ı ile my-sample-dps adlı bir Cihaz Sağlama Hizmeti arasında bağlantı sağlar. Bu adları daha önce seçtiğiniz benzersiz IoT hub'ı ve Cihaz Sağlama Hizmeti adları ile takas edin. Komut, önceki adımda hubConnectionString değişkenini depolanmış olan IoT hub'ın bağlantı dizesini kullanır.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Komutun tamamlanması birkaç dakika sürebilir.
Sağlama hizmetini doğrulama
az iot dps show komutuyla sağlama hizmetinizin ayrıntılarını alın.
Aşağıdaki örnekte my-sample-dps adlı sağlama hizmetinin ayrıntıları alınır. Bu adı kendi Cihaz Sağlama Hizmeti adınızla takas edin.
az iot dps show --name my-sample-dps
Bağlı IoT hub, properties.iotHubs koleksiyonunda gösterilir.
Kaynakları temizleme
Bu koleksiyondaki diğer hızlı başlangıçlar, bu hızlı başlangıcı temel alır. Sonraki hızlı başlangıçlar veya öğreticilerle devam etmeyi planlıyorsanız, bu hızlı başlangıçta oluşturulan kaynakları temizlemeyin. Devam etmeyi planlamıyorsanız, aşağıdaki komutları kullanarak sağlama hizmetini, IoT hub'ı veya kaynak grubuyla bu grubun tüm kaynaklarını silebilirsiniz. Aşağıda yazılan kaynakların adlarını kendi kaynak adlarınızı ile değiştirin.
Sağlama hizmetini silmek için az iot dps delete komutunu çalıştırın:
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
IoT hub'ı silmek için az iot hub delete komutunu çalıştırın:
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Kaynak grubuyla birlikte bu kaynak grubunun tüm kaynaklarını silmek için az group delete komutunu çalıştırın:
az group delete --name my-sample-resource-group
Sonraki adımlar
Bu hızlı başlangıçta bir IoT hub'ı ve bir Cihaz Sağlama Hizmeti örneği dağıttınız ve iki kaynağı birbirine bağlandınız. Bu kurulumu kullanarak bir simülasyon cihazı sağlama hakkında bilgi edinmek için sanal cihaz oluşturma hızlı başlangıç ile devam edin.