Azure PowerShell을 사용하여 경로와 엔드포인트 만들기 및 삭제

이 문서에서는 Azure IoT Hub의 허브에서 경로 및 엔드포인트를 만든 다음 경로 및 엔드포인트를 삭제하는 방법을 보여 줍니다. Azure PowerShell을 사용하여 Azure Event Hubs, Azure Service Bus 큐 및 토픽, Azure Storage에 대한 경로 및 엔드포인트를 만드는 방법을 알아봅니다.

IoT Hub에서 라우팅의 작동 방식에 대한 자세한 내용은 IoT Hub 메시지 라우팅을 사용하여 디바이스-클라우드 메시지를 다른 엔드포인트로 보내기를 참조하세요. 메시지를 스토리지에 보내는 경로를 설정한 다음 시뮬레이션된 디바이스에서 테스트하는 방법을 알아보려면 자습서: IoT Hub 메시지 라우팅을 사용하여 디바이스 데이터를 Azure Storage로 보내기를 참조하세요.

참고 항목

현재 PowerShell은 엔드포인트를 만들기 위한 관리 ID 인증 유형을 지원하지 않습니다. 시나리오에서 SAS 인증을 사용할 수 없는 경우 다른 관리 도구 중 하나를 사용하여 엔드포인트를 만듭니다.

또한 PowerShell은 현재 Cosmos DB 엔드포인트 만들기를 지원하지 않습니다.

필수 조건

메시지를 라우팅하려는 엔드포인트 유형에 따라 이 문서의 필수 구성 요소를 검토합니다.

Event Hubs

• Azure 구독 Azure 구독이 아직 없는 경우 시작하기 전에 Azure 체험 계정을 만듭니다.

• IoT Hub. 허브가 없는 경우 단계에 따라 IoT Hub를 만들 수 있습니다.

• Azure PowerShell. Azure PowerShell을 로컬로 사용하려면 컴퓨터에 Azure PowerShell 모듈을 설치합니다. 또는 웹 브라우저에서 Azure PowerShell을 사용하려면 Azure Cloud Shell을 사용하도록 설정합니다.

• Event Hubs 리소스(컨테이너 포함). 새 Event Hubs 리소스를 만들어야 하는 경우 빠른 시작: 이벤트 허브 만들기를 참조하세요.

• (권장) Event Hubs 네임스페이스에 대한 역할 기반 액세스 제어 권한이 있는 관리 ID입니다. 자세한 내용은 Event Hubs 리소스에 액세스하기 위해 Microsoft Entra ID를 사용하여 관리 ID 인증을 참조하세요.

Azure Service Bus 큐

• Azure 구독 Azure 구독이 아직 없는 경우 시작하기 전에 Azure 체험 계정을 만듭니다.

• IoT Hub. 허브가 없는 경우 단계에 따라 IoT Hub를 만들 수 있습니다.

• Azure PowerShell. Azure PowerShell을 로컬로 사용하려면 컴퓨터에 Azure PowerShell 모듈을 설치합니다. 또는 웹 브라우저에서 Azure PowerShell을 사용하려면 Azure Cloud Shell을 사용하도록 설정합니다.

• Service Bus 큐 리소스. 새 Service Bus 큐를 만들어야 하는 경우 빠른 시작: Service Bus 네임스페이스 및 큐 만들기를 참조하세요.

• (권장) Service Bus 네임스페이스 또는 큐에 대한 역할 기반 액세스 제어 권한이 있는 관리 ID입니다. 자세한 내용은 Microsoft Entra ID를 사용하여 관리 ID 인증을 참조 하여 Azure Service Bus 리소스에 액세스합니다.

Service Bus

• Azure 구독 Azure 구독이 아직 없는 경우 시작하기 전에 Azure 체험 계정을 만듭니다.

• IoT Hub. 허브가 없는 경우 단계에 따라 IoT Hub를 만들 수 있습니다.

• Azure PowerShell. Azure PowerShell을 로컬로 사용하려면 컴퓨터에 Azure PowerShell 모듈을 설치합니다. 또는 웹 브라우저에서 Azure PowerShell을 사용하려면 Azure Cloud Shell을 사용하도록 설정합니다.

