Aracılığıyla paylaş

Azure PowerShell kullanarak yolları ve uç noktaları oluşturma ve silme

  • Makale

Bu makalede, Azure IoT Hub'da hub'ınızda yol ve uç nokta oluşturma ve ardından rotanızı ve uç noktanızı silme adımları gösterilmektedir. Azure Event Hubs, Azure Service Bus kuyrukları ve konuları ile Azure Depolama için yollar ve uç noktalar oluşturmak için Azure PowerShell'i kullanmayı öğrenin.

IoT Hub'da yönlendirmenin nasıl çalıştığı hakkında daha fazla bilgi edinmek için bkz . Farklı uç noktalara cihazdan buluta ileti göndermek için IoT Hub ileti yönlendirmeyi kullanma. Depolama alanına ileti gönderen bir yol ayarlama ve ardından simülasyon cihazı üzerinde test etme adımları için bkz . Öğretici: IoT Hub ileti yönlendirmesini kullanarak cihaz verilerini Azure Depolama'ya gönderme.

Not

PowerShell şu anda uç nokta oluşturmak için yönetilen kimlik doğrulama türlerini desteklememektedir. Senaryonuzda SAS kimlik doğrulamasını kullanamıyorsanız, uç noktalar oluşturmak için diğer yönetim araçlarından birini kullanın.

Ayrıca PowerShell şu anda Cosmos DB uç noktalarının oluşturulmasını desteklememektedir.

Önkoşullar

İletileri yönlendirmek istediğiniz uç nokta türüne göre bu makalenin önkoşullarını gözden geçirin.

  • Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.

  • Bir IoT hub'ı. Hub'larınız yoksa IoT hub'ı oluşturma adımlarını izleyebilirsiniz.

  • Azure PowerShell. Azure PowerShell'i yerel olarak kullanmak için Azure PowerShell modülünü bilgisayarınıza yükleyin. Alternatif olarak, Azure PowerShell'i bir web tarayıcısında kullanmak için Azure Cloud Shell'i etkinleştirin.

  • Event Hubs kaynağı (kapsayıcı ile). Yeni bir Event Hubs kaynağı oluşturmanız gerekiyorsa bkz . Hızlı Başlangıç: Olay hub'ı oluşturma.

  • (Önerilen) Event Hubs ad alanı için rol tabanlı erişim denetimi izinlerine sahip yönetilen kimlik. Daha fazla bilgi için bkz . Event Hubs kaynaklarına erişmek için Microsoft Entra Id ile yönetilen kimliğin kimliğini doğrulama.

Uç noktalar oluşturma

IoT Hub'da, ileti göndermek veya olayları yakalamak için bir yol oluşturabilirsiniz. Her yolun bir veri kaynağı ve bir uç noktası vardır. Veri kaynağı, iletilerin veya olay günlüklerinin kaynaklandığı yerdir. Uç nokta, iletilerin veya olay günlüklerinin sona erdiği yerdir. IoT hub'ınızda yeni bir yol oluşturduğunuzda veri kaynağı ve uç nokta için konumları seçersiniz. Ardından, uç noktaya gitmeden önce iletileri veya olayları filtrelemek için yönlendirme sorgularını kullanırsınız.

Uç noktanızı oluşturmak için kullandığınız hizmetin önce Azure hesabınızda mevcut olması gerekir.

Not

Azure PowerShell'in yerel bir sürümünü kullanıyorsanız başlamadan önce Azure PowerShell'de oturum açın.

Aşağıdaki yordamlardaki komutlar şu başvuruları kullanır:

  1. Olay hub'ınızdan birincil bağlantı dizesi alın. Daha sonra kullanmak üzere bağlantı dizesi kopyalayın.

    Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule

  2. Event Hubs'a yeni bir IoT hub uç noktası oluşturun. Önceki adımdaki birincil bağlantı dizesi kullanın. için EndpointType değeri olmalıdır EventHub. Diğer tüm parametreler için senaryonuzun değerlerini kullanın.

    Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>"

    Tüm yönlendirme uç noktası seçeneklerini görmek için bkz . Add-AzIotHubRoutingEndpoint.

IoT Hub yolu oluşturma

IoT hub'ınızdaki yeni uç noktanızla yeni bir yol oluşturabilirsiniz.

IoT Hub'daki varsayılan geri dönüş yolu, 'den DeviceMessagesiletileri toplar. Özel yolunuz için gibi DeviceConnectionStateEventsfarklı bir seçenek belirleyin. Kaynak seçenekleri hakkında daha fazla bilgi için bkz . Add-AzIotHubRoute. Enabled parametresi bir anahtar olduğundan parametresiyle bir değer kullanmanız gerekmez.

Add-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -Source DeviceLifecycleEvents -EndpointName MyEndpoint -Enabled

PowerShell, şu örneğe benzer bir onay görüntüler:

RouteName     : MyIotHub 
DataSource    : DeviceLifecycleEvents
EndpointNames : MyEndpoint
Condition     : true
IsEnabled     : True

IoT Hub yolunu güncelleştirme

Mevcut bir yolda değişiklik yapmak için aşağıdaki komutu kullanın. Örneğin, komutunu kullanarak yolunuzun adını değiştirmeyi deneyin.

Set-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute

Get-AzIotHubRoute Rotanızdaki değişikliği onaylamak için komutunu kullanın:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Uç noktayı silme

Uç noktayı silmek için:

Remove-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -PassThru

IoT Hub yolunu silme

IoT Hub yolunu silmek için:

Remove-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -PassThru

İpucu

Yol silindiğinde Azure hesabınızdaki hiçbir uç nokta silinmez. Bir uç noktayı yol silmekten ayrı olarak silmeniz gerekir.

Sonraki adımlar

Bu nasıl yapılır makalesinde Event Hubs, Service Bus kuyrukları ve konuları ve Azure Depolama için yol ve uç nokta oluşturmayı öğrendiniz.

İleti yönlendirme hakkında daha fazla bilgi edinmek için bkz . Öğretici: IoT Hub ileti yönlendirmeyi kullanarak cihaz verilerini Azure Depolama'ya gönderme. Öğreticide bir depolama yolu oluşturacak ve IoT hub'ınızdaki bir cihazla test edebilirsiniz.