az iot hub
참고 항목
이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.
Azure IoT Hub를 관리합니다.
명령
Name | Description | 형식 | 상태 |
---|---|---|---|
az iot hub certificate |
IoT Hub 인증서를 관리합니다. |
코어 및 확장 | GA |
az iot hub certificate create |
Azure IoT Hub 인증서를 만들거나 업로드합니다. |
핵심 | GA |
az iot hub certificate delete |
Azure IoT Hub 인증서를 삭제합니다. |
핵심 | GA |
az iot hub certificate generate-verification-code |
Azure IoT Hub 인증서에 대한 확인 코드를 생성합니다. |
핵심 | GA |
az iot hub certificate list |
Azure IoT Hub 내에 포함된 모든 인증서를 나열합니다. |
핵심 | GA |
az iot hub certificate root-authority |
IoT Hub 인스턴스에 대한 인증서 루트 기관을 관리합니다. |
내선 번호 | 더 이상 사용되지 않음 |
az iot hub certificate root-authority set |
IoT Hub 인스턴스에 대한 인증서 루트 기관을 특정 버전으로 설정합니다. |
내선 번호 | 더 이상 사용되지 않음 |
az iot hub certificate root-authority show |
IoT Hub 인스턴스에 대한 현재 인증서 루트 기관을 표시합니다. |
내선 번호 | 더 이상 사용되지 않음 |
az iot hub certificate show |
특정 Azure IoT Hub 인증서에 대한 정보를 표시합니다. |
핵심 | GA |
az iot hub certificate update |
Azure IoT Hub 인증서를 업데이트합니다. |
핵심 | GA |
az iot hub certificate verify |
Azure IoT Hub 인증서를 확인합니다. |
핵심 | GA |
az iot hub configuration |
대규모로 IoT 자동 디바이스 관리 구성을 관리합니다. |
내선 번호 | GA |
az iot hub configuration create |
대상 IoT Hub에서 IoT 자동 디바이스 관리 구성을 만듭니다. |
내선 번호 | GA |
az iot hub configuration delete |
IoT 디바이스 구성을 삭제합니다. |
내선 번호 | GA |
az iot hub configuration list |
IoT Hub에서 IoT 자동 디바이스 관리 구성을 나열합니다. |
내선 번호 | GA |
az iot hub configuration show |
IoT 자동 디바이스 관리 구성의 세부 정보를 가져옵니다. |
내선 번호 | GA |
az iot hub configuration show-metric |
IoT 디바이스 구성에 정의된 대상 사용자 또는 시스템 메트릭을 평가합니다. |
내선 번호 | GA |
az iot hub configuration update |
IoT 자동 디바이스 관리 구성의 지정된 속성을 업데이트합니다. |
내선 번호 | GA |
az iot hub connection-string |
IoT Hub 연결 문자열 관리합니다. |
내선 번호 | GA |
az iot hub connection-string show |
지정된 정책 이름 및 키를 사용하여 지정된 IoT Hub에 대한 연결 문자열 표시합니다. |
내선 번호 | GA |
az iot hub consumer-group |
IoT Hub의 이벤트 허브 소비자 그룹을 관리합니다. |
핵심 | GA |
az iot hub consumer-group create |
이벤트 허브 소비자 그룹을 만듭니다. |
핵심 | GA |
az iot hub consumer-group delete |
이벤트 허브 소비자 그룹을 삭제합니다. |
핵심 | GA |
az iot hub consumer-group list |
이벤트 허브 소비자 그룹을 나열합니다. |
핵심 | GA |
az iot hub consumer-group show |
이벤트 허브 소비자 그룹에 대한 세부 정보를 가져옵니다. |
핵심 | GA |
az iot hub create |
Azure IoT Hub를 만듭니다. |
핵심 | GA |
az iot hub delete |
IoT Hub를 삭제합니다. |
핵심 | GA |
az iot hub device-identity |
IoT 디바이스를 관리합니다. |
내선 번호 | GA |
az iot hub device-identity children |
IoT Edge 디바이스에 대한 자식 디바이스 관계를 관리합니다. |
내선 번호 | GA |
az iot hub device-identity children add |
대상 에지 디바이스에 디바이스를 자식으로 추가합니다. |
내선 번호 | GA |
az iot hub device-identity children list |
할당된 자식 디바이스의 컬렉션을 출력합니다. |
내선 번호 | GA |
az iot hub device-identity children remove |
대상 에지 디바이스에서 자식 디바이스를 제거합니다. |
내선 번호 | GA |
az iot hub device-identity connection-string |
IoT 디바이스의 연결 문자열 관리합니다. |
내선 번호 | GA |
az iot hub device-identity connection-string show |
지정된 IoT Hub 디바이스 연결 문자열 표시합니다. |
내선 번호 | GA |
az iot hub device-identity create |
IoT Hub에서 디바이스를 만듭니다. |
내선 번호 | GA |
az iot hub device-identity delete |
IoT Hub 디바이스를 삭제합니다. |
내선 번호 | GA |
az iot hub device-identity export |
모든 디바이스 ID를 IoT Hub에서 Azure Storage Blob 컨테이너로 내보냅니다. |
내선 번호 | GA |
az iot hub device-identity import |
스토리지 컨테이너 Blob에서 IoT Hub로 디바이스 ID를 가져옵니다. |
내선 번호 | GA |
az iot hub device-identity list |
IoT Hub에서 디바이스를 나열합니다. |
내선 번호 | GA |
az iot hub device-identity parent |
IoT 디바이스에 대한 부모 디바이스 관계를 관리합니다. |
내선 번호 | GA |
az iot hub device-identity parent set |
대상 디바이스의 부모 디바이스를 설정합니다. |
내선 번호 | GA |
az iot hub device-identity parent show |
대상 디바이스의 부모 디바이스를 가져옵니다. |
내선 번호 | GA |
az iot hub device-identity renew-key |
sas 인증을 사용하여 IoT Hub 디바이스의 대상 키를 갱신합니다. |
내선 번호 | GA |
az iot hub device-identity show |
IoT Hub 디바이스의 세부 정보를 가져옵니다. |
내선 번호 | GA |
az iot hub device-identity update |
IoT Hub 디바이스를 업데이트합니다. |
내선 번호 | GA |
az iot hub device-twin |
IoT 디바이스 쌍 구성을 관리합니다. |
내선 번호 | GA |
az iot hub device-twin list |
IoT Hub에서 디바이스 쌍을 나열합니다. |
내선 번호 | GA |
az iot hub device-twin replace |
디바이스 쌍 정의를 대상 json으로 대체합니다. |
내선 번호 | GA |
az iot hub device-twin show |
디바이스 쌍 정의를 가져옵니다. |
내선 번호 | GA |
az iot hub device-twin update |
디바이스 쌍 desired 속성 및 태그를 업데이트합니다. |
내선 번호 | GA |
az iot hub devicestream |
IoT 허브의 디바이스 스트림을 관리합니다. |
핵심 | 프리뷰 |
az iot hub devicestream show |
IoT Hub의 디바이스 스트림 엔드포인트를 가져옵니다. |
핵심 | 프리뷰 |
az iot hub digital-twin |
IoT Hub 디바이스의 디지털 트윈을 조작하고 상호 작용합니다. |
내선 번호 | GA |
az iot hub digital-twin invoke-command |
디지털 트윈 디바이스의 루트 또는 구성 요소 수준 명령을 호출합니다. |
내선 번호 | GA |
az iot hub digital-twin show |
IoT Hub 디바이스의 디지털 트윈을 표시합니다. |
내선 번호 | GA |
az iot hub digital-twin update |
JSON 패치 사양을 통해 디지털 트윈 디바이스의 읽기-쓰기 속성을 업데이트합니다. |
내선 번호 | GA |
az iot hub distributed-tracing |
디바이스별 분산 설정을 관리합니다. |
내선 번호 | 프리뷰 |
az iot hub distributed-tracing show |
디바이스에 대한 분산 추적 설정을 가져옵니다. |
내선 번호 | 프리뷰 |
az iot hub distributed-tracing update |
디바이스에 대한 분산 추적 옵션을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub generate-sas-token |
대상 IoT Hub, 디바이스 또는 모듈에 대한 SAS 토큰을 생성합니다. |
내선 번호 | GA |
az iot hub identity |
Azure IoT Hub의 ID를 관리합니다. |
핵심 | GA |
az iot hub identity assign |
관리 ID를 IoT Hub에 할당합니다. |
핵심 | GA |
az iot hub identity remove |
IoT Hub에서 관리 ID를 제거합니다. |
핵심 | GA |
az iot hub identity show |
IoT Hub의 ID 속성을 표시합니다. |
핵심 | GA |
az iot hub invoke-device-method |
디바이스 메서드를 호출합니다. |
내선 번호 | GA |
az iot hub invoke-module-method |
모듈 메서드를 호출합니다. |
내선 번호 | GA |
az iot hub job |
IoT Hub 작업(v2)을 관리합니다. |
내선 번호 | GA |
az iot hub job cancel |
IoT Hub 작업을 취소합니다. |
내선 번호 | GA |
az iot hub job create |
실행을 위해 IoT Hub 작업을 만들고 예약합니다. |
내선 번호 | GA |
az iot hub job list |
IoT Hub의 기록 작업을 나열합니다. |
내선 번호 | GA |
az iot hub job show |
기존 IoT Hub 작업의 세부 정보를 표시합니다. |
내선 번호 | GA |
az iot hub list |
IoT Hub를 나열합니다. |
핵심 | GA |
az iot hub list-skus |
사용 가능한 가격 책정 계층을 나열합니다. |
핵심 | GA |
az iot hub manual-failover |
IoT Hub에서지역 쌍으로 연결된 재해 복구 지역으로의 수동 장애 조치(failover)를 시작합니다. |
핵심 | GA |
az iot hub message-endpoint |
IoT 허브의 사용자 지정 엔드포인트를 관리합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint create |
IoT Hub에 엔드포인트를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint create cosmosdb-container |
IoT Hub에 대한 Cosmos DB 컨테이너 엔드포인트를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint create eventhub |
IoT Hub에 대한 이벤트 허브 엔드포인트를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint create servicebus-queue |
IoT Hub에 대한 Service Bus 큐 엔드포인트를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint create servicebus-topic |
IoT Hub에 대한 Service Bus 토픽 엔드포인트를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint create storage-container |
IoT Hub에 대한 스토리지 컨테이너 엔드포인트를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint delete |
IoT Hub에 대한 모든 또는 특정 엔드포인트를 삭제합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint list |
IoT Hub의 모든 엔드포인트에 대한 정보를 가져옵니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint show |
IoT Hub에 대한 멘션 엔드포인트에 대한 정보를 가져옵니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint update |
IoT Hub에 대한 기존 엔드포인트의 속성을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint update cosmosdb-container |
IoT Hub에 대한 기존 Cosmos DB 컨테이너 엔드포인트의 속성을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint update eventhub |
IoT Hub에 대한 기존 Event Hub 엔드포인트의 속성을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint update servicebus-queue |
IoT Hub에 대한 기존 Service Bus 큐 엔드포인트의 속성을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint update servicebus-topic |
IoT Hub에 대한 기존 Service Bus 토픽 엔드포인트의 속성을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-endpoint update storage-container |
IoT Hub에 대한 기존 스토리지 컨테이너 엔드포인트의 속성을 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-enrichment |
IoT Hub 엔드포인트에 대한 메시지 보강을 관리합니다. |
핵심 | GA |
az iot hub message-enrichment create |
IoT Hub에서 선택한 엔드포인트에 대한 메시지 보강을 만듭니다. |
핵심 | GA |
az iot hub message-enrichment delete |
키로 IoT Hub에서 메시지 보강을 삭제합니다. |
핵심 | GA |
az iot hub message-enrichment list |
IoT Hub에 대한 모든 메시지 보강에 대한 정보를 가져옵니다. |
핵심 | GA |
az iot hub message-enrichment update |
키로 IoT Hub에서 메시지 보강을 업데이트합니다. |
핵심 | GA |
az iot hub message-route |
IoT 허브의 경로를 관리합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route create |
IoT Hub에 대한 경로를 추가합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route delete |
IoT Hub에서 모든 경로 또는 멘션 경로를 삭제합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route fallback |
IoT Hub의 대체 경로를 관리합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route fallback set |
IoT Hub에서 대체 경로를 사용하거나 사용하지 않도록 설정합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route fallback show |
IoT Hub의 대체 경로를 표시합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route list |
IoT Hub의 모든 경로를 가져옵니다. |
내선 번호 | 프리뷰 |
az iot hub message-route show |
IoT Hub에서 경로에 대한 정보를 가져옵니다. |
내선 번호 | 프리뷰 |
az iot hub message-route test |
IoT Hub에서 모든 경로 또는 멘션 경로를 테스트합니다. |
내선 번호 | 프리뷰 |
az iot hub message-route update |
IoT Hub에 대한 경로를 업데이트합니다. |
내선 번호 | 프리뷰 |
az iot hub module-identity |
IoT 디바이스 모듈을 관리합니다. |
내선 번호 | GA |
az iot hub module-identity connection-string |
IoT 디바이스 모듈의 연결 문자열 관리합니다. |
내선 번호 | GA |
az iot hub module-identity connection-string show |
대상 IoT 디바이스 모듈 연결 문자열 표시합니다. |
내선 번호 | GA |
az iot hub module-identity create |
IoT Hub의 대상 IoT 디바이스에 모듈을 만듭니다. |
내선 번호 | GA |
az iot hub module-identity delete |
IoT Hub에서 디바이스를 삭제합니다. |
내선 번호 | GA |
az iot hub module-identity list |
IoT Hub의 IoT 디바이스에 있는 모듈을 나열합니다. |
내선 번호 | GA |
az iot hub module-identity renew-key |
sas 인증을 사용하여 IoT Hub 디바이스 모듈의 대상 키를 갱신합니다. |
내선 번호 | GA |
az iot hub module-identity show |
IoT Hub에서 IoT 디바이스 모듈의 세부 정보를 가져옵니다. |
내선 번호 | GA |
az iot hub module-identity update |
IoT Hub 디바이스 모듈을 업데이트합니다. |
내선 번호 | GA |
az iot hub module-twin |
IoT 디바이스 모듈 쌍 구성을 관리합니다. |
내선 번호 | GA |
az iot hub module-twin replace |
모듈 쌍 정의를 대상 json으로 대체합니다. |
내선 번호 | GA |
az iot hub module-twin show |
모듈 쌍 정의를 표시합니다. |
내선 번호 | GA |
az iot hub module-twin update |
모듈 쌍 desired 속성 및 태그를 업데이트합니다. |
내선 번호 | GA |
az iot hub monitor-events |
IoT Hub로 전송된 디바이스 원격 분석 및 메시지를 모니터링합니다. |
내선 번호 | GA |
az iot hub monitor-feedback |
디바이스에서 보낸 피드백을 모니터링하여 C2D(클라우드-디바이스) 메시지를 승인합니다. |
내선 번호 | GA |
az iot hub policy |
IoT 허브의 공유 액세스 정책을 관리합니다. |
핵심 | GA |
az iot hub policy create |
IoT Hub에서 새 공유 액세스 정책을 만듭니다. |
핵심 | GA |
az iot hub policy delete |
IoT Hub에서 공유 액세스 정책을 삭제합니다. |
핵심 | GA |
az iot hub policy list |
IoT Hub의 공유 액세스 정책을 나열합니다. |
핵심 | GA |
az iot hub policy renew-key |
IoT Hub의 공유 액세스 정책 키를 다시 생성합니다. |
핵심 | GA |
az iot hub policy show |
IoT Hub의 공유 액세스 정책에 대한 세부 정보를 가져옵니다. |
핵심 | GA |
az iot hub query |
강력한 SQL 같은 언어를 사용하여 IoT Hub를 쿼리합니다. |
내선 번호 | GA |
az iot hub route |
IoT 허브의 경로를 관리합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub route create |
IoT Hub에서 경로를 만듭니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub route delete |
IoT Hub에 대한 전체 또는 멘션 경로를 삭제합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub route list |
IoT Hub에서 모든 경로를 가져옵니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub route show |
IoT Hub에서 경로에 대한 정보를 가져옵니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub route test |
IoT Hub에서 모든 경로 또는 멘션 경로를 테스트합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub route update |
IoT Hub에서 경로를 업데이트합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub routing-endpoint |
IoT 허브의 사용자 지정 엔드포인트를 관리합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub routing-endpoint create |
IoT Hub에 엔드포인트를 추가합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub routing-endpoint delete |
IoT Hub에 대한 전체 또는 멘션 엔드포인트를 삭제합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub routing-endpoint list |
IoT Hub의 모든 엔드포인트에 대한 정보를 가져옵니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub routing-endpoint show |
IoT Hub에 대한 멘션 엔드포인트에 대한 정보를 가져옵니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub show |
IoT Hub의 세부 정보를 가져옵니다. |
핵심 | GA |
az iot hub show-connection-string |
IoT Hub에 대한 연결 문자열 표시합니다. |
핵심 | 더 이상 사용되지 않음 |
az iot hub show-quota-metrics |
IoT Hub에 대한 할당량 메트릭을 가져옵니다. |
핵심 | GA |
az iot hub show-stats |
IoT Hub에 대한 통계를 가져옵니다. |
핵심 | GA |
az iot hub state |
IoT Hub의 상태를 관리합니다. |
내선 번호 | 실험적 |
az iot hub state export |
IoT Hub의 상태를 파일로 내보냅니다. |
내선 번호 | 실험적 |
az iot hub state import |
파일에서 IoT Hub로 허브 상태를 가져옵니다. |
내선 번호 | 실험적 |
az iot hub state migrate |
한 허브의 상태를 파일에 저장하지 않고 다른 허브로 마이그레이션합니다. |
내선 번호 | 실험적 |
az iot hub update |
IoT Hub에 대한 메타데이터를 업데이트합니다. |
핵심 | GA |
az iot hub wait |
IoT Hub 인스턴스에 대한 작업이 완료될 때까지 기다립니다. |
핵심 | GA |
az iot hub create
Azure IoT Hub를 만듭니다.
Azure IoT Hub에 대한 소개는 다음을 참조하세요 https://docs.microsoft.com/azure/iot-hub/.
az iot hub create --name
--resource-group
[--c2d-max-delivery-count]
[--c2d-ttl]
[--dds {false, true}]
[--disable-local-auth {false, true}]
[--disable-module-sas {false, true}]
[--edr {false, true}]
[--fc]
[--fcs]
[--fd]
[--feedback-lock-duration]
[--feedback-ttl]
[--fileupload-notification-lock-duration]
[--fileupload-notification-max-delivery-count]
[--fileupload-notification-ttl]
[--fileupload-notifications {false, true}]
[--fileupload-sas-ttl]
[--fileupload-storage-auth-type {identityBased, keyBased}]
[--fileupload-storage-identity]
[--location]
[--mi-system-assigned {false, true}]
[--mi-user-assigned]
[--min-tls-version]
[--no-wait]
[--partition-count]
[--rd]
[--role]
[--scopes]
[--sku {B1, B2, B3, F1, S1, S2, S3}]
[--tags]
[--unit]
예제
리소스 그룹의 지역에서 무료 가격 책정 계층 F1을 사용하여 IoT Hub를 만듭니다.
az iot hub create --resource-group MyResourceGroup --name MyIotHub --sku F1 --partition-count 2
태그를 사용하여 'westus' 지역에 표준 가격 책정 계층 S1 및 4 파티션을 사용하여 IoT Hub를 만듭니다.
az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --tags a=b c=d
시스템 할당 관리 ID를 사용하여 IoT Hub를 만들고 만든 ID에 대한 스토리지 계정에 역할 및 범위를 할당합니다.
az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --mi-system-assigned --role "Storage Blob Data Contributor" --scopes {resourceId}
로컬 인증, 디바이스 SAS 키 및 모듈 SAS 키를 모두 사용하지 않도록 설정하여 IoT Hub 만들기
az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --disable-local-auth --disable-device-sas --disable-module-sas
데이터 상주가 적용된 IoT Hub를 만듭니다. 이렇게 하면 지역 간 재해 복구가 비활성화됩니다.
az iot hub create --resource-group MyResourceGroup --name MyIoTHub --edr
필수 매개 변수
IoT Hub 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
IoT Hub가 디바이스에 클라우드-디바이스 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.
IoT Hub에서 만료되기 전에 디바이스에서 메시지를 사용할 수 있는 시간(1~48시간)입니다.
인증을 위해 모든 디바이스(Edge 디바이스를 포함하지만 모듈 제외)의 범위가 지정된 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.
인증을 위해 IoT Hub 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.
인증을 위해 모듈 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.
지역 간 재해 복구를 사용하지 않도록 설정하여 이 IoT Hub에 대한 데이터 보존을 적용합니다. 이 속성은 리소스에 설정된 후에는 변경할 수 없습니다. 선택한 지역에서만 사용할 수 있습니다. https://aka.ms/iothubdisabledr에서 자세히 알아보세요.
파일을 업로드하는 루트 컨테이너의 이름입니다. 컨테이너는 존재하지 않아도 되지만 지정된 connectionString을 사용하여 만들 수 있어야 합니다.
파일이 업로드되는 Azure Storage 계정의 연결 문자열.
IoT Hub가 피드백 큐에서 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.
피드백 큐의 잠금 기간(5~300초)입니다.
IoT Hub가 1~48시간 사이에 클라우드-디바이스 메시지의 만료 또는 배달에 대한 피드백을 기본 기간입니다.
파일 업로드 알림 큐의 잠금 기간(5~300초)입니다.
IoT Hub가 파일 알림 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.
IoT Hub에서 만료되기 전까지 1~48시간 동안 서비스에서 파일 업로드 알림을 사용할 수 있는 시간입니다.
업로드된 파일에 대한 정보를 메시지/servicebound/filenotifications IoT Hub 엔드포인트에 기록할지 여부를 나타내는 부울입니다.
IoT Hub에서 생성된 SAS URI가 만료되기 전의 유효 기간(1~24시간)입니다.
파일이 업로드되는 Azure Storage 계정에 대한 인증 유형입니다.
파일 업로드 인증에 사용할 관리 ID입니다. '[system]'을 사용하여 시스템 할당 관리 ID 또는 리소스 ID를 참조하여 사용자 할당 관리 ID를 참조합니다.
IoT Hub의 위치입니다. 기본값은 대상 리소스 그룹의 위치입니다.
이 허브에 대해 시스템 할당 관리 ID를 사용하도록 설정합니다.
이 허브에 대해 사용자 할당 관리 ID를 사용하도록 설정합니다. 공백으로 구분된 ID 리소스 ID 목록을 허용합니다.
이 허브에 대해 지원할 최소 TLS 버전을 지정합니다. 1.2 미만의 TLS 버전을 사용하는 클라이언트가 거부되도록 "1.2"로 설정할 수 있습니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
디바이스-클라우드 메시지에 대한 지원 이벤트 허브의 파티션 수입니다.
이 IoT Hub가 1일에서 7일 사이에 디바이스-클라우드 이벤트를 기본 기간을 지정합니다.
허브의 시스템 할당 관리 ID에 할당할 역할입니다.
시스템 할당 관리 ID에 대한 역할(--역할)을 할당하기 위해 공백으로 구분된 범위 목록입니다.
Azure IoT Hub에 대한 가격 책정 계층입니다. 각 구독에는 하나의 무료 IoT Hub 인스턴스(F1)만 허용됩니다. 무료 인스턴스가 1을 초과하면 예외가 throw됩니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
IoT Hub의 단위입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub delete
IoT Hub를 삭제합니다.
az iot hub delete [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
예제
IoT Hub를 삭제합니다. (자동 생성됨)
az iot hub delete --name MyIoTHub --resource-group MyResourceGroup
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub generate-sas-token
대상 IoT Hub, 디바이스 또는 모듈에 대한 SAS 토큰을 생성합니다.
디바이스 SAS 토큰의 경우 정책 매개 변수는 디바이스 레지스트리에만 액세스하는 데 사용됩니다. 따라서 정책에 레지스트리에 대한 읽기 권한이 있어야 합니다. IoT Hub 토큰의 경우 정책은 SAS의 일부입니다.
az iot hub generate-sas-token [--auth-type {key, login}]
[--connection-string]
[--device-id]
[--du]
[--hub-name]
[--key-type {primary, secondary}]
[--login]
[--module-id]
[--pn]
[--resource-group]
예제
iothubowner 정책 및 기본 키를 사용하여 IoT Hub SAS 토큰을 생성합니다.
az iot hub generate-sas-token -n {iothub_name}
registryRead 정책 및 보조 키를 사용하여 IoT Hub SAS 토큰을 생성합니다.
az iot hub generate-sas-token -n {iothub_name} --policy registryRead --key-type secondary
iothubowner 정책을 사용하여 디바이스 SAS 토큰을 생성하여 {iothub_name} 디바이스 레지스트리에 액세스합니다.
az iot hub generate-sas-token -d {device_id} -n {iothub_name}
IoT Hub 연결 문자열 사용하여 디바이스 SAS 토큰 생성(레지스트리 액세스 포함)
az iot hub generate-sas-token -d {device_id} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
IoT Hub 연결 문자열 사용하여 IoT Hub SAS 토큰 생성
az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
디바이스 연결 문자열 사용하여 디바이스 SAS 토큰 생성
az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
모듈 연결 문자열 사용하여 모듈 SAS 토큰 생성
az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;ModuleId=mymodule;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
대상 연결 문자열. 이렇게 하면 IoT Hub 레지스트리를 우회하고 추가 유효성 검사 없이 제공된 대칭 키에서 직접 SAS 토큰을 생성합니다. 기간을 제외한 다른 모든 명령 매개 변수는 무시됩니다. 지원되는 연결 문자열 유형: IoT Hub, 디바이스, 모듈.
대상 디바이스 ID입니다.
유효한 토큰 기간(초)입니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
인증을 위한 공유 액세스 정책 키 유형입니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
대상 모듈 ID입니다.
대상 IoT Hub 엔터티에 대한 작업 권한이 있는 공유 액세스 정책입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub invoke-device-method
디바이스 메서드를 호출합니다.
az iot hub invoke-device-method --device-id
--method-name
[--auth-type {key, login}]
[--hub-name]
[--login]
[--method-payload]
[--resource-group]
[--timeout]
예제
디바이스에서 직접 메서드를 호출합니다.
az iot hub invoke-device-method --hub-name {iothub_name} --device-id {device_id} --method-name Reboot --method-payload '{"version":"1.0"}'
필수 매개 변수
대상 디바이스 ID입니다.
호출에 대한 대상 메서드입니다.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
메서드에 전달할 Json 페이로드입니다. 파일 경로 또는 원시 json이어야 합니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
디바이스 메서드 결과를 기다리는 최대 시간(초)입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub invoke-module-method
모듈 메서드를 호출합니다.
이 명령은 에지 및 비에지 디바이스 모듈을 모두 지원합니다.
az iot hub invoke-module-method --device-id
--method-name
--module-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--method-payload]
[--resource-group]
[--timeout]
예제
에지 디바이스 모듈에서 직접 메서드를 호출합니다.
az iot hub invoke-module-method -n {iothub_name} -d {device_id} -m '$edgeAgent' --method-name 'RestartModule' --method-payload '{"schemaVersion": "1.0"}'
필수 매개 변수
대상 디바이스 ID입니다.
호출에 대한 대상 메서드입니다.
대상 모듈 ID입니다.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
메서드에 전달할 Json 페이로드입니다. 파일 경로 또는 원시 json이어야 합니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
모듈 메서드 결과를 기다리는 최대 시간(초)입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub list
IoT Hub를 나열합니다.
az iot hub list [--resource-group]
예제
구독의 모든 IoT Hub를 나열합니다.
az iot hub list
리소스 그룹 'MyGroup'의 모든 IoT Hub 나열
az iot hub list --resource-group MyGroup
선택적 매개 변수
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub list-skus
사용 가능한 가격 책정 계층을 나열합니다.
az iot hub list-skus [--ids]
[--name]
[--resource-group]
[--subscription]
예제
사용 가능한 가격 책정 계층을 나열합니다. (자동 생성됨)
az iot hub list-skus --name MyIoTHub
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub manual-failover
IoT Hub에서지역 쌍으로 연결된 재해 복구 지역으로의 수동 장애 조치(failover)를 시작합니다.
az iot hub manual-failover [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
예제
주 지역에서 보조 지역으로 장애 조치(failover) "myhub"를 시작합니다.
az iot hub manual-failover -n myhub
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub monitor-events
IoT Hub로 전송된 디바이스 원격 분석 및 메시지를 모니터링합니다.
이 명령은 첫 번째 실행 시 종속 Cython 패키지(uamqp)를 사용하며 설치할 수 있습니다. https://github.com/Azure/azure-uamqp-python
참고: 메시지 본문이 유니코드로 디코딩할 수 없는 경우에도 이벤트가 표시됩니다. 이 경우 이벤트 페이로드 부분은 사용할 수 있는 나머지 이벤트 속성과 함께 {{디코딩할 수 없는 페이로드}로 표시됩니다.
az iot hub monitor-events [--cg]
[--content-type]
[--device-id]
[--device-query]
[--enqueued-time]
[--hub-name]
[--interface]
[--login]
[--mc]
[--module-id]
[--properties {all, anno, app, sys}]
[--repair {false, true}]
[--resource-group]
[--timeout]
[--yes {false, true}]
예제
기본 사용법
az iot hub monitor-events -n {iothub_name}
IoT Hub 연결 문자열 기본 사용
az iot hub monitor-events -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
대상 디바이스에서 필터링할 때 기본 사용
az iot hub monitor-events -n {iothub_name} -d {device_id}
ID에서 wild카드를 사용하여 대상 디바이스를 필터링할 때 기본 사용
az iot hub monitor-events -n {iothub_name} -d Device*
IoT Hub 쿼리 언어를 사용하여 디바이스 필터링
az iot hub monitor-events -n {iothub_name} -q "select * from devices where tags.location.region = 'US'"
디바이스를 필터링하고 바인딩할 Event Hub 소비자 그룹을 지정합니다.
az iot hub monitor-events -n {iothub_name} -d {device_id} --cg {consumer_group_name}
메시지 주석 수신(메시지 헤더)
az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno
메시지 주석 + 시스템 속성을 받습니다. 시간을 초과하지 마십시오.
az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno sys --timeout 0
모든 디바이스 메시지에서 모든 메시지 특성 받기
az iot hub monitor-events -n {iothub_name} --props all
모든 메시지 수신 및 메시지 페이로드를 JSON으로 구문 분석
az iot hub monitor-events -n {iothub_name} --content-type application/json
허브에서 지정된 수의 메시지를 받은 다음 종료합니다.
az iot hub monitor-events -n {iothub_name} --message-count {message_count}
선택적 매개 변수
이벤트 허브 엔드포인트에 연결할 때 사용할 소비자 그룹을 지정합니다.
메시지 페이로드의 Content-Type을 지정하여 출력의 형식을 해당 형식으로 자동으로 지정합니다.
대상 디바이스 ID입니다.
디바이스를 필터링할 사용자 지정 쿼리를 지정합니다.
파티션에서 메시지를 읽기 위한 시작점으로 사용해야 하는 시간을 나타냅니다. 단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 "now"가 사용됩니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
필터링할 대상 인터페이스 식별자입니다. 예: dtmi:com:example:TemperatureController;1.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
모니터가 종료되기 전에 캡처할 원격 분석 메시지 수입니다. 지정하지 않은 경우 모니터는 허브에서 메시지를 받지 못하는 시간 제한 임계값을 충족할 때까지 계속 실행됩니다.
대상 모듈 ID입니다.
출력할 키 메시지 속성을 나타냅니다. sys = 시스템 속성, app = application properties, anno = annotations.
확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
메시지를 받지 않고 연결을 기본 최대 시간(초)입니다. 무한대에 0을 사용합니다.
사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub monitor-feedback
디바이스에서 보낸 피드백을 모니터링하여 C2D(클라우드-디바이스) 메시지를 승인합니다.
이 명령은 첫 번째 실행 시 종속 Cython 패키지(uamqp)를 사용하며 설치할 수 있습니다. https://github.com/Azure/azure-uamqp-python.
az iot hub monitor-feedback [--auth-type {key, login}]
[--device-id]
[--hub-name]
[--login]
[--repair {false, true}]
[--resource-group]
[--wait-on-msg]
[--yes {false, true}]
예제
기본 사용법
az iot hub monitor-feedback -n {iothub_name}
IoT Hub 연결 문자열 기본 사용
az iot hub monitor-feedback -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
대상 디바이스에서 필터링할 때 기본 사용
az iot hub monitor-feedback -n {iothub_name} -d {device_id}
특정 ID가 있는 메시지를 받으면 피드백 모니터 종료(uuid)
az iot hub monitor-feedback -n {iothub_name} -d {device_id} -w {message_id}
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
대상 디바이스 ID입니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
피드백 모니터는 특정 ID(uuid)가 있는 메시지를 받을 때까지 차단됩니다.
사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub query
강력한 SQL 같은 언어를 사용하여 IoT Hub를 쿼리합니다.
디바이스 및 모듈 쌍, 작업 및 메시지 라우팅에 대한 정보를 검색합니다. 자세한 내용은 https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language 을 참조하세요.
az iot hub query --query-command
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
[--top]
예제
Azure IoT Hub의 모든 디바이스 쌍 데이터를 쿼리합니다.
az iot hub query -n {iothub_name} -q "select * from devices"
대상 디바이스의 모든 모듈 쌍 데이터를 쿼리합니다.
az iot hub query -n {iothub_name} -q "select * from devices.modules where devices.deviceId = '{device_id}'"
필수 매개 변수
실행할 사용자 쿼리입니다.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
반환할 최대 요소 수입니다. 기본적으로 쿼리에는 상한이 없습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub show
IoT Hub의 세부 정보를 가져옵니다.
az iot hub show [--ids]
[--name]
[--resource-group]
[--subscription]
예제
IoT Hub의 세부 정보를 가져옵니다. (자동 생성됨)
az iot hub show --name MyIoTHub
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub show-connection-string
이 명령은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 'IoT 확장(azure-iot) 연결 문자열 명령(az iot hub connection-string show)'을 사용합니다.
IoT Hub에 대한 연결 문자열 표시합니다.
az iot hub show-connection-string [--all]
[--hub-name]
[--ids]
[--key {primary, secondary}]
[--policy-name]
[--resource-group]
[--subscription]
예제
기본 정책 및 기본 키를 사용하여 IoT Hub의 연결 문자열 표시합니다.
az iot hub show-connection-string --name MyIotHub
정책 '서비스' 및 보조 키를 사용하여 IoT Hub의 연결 문자열 표시합니다.
az iot hub show-connection-string --name MyIotHub --policy-name service --key secondary
리소스 그룹의 모든 IoT Hub에 대한 연결 문자열 표시합니다.
az iot hub show-connection-string --resource-group MyResourceGroup
구독의 모든 IoT Hub에 대한 연결 문자열 표시합니다.
az iot hub show-connection-string
IoT Hub에 대한 연결 문자열 표시합니다. (자동 생성됨)
az iot hub show-connection-string --key primary --policy-name MyPolicy
선택적 매개 변수
모든 공유 액세스 정책을 표시할 수 있습니다.
IoT Hub 이름입니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
사용할 키입니다.
사용할 공유 액세스 정책입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub show-quota-metrics
IoT Hub에 대한 할당량 메트릭을 가져옵니다.
az iot hub show-quota-metrics [--ids]
[--name]
[--resource-group]
[--subscription]
예제
IoT Hub에 대한 할당량 메트릭을 가져옵니다. (자동 생성됨)
az iot hub show-quota-metrics --ids {ids}
IoT Hub에 대한 할당량 메트릭을 가져옵니다. (자동 생성됨)
az iot hub show-quota-metrics --name MyIoTHub
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub show-stats
IoT Hub에 대한 통계를 가져옵니다.
az iot hub show-stats [--ids]
[--name]
[--resource-group]
[--subscription]
예제
IoT Hub에 대한 통계를 가져옵니다. (자동 생성됨)
az iot hub show-stats --name MyIoTHub
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub update
IoT Hub에 대한 메타데이터를 업데이트합니다.
az iot hub update [--add]
[--c2d-max-delivery-count]
[--c2d-ttl]
[--dds {false, true}]
[--disable-local-auth {false, true}]
[--disable-module-sas {false, true}]
[--fc]
[--fcs]
[--fd]
[--feedback-lock-duration]
[--feedback-ttl]
[--fileupload-notification-lock-duration]
[--fileupload-notification-max-delivery-count]
[--fileupload-notification-ttl]
[--fileupload-notifications {false, true}]
[--fileupload-sas-ttl]
[--fileupload-storage-auth-type {identityBased, keyBased}]
[--fileupload-storage-identity]
[--force-string]
[--ids]
[--name]
[--rd]
[--remove]
[--resource-group]
[--set]
[--sku {B1, B2, B3, F1, S1, S2, S3}]
[--subscription]
[--tags]
[--unit]
예제
파일 업로드에 스토리지 컨테이너 설정 추가
az iot hub update --name MyIotHub --fileupload-storage-connectionstring "connection-string" \ --fileupload-storage-container-name "container_name"
IP 마스크 127.0.0.0/31의 트래픽을 허용하는 방화벽 필터 규칙을 추가합니다.
az iot hub update --name MyIotHub --add properties.ipFilterRules filter_name=test-rule action=Accept ip_mask=127.0.0.0/31
IoT Hub에 대한 메타데이터를 업데이트합니다. (자동 생성됨)
az iot hub update --name MyIotHub --set properties.allocationPolicy="GeoLatency"
IoT Hub의 단위를 2로 업데이트하고 태그 추가
az iot hub update -n MyIotHub --unit 2 --tags a=b c=d
IoT Hub에 대한 가격 책정 계층을 S2로 업데이트
az iot hub update -n MyIotHub --sku S2
IoT Hub 디바이스-클라우드 이벤트의 보존 일 수를 3일로 업데이트합니다.
az iot hub update -n MyIotHub --retention-day 3
IoT Hub 클라우드-디바이스 메시징 설정 업데이트
az iot hub update --name MyIotHub --c2d-max-delivery-count 30 --c2d-ttl 5
IoT Hub 피드백 큐 설정 업데이트
az iot hub update --name MyIoTHub --feedback-max-delivery-count 20 --feedback-lock-duration 100 --feedback-ttl 4
IoT Hub 파일 업로드 설정을 업데이트하고 파일 업로드를 위해 사용자에게 관리 ID를 할당합니다.
az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased --fileupload-storage-identity [system]
IoT Hub 파일 업로드 알림 설정 및 큐 잠금 기간 업데이트
az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications --fileupload-notification-lock-duration 10
IoT Hub 로컬 인증, 디바이스 SAS 및 모듈 SAS 설정 업데이트
az iot hub update -n MyIoTHub --disable-local-auth --disable-device-sas false --disable-module-sas true
선택적 매개 변수
경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>
IoT Hub가 디바이스에 클라우드-디바이스 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.
IoT Hub에서 만료되기 전에 디바이스에서 메시지를 사용할 수 있는 시간(1~48시간)입니다.
인증을 위해 모든 디바이스(Edge 디바이스를 포함하지만 모듈 제외)의 범위가 지정된 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.
인증을 위해 IoT Hub 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.
인증을 위해 모듈 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.
파일을 업로드하는 루트 컨테이너의 이름입니다. 컨테이너는 존재하지 않아도 되지만 지정된 connectionString을 사용하여 만들 수 있어야 합니다.
파일이 업로드되는 Azure Storage 계정의 연결 문자열.
IoT Hub가 피드백 큐에서 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.
피드백 큐의 잠금 기간(5~300초)입니다.
IoT Hub가 1~48시간 사이에 클라우드-디바이스 메시지의 만료 또는 배달에 대한 피드백을 기본 기간입니다.
파일 업로드 알림 큐의 잠금 기간(5~300초)입니다.
IoT Hub가 파일 알림 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.
IoT Hub에서 만료되기 전까지 1~48시간 동안 서비스에서 파일 업로드 알림을 사용할 수 있는 시간입니다.
업로드된 파일에 대한 정보를 메시지/servicebound/filenotifications IoT Hub 엔드포인트에 기록할지 여부를 나타내는 부울입니다.
IoT Hub에서 생성된 SAS URI가 만료되기 전의 유효 기간(1~24시간)입니다.
파일이 업로드되는 Azure Storage 계정에 대한 인증 유형입니다.
파일 업로드 인증에 사용할 관리 ID입니다. '[system]'을 사용하여 시스템 할당 관리 ID 또는 리소스 ID를 참조하여 사용자 할당 관리 ID를 참조합니다.
'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
IoT Hub 이름입니다.
이 IoT Hub가 1일에서 7일 사이에 디바이스-클라우드 이벤트를 기본 기간을 지정합니다.
목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>
Azure IoT Hub에 대한 가격 책정 계층입니다. 각 구독에는 하나의 무료 IoT Hub 인스턴스(F1)만 허용됩니다. 무료 인스턴스가 1을 초과하면 예외가 throw됩니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
IoT Hub의 단위입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub wait
IoT Hub 인스턴스에 대한 작업이 완료될 때까지 기다립니다.
az iot hub wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
예제
기존 IoT Hub 인스턴스가 생성될 때까지 기다립니다.
az iot hub wait -n MyIoTHub --created
IoT Hub 인스턴스가 삭제될 때까지 기다립니다.
az iot hub wait -n MyIoTHub --deleted
기존 IoT Hub 인스턴스가 활성 상태가 될 때까지 기다립니다.
az iot hub wait -n MyIoTHub --custom "properties.state=='Active'"
선택적 매개 변수
'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.
조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].
삭제될 때까지 기다립니다.
리소스가 존재할 때까지 기다립니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
폴링 간격(초)입니다.
IoT Hub 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>
기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
최대 대기 시간(초)입니다.
'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID
기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
Azure CLI