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

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ı ve Azure Depolama için yollar ve uç noktalar oluşturmak üzere Azure PowerShell kullanmayı öğrenin.

yönlendirmenin IoT Hub nasıl çalıştığı hakkında daha fazla bilgi edinmek için bkz. Cihazdan buluta iletileri farklı uç noktalara 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ında test etme adımlarını görmek için bkz. Öğretici: IoT Hub ileti yönlendirmeyi 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 bir 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 yerel olarak kullanmak için Azure PowerShell modülünü bilgisayarınıza yükleyin. Alternatif olarak, Azure PowerShell bir web tarayıcısında kullanmak için Azure Cloud Shell'yi etkinleştirin.

IoT hub'ı

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 aşağıdaki hub kaynağına sahip olduğunuzdan emin olun:

• Azure aboneliğinizde bir IoT hub'ı. Henüz bir hub'ına sahip değilseniz, New-AzIotHub PowerShell cmdlet'ini kullanarak IoT hub'ı oluşturma adımlarını izleyebilirsiniz.

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ı veya 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ılı). 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 konusu 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, iletileri veya olayları uç noktaya gitmeden önce 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 yerel bir sürümünü kullanıyorsanız başlamadan önce Azure PowerShell oturum açın.

Event Hubs

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

• Az.IotHub
• Az.EventHub

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 Nameiçin varlığınızın EventHubNameadı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 erişimi yetkilendirme.

Event Hubs uç noktası oluşturma

1. Olay hub'ınızdan birincil bağlantı dizesini alın. Daha sonra kullanmak için bağlantı dizesini kopyalayın.

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

2. Event Hubs için yeni bir IoT hub uç noktası oluşturun. Önceki adımdaki birincil bağlantı dizenizi 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.

Service Bus kuyruğu

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

• Az.IotHub
• Az.ServiceBus

Service Bus ad alanı ve kuyruğu oluşturma

Yeni bir Service Bus kuyruğu kaynağı oluşturmak için:

1. Yeni bir Service Bus ad alanı oluşturun. için Namebenzersiz bir değer kullanın.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Yeni bir Service Bus kuyruğu oluşturun. için NamespaceName, önceki adımda oluşturduğunuz ad alanının adını kullanın. Kuyruğunuzun adı için benzersiz bir değer kullanın.

   New-AzServiceBusQueue -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyQueue
   

Service Bus kuyruk uç noktası oluşturma

Yeni bir Service Bus kuyruğu uç noktası oluşturmak için:

1. Service Bus ad alanınızdan birincil bağlantı dizesini alın. Daha sonra kullanmak için bağlantı dizesini kopyalayın.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Service Bus kuyruğunuz için yeni bir IoT hub uç noktası oluşturun. Önceki adımdaki birincil bağlantı dizenizi sonuna eklenmiş olarak ;EntityPath=MyServiceBusQueue kullanın. için EndpointType değeri olmalıdır ServiceBusQueue. Diğer tüm parametreler için senaryonuzun değerlerini kullanın. için EndpointNamebenzersiz bir değer 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;EntityPath=MyServiceBusQueue"
   

   Tüm yönlendirme uç noktası seçeneklerinin listesi için bkz. Add-AzIotHubRoutingEndpoint.

Service Bus konusu

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

• Az.IotHub
• Az.ServiceBus

Service Bus konularıyla, kullanıcılar bir veya daha fazla konuya abone olabilir. Konu oluşturmak için bir Service Bus ad alanı ve aboneliği de oluşturursunuz.

Service Bus ad alanı, konusu ve aboneliği oluşturma

1. Yeni bir Service Bus ad alanı oluşturun. Ad Name alanınız için benzersiz bir değer kullanın.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Yeni bir Service Bus konusu oluşturun. Konu adı için benzersiz bir değer kullanın.

   New-AzServiceBusTopic -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyTopic
   

3. Konunuz için yeni bir abonelik oluşturun. için TopicName, önceki adımda oluşturduğunuz konunun adını kullanın. Abonelik adınız için benzersiz bir değer kullanın.

   New-AzServiceBusSubscription -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -TopicName MyTopic -Name MySubscription
   