• Service Bus 토픽 리소스. 새 Service Bus 토픽을 만들어야 하는 경우 빠른 시작: Resource Manager 템플릿을 사용하여 토픽 및 구독이 있는 Service Bus 네임스페이스 만들기를 참조하세요.

• (권장) Service Bus 네임스페이스 또는 토픽에 대한 역할 기반 액세스 제어 권한이 있는 관리 ID입니다. 자세한 내용은 Microsoft Entra ID를 사용하여 관리 ID 인증을 참조 하여 Azure Service Bus 리소스에 액세스합니다.

Azure Storage

• Azure 구독 Azure 구독이 아직 없는 경우 시작하기 전에 Azure 체험 계정을 만듭니다.

• IoT Hub. 허브가 없는 경우 단계에 따라 IoT Hub를 만들 수 있습니다.

• Azure PowerShell. Azure PowerShell을 로컬로 사용하려면 컴퓨터에 Azure PowerShell 모듈을 설치합니다. 또는 웹 브라우저에서 Azure PowerShell을 사용하려면 Azure Cloud Shell을 사용하도록 설정합니다.

• Azure Storage 리소스. 새 Azure Storage 계정을 만들어야 하는 경우 스토리지 계정 만들기를 참조 하세요.

• (권장) Storage 계정에 대한 역할 기반 액세스 제어 권한이 있는 관리 ID입니다. 자세한 내용은 Blob 데이터에 액세스하기 위한 Azure 역할 할당을 참조하세요.

엔드포인트 만들기

IoT Hub에서 메시지를 보내거나 이벤트를 캡처하는 경로를 만들 수 있습니다. 각 경로에는 데이터 원본과 엔드포인트가 있습니다. 데이터 원본은 메시지 또는 이벤트 로그가 시작되는 위치입니다. 엔드포인트는 메시지 또는 이벤트 로그가 끝나는 위치입니다. IoT 허브에서 새 경로를 만들 때 데이터 원본 및 엔드포인트의 위치를 선택합니다. 그런 다음, 라우팅 쿼리를 사용하여 엔드포인트로 이동하기 전에 메시지 또는 이벤트를 필터링합니다.

엔드포인트를 만드는 데 사용하는 서비스는 먼저 Azure 계정에 있어야 합니다.

참고 항목

로컬 버전의 Azure PowerShell을 사용하는 경우 시작하기 전에 Azure PowerShell에 로그인합니다.

Event Hubs

다음 절차의 명령은 다음 참조를 사용합니다.

• Az.IotHub
• Az.EventHub

1. 이벤트 허브에서 기본 연결 문자열을 가져옵니다. 나중에 사용할 수 있게 연결 문자열을 복사합니다.

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

2. Event Hubs에 대한 새 IoT Hub 엔드포인트를 만듭니다. 이전 단계의 기본 연결 문자열을 사용합니다. EndpointType 값은 EventHub이어야 합니다. 다른 모든 매개 변수의 경우 시나리오에 대한 값을 사용합니다.

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

   모든 라우팅 엔드포인트 옵션을 보려면 Add-AzIotHubRoutingEndpoint를 참조하세요.

Azure Service Bus 큐

다음 절차의 명령은 다음 참조를 사용합니다.

• Az.IotHub
• Az.ServiceBus

새 Service Bus 큐 엔드포인트를 만들려면 다음을 수행합니다.

1. Service Bus 네임스페이스에서 기본 연결 문자열을 검색합니다. 나중에 사용할 수 있게 연결 문자열을 복사합니다.

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

2. Service Bus 큐에 새 IoT Hub 엔드포인트를 만듭니다. 끝에 ;EntityPath=MyServiceBusQueue가 추가된 이전 단계의 기본 연결 문자열을 사용합니다. EndpointType 값은 ServiceBusQueue이어야 합니다. 다른 모든 매개 변수의 경우 시나리오에 대한 값을 사용합니다. EndpointName의 경우 고유한 값을 사용합니다.

   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"
   

   모든 라우팅 엔드포인트 옵션 목록은 Add-AzIotHubRoutingEndpoint를 참조하세요.

