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.

Önkoşullar

Makalede açıklanan yordamlar aşağıdaki kaynakları kullanır:

  • Azure PowerShell
  • IoT hub'ı
  • Azure'da uç nokta hizmeti

Azure PowerShell

Bu makalede IoT Hub ve diğer Azure hizmetleriyle çalışmak için Azure PowerShell kullanılır. 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.

IoT merkezi

IoT hub yolu oluşturmak için Azure IoT Hub kullanarak oluşturduğunuz bir IoT hub'ına ihtiyacınız vardır. Cihaz iletileri ve olay günlükleri IoT hub'ınızdan kaynaklanır.

IoT hub rotanızı oluştururken kullanılacak aşağıdaki hub kaynağına sahip olduğunuzdan emin olun:

Uç nokta hizmeti

IoT hub yolu oluşturmak için, yola uç nokta olarak kullanmak üzere en az bir Azure hizmetine daha ihtiyacınız vardır. Uç nokta, cihaz iletilerini ve olay günlüklerini alır. IoT hub yolunuzla bağlanmak üzere uç nokta için hangi Azure hizmetini kullanacağınızı seçebilirsiniz: Event Hubs, Service Bus kuyrukları veya konuları ya da Azure Depolama.

IoT hub yolunuz bir uç nokta oluştururken kullanılacak aşağıdaki kaynaklardan birine sahip olduğunuzdan emin olun:

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

  • Service Bus kuyruğu kaynağı. Yeni bir Service Bus kuyruğu oluşturmanız gerekiyorsa bkz . Service Bus ad alanı ve kuyruğu oluşturmak için Azure PowerShell kullanma.

  • Service Bus konu kaynağı. Yeni bir Service Bus konu başlığı oluşturmanız gerekiyorsa New-AzServiceBusTopic başvurusuna ve Azure Service Bus mesajlaşma belgelerine bakın.

  • Azure Depolama kaynağı. Azure'da yeni bir depolama hesabı oluşturmanız gerekiyorsa bkz . Depolama hesabı oluşturma.

Kaynak ve uç nokta 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.

IoT hub yolunuz için uç nokta olarak bir olay hub'ı, Service Bus kuyruğu veya konusu ya da depolama hesabı kullanabilirsiniz. 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:

Olay hub’ı oluşturma

Yetkilendirme kuralı olan yeni bir Event Hubs kaynağı oluşturmak için:

  1. Yeni bir Event Hubs ad alanı oluşturun. için NamespaceNamebenzersiz bir değer kullanın.

    New-AzEventHubNamespace -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Location MyLocation

  2. Yeni Event Hubs varlığınızı oluşturun. için Namebenzersiz bir değer kullanın. için NamespaceName, önceki adımda oluşturduğunuz ad alanının adını kullanın.

    New-AzEventHub -Name MyEventHub -NamespaceName MyNamespace -ResourceGroupName MyResourceGroup

  3. Yeni bir yetkilendirme kuralı oluşturun. için Name, için EventHubNamevarlığınızın adını kullanın. Yetkilendirme kuralınızın adı için benzersiz bir değer kullanın.

    New-AzEventHubAuthorizationRule -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule -Rights @('Manage', 'Send', 'Listen')

    Erişim hakkında daha fazla bilgi için bkz . Azure Event Hubs'a erişimi yetkilendirme.

Event Hubs uç noktası oluşturma

  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.