Service Bus konu uç noktası oluşturma

1. Service Bus ad alanınızdan birincil bağlantı dizesini alın. Daha sonra kullanmak için bağlantı dizesini kopyalayın.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Service Bus konu başlığınıza yeni bir IoT hub uç noktası oluşturun. Önceki adımdaki birincil bağlantı dizenizi sonuna eklenmiş olarak ;EntityPath=MyServiceBusTopic kullanın. için EndpointType değeri olmalıdır ServiceBusTopic. Diğer tüm parametreler için senaryonuzun değerlerini kullanın. için EndpointNamebenzersiz bir değer kullanın.

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

   Tüm yönlendirme uç noktası seçeneklerinin listesi için bkz. Add-AzIotHubRoutingEndpoint.

Azure Depolama

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

• Az.IotHub
• Az.Storage

Azure Depolama uç noktası ve yolu oluşturmak için bir Depolama hesabı ve kapsayıcı gerekir.

Azure Depolama hesabı ve kapsayıcısı oluşturma

1. Yeni bir Azure Depolama hesabı oluşturun. Depolama hesabınızın değeri Name yalnızca küçük harf ve sayı içerebilir. Seçenekler için SkuName bkz . SkuName.

   New-AzStorageAccount -ResourceGroupName MyResourceGroup -Name mystorageaccount -Location westus -SkuName Standard_GRS
   

2. Depolama hesabınızda yeni bir kapsayıcı oluşturun. Bir değişkende depolama hesabınıza bağlam oluşturmanız ve ardından değişkeni parametresine Context eklemeniz gerekir. Kapsayıcı oluştururken seçenekleriniz hakkında bilgi edinmek için bkz. PowerShell kullanarak blob kapsayıcılarını yönetme. için Namekapsayıcınızın adı için benzersiz bir değer kullanın.

   $ctx = New-AzStorageContext -StorageAccountName mystorageaccount -UseConnectedAccount `
   New-AzStorageContainer -Name ContainerName -Context $ctx
   

Azure Depolama uç noktası oluşturma

Azure Depolama'ya uç nokta oluşturmak için erişim anahtarınızın bir bağlantı dizesi oluşturması gerekir. Bağlantı dizesi daha sonra uç nokta oluşturmak için IoT Hub komutunun bir parçasıdır.

1. Erişim anahtarınızı depolama hesabınızdan alın ve kopyalayın.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Aşağıdaki şablona göre depolama hesabınız için bir birincil bağlantı dizesi oluşturun. değerini (iki yerde) depolama hesabınızın adıyla değiştirin mystorageaccount . değerini önceki adımdaki anahtarınız ile değiştirin mykey .

   "DefaultEndpointsProtocol=https;BlobEndpoint=https://mystorageaccount.blob.core.windows.net;AccountName=mystorageaccount;AccountKey=mykey"
   

   Bu bağlantı dizesi, uç noktayı oluşturmak için adımında gereklidir.

3. Oluşturduğunuz bağlantı dizesiyle Azure Depolama uç noktanızı oluşturun. EndpointType değerine azurestoragesahip olmalıdır. Diğer tüm parametreler için senaryonuzun değerlerini kullanın. için EndpointNamebenzersiz bir değer kullanın.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType azurestorage -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "my connection string"
   

4. Kapsayıcı adınızı girmeniz istendiğinde, kapsayıcı adınızı girin ve ardından Enter'ı seçerek uç noktayı oluşturun.

IoT Hub yolu oluşturma

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

IoT Hub'daki varsayılan geri dönüş yolu, 'den DeviceMessagesiletileri toplar. Özel yolunuz DeviceConnectionStateEventsiçin gibi farklı bir seçenek belirleyin. Kaynak seçenekleri hakkında daha fazla bilgi için bkz. Add-AzIotHubRoute. Enabled parametresi bir anahtardır, bu nedenle 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 rotasını 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 yolu silme

bir IoT Hub yolunu silmek için:

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

İpucu

Bir yol silindiğinde Azure hesabınızdaki hiçbir uç nokta silinmez. Uç noktayı bir rotayı 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.