Service Bus

다음 절차의 명령은 다음 참조를 사용합니다.

• Az.IotHub
• Az.ServiceBus

1. Service Bus 네임스페이스에서 기본 연결 문자열을 검색합니다. 나중에 사용할 수 있게 연결 문자열을 복사합니다.

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

2. Service Bus 토픽에 대한 새 IoT Hub 엔드포인트를 만듭니다. 끝에 ;EntityPath=MyServiceBusTopic이 추가된 이전 단계의 기본 연결 문자열을 사용합니다. EndpointType 값은 ServiceBusTopic이어야 합니다. 다른 모든 매개 변수의 경우 시나리오에 대한 값을 사용합니다. EndpointName의 경우 고유한 값을 사용합니다.

   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"
   

   모든 라우팅 엔드포인트 옵션 목록은 Add-AzIotHubRoutingEndpoint를 참조하세요.

Azure Storage

다음 절차의 명령은 다음 참조를 사용합니다.

• Az.IotHub
• Az.Storage

Azure Storage에 대한 엔드포인트를 만들기 위해 연결 문자열을 생성하려면 액세스 키가 필요합니다. 그런 다음 연결 문자열은 엔드포인트를 만드는 IoT Hub 명령의 일부입니다.

1. 스토리지 계정에서 액세스 키를 검색한 다음 복사합니다.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. 다음 템플릿을 기반으로 스토리지 계정에 대한 기본 연결 문자열을 생성합니다. mystorageaccount(두 위치에서)를 스토리지 계정의 이름으로 바꿉니다. mykey를 이전 단계의 키로 바꿉니다.

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

   이 연결 문자열은 엔드포인트를 만드는 단계에서 필요합니다.

3. 생성한 연결 문자열을 사용하여 Azure Storage 엔드포인트를 만듭니다. EndpointType에는 azurestorage 값이 있어야 합니다. 다른 모든 매개 변수의 경우 시나리오에 대한 값을 사용합니다. EndpointName의 경우 고유한 값을 사용합니다.

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

4. 컨테이너 이름을 입력하라는 메시지가 표시되면 컨테이너 이름을 입력한 다음 Enter 키를 선택하여 엔드포인트를 만듭니다.

IoT Hub 경로 만들기

IoT Hub에서 새 엔드포인트를 사용하여 새 경로를 만들 수 있습니다.

IoT Hub의 기본 대체 경로는 DeviceMessages에서 메시지를 수집합니다. 사용자 지정 경로에 대한 다른 옵션(예: DeviceConnectionStateEvents)을 선택합니다. 원본 옵션에 대한 자세한 내용은 Add-AzIotHubRoute를 참조하세요. Enabled 매개 변수는 스위치이므로 해당 매개 변수와 함께 값을 사용할 필요가 없습니다.

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

PowerShell은 다음 예제와 유사한 확인을 표시합니다.

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

IoT Hub 경로 업데이트

기존 경로를 변경하려면 다음 명령을 사용합니다. 예를 들어 명령을 사용하여 경로의 이름을 변경해 보세요.

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

Get-AzIotHubRoute 명령을 사용하여 경로의 변경 내용을 확인합니다.

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

엔드포인트 삭제

엔드포인트를 삭제하려면 다음을 수행합니다.

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

IoT Hub 경로 삭제

IoT Hub 경로를 삭제하려면 다음을 수행합니다.

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

팁

경로를 삭제해도 Azure 계정의 엔드포인트는 삭제되지 않습니다. 경로 삭제와 별도로 엔드포인트를 삭제해야 합니다.

다음 단계

이 방법 문서에서는 Event Hubs, Service Bus 큐 및 토픽, Azure Storage에 대한 경로 및 엔드포인트를 만드는 방법을 알아보았습니다.

메시지 라우팅에 대한 자세한 내용은 자습서: IoT Hub 메시지 라우팅을 사용하여 Azure Storage에 디바이스 데이터 보내기를 참조하세요. 이 자습서에서는 스토리지 경로를 만들고 IoT 허브의 디바이스를 사용하여 테스트합니다.