다음을 통해 공유


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

필수 매개 변수

--name -n

IoT Hub 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--c2d-max-delivery-count --cdd

IoT Hub가 디바이스에 클라우드-디바이스 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.

Default value: 10
--c2d-ttl --ct

IoT Hub에서 만료되기 전에 디바이스에서 메시지를 사용할 수 있는 시간(1~48시간)입니다.

Default value: 1
--dds --disable-device-sas

인증을 위해 모든 디바이스(Edge 디바이스를 포함하지만 모듈 제외)의 범위가 지정된 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--disable-local-auth --dla

인증을 위해 IoT Hub 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--disable-module-sas --dms

인증을 위해 모듈 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--edr --enforce-data-residency

지역 간 재해 복구를 사용하지 않도록 설정하여 이 IoT Hub에 대한 데이터 보존을 적용합니다. 이 속성은 리소스에 설정된 후에는 변경할 수 없습니다. 선택한 지역에서만 사용할 수 있습니다. https://aka.ms/iothubdisabledr에서 자세히 알아보세요.

허용되는 값: false, true
--fc --fileupload-storage-container-name

파일을 업로드하는 루트 컨테이너의 이름입니다. 컨테이너는 존재하지 않아도 되지만 지정된 connectionString을 사용하여 만들 수 있어야 합니다.

--fcs --fileupload-storage-connectionstring

파일이 업로드되는 Azure Storage 계정의 연결 문자열.

--fd --feedback-max-delivery-count

IoT Hub가 피드백 큐에서 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.

Default value: 10
--feedback-lock-duration --fld

피드백 큐의 잠금 기간(5~300초)입니다.

Default value: 5
--feedback-ttl --ft

IoT Hub가 1~48시간 사이에 클라우드-디바이스 메시지의 만료 또는 배달에 대한 피드백을 기본 기간입니다.

Default value: 1
--fileupload-notification-lock-duration --fnld

파일 업로드 알림 큐의 잠금 기간(5~300초)입니다.

Default value: 5
--fileupload-notification-max-delivery-count --fnd

IoT Hub가 파일 알림 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.

Default value: 10
--fileupload-notification-ttl --fnt

IoT Hub에서 만료되기 전까지 1~48시간 동안 서비스에서 파일 업로드 알림을 사용할 수 있는 시간입니다.

Default value: 1
--fileupload-notifications --fn

업로드된 파일에 대한 정보를 메시지/servicebound/filenotifications IoT Hub 엔드포인트에 기록할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
Default value: False
--fileupload-sas-ttl --fst

IoT Hub에서 생성된 SAS URI가 만료되기 전의 유효 기간(1~24시간)입니다.

Default value: 1
--fileupload-storage-auth-type --fsa

파일이 업로드되는 Azure Storage 계정에 대한 인증 유형입니다.

허용되는 값: identityBased, keyBased
--fileupload-storage-identity --fsi

파일 업로드 인증에 사용할 관리 ID입니다. '[system]'을 사용하여 시스템 할당 관리 ID 또는 리소스 ID를 참조하여 사용자 할당 관리 ID를 참조합니다.

--location -l

IoT Hub의 위치입니다. 기본값은 대상 리소스 그룹의 위치입니다.

--mi-system-assigned

이 허브에 대해 시스템 할당 관리 ID를 사용하도록 설정합니다.

허용되는 값: false, true
--mi-user-assigned

이 허브에 대해 사용자 할당 관리 ID를 사용하도록 설정합니다. 공백으로 구분된 ID 리소스 ID 목록을 허용합니다.

--min-tls-version --mintls

이 허브에 대해 지원할 최소 TLS 버전을 지정합니다. 1.2 미만의 TLS 버전을 사용하는 클라이언트가 거부되도록 "1.2"로 설정할 수 있습니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--partition-count

디바이스-클라우드 메시지에 대한 지원 이벤트 허브의 파티션 수입니다.

Default value: 4
--rd --retention-day

이 IoT Hub가 1일에서 7일 사이에 디바이스-클라우드 이벤트를 기본 기간을 지정합니다.

Default value: 1
--role

허브의 시스템 할당 관리 ID에 할당할 역할입니다.

--scopes

시스템 할당 관리 ID에 대한 역할(--역할)을 할당하기 위해 공백으로 구분된 범위 목록입니다.

--sku

Azure IoT Hub에 대한 가격 책정 계층입니다. 각 구독에는 하나의 무료 IoT Hub 인스턴스(F1)만 허용됩니다. 무료 인스턴스가 1을 초과하면 예외가 throw됩니다.

허용되는 값: B1, B2, B3, F1, S1, S2, S3
Default value: S1
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--unit

IoT Hub의 단위입니다.

Default value: 1
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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'

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login
Default value: key
--connection-string --cs

대상 연결 문자열. 이렇게 하면 IoT Hub 레지스트리를 우회하고 추가 유효성 검사 없이 제공된 대칭 키에서 직접 SAS 토큰을 생성합니다. 기간을 제외한 다른 모든 명령 매개 변수는 무시됩니다. 지원되는 연결 문자열 유형: IoT Hub, 디바이스, 모듈.

--device-id -d

대상 디바이스 ID입니다.

--du --duration

유효한 토큰 기간(초)입니다.

Default value: 3600
--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--key-type --kt

인증을 위한 공유 액세스 정책 키 유형입니다.

허용되는 값: primary, secondary
Default value: primary
--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--module-id -m

대상 모듈 ID입니다.

--pn --policy-name

대상 IoT Hub 엔터티에 대한 작업 권한이 있는 공유 액세스 정책입니다.

Default value: iothubowner
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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"}'

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

--method-name --mn

호출에 대한 대상 메서드입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login
Default value: key
--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--method-payload --mp

메서드에 전달할 Json 페이로드입니다. 파일 경로 또는 원시 json이어야 합니다.

Default value: {}
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--timeout --to

디바이스 메서드 결과를 기다리는 최대 시간(초)입니다.

Default value: 30
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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"}'

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

--method-name --mn

호출에 대한 대상 메서드입니다.

--module-id -m

대상 모듈 ID입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login
Default value: key
--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--method-payload --mp

메서드에 전달할 Json 페이로드입니다. 파일 경로 또는 원시 json이어야 합니다.

Default value: {}
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--timeout --to

모듈 메서드 결과를 기다리는 최대 시간(초)입니다.

Default value: 30
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot hub list-skus

사용 가능한 가격 책정 계층을 나열합니다.

az iot hub list-skus [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

예제

사용 가능한 가격 책정 계층을 나열합니다. (자동 생성됨)

az iot hub list-skus --name MyIoTHub

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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}

선택적 매개 변수

--cg --consumer-group -c

이벤트 허브 엔드포인트에 연결할 때 사용할 소비자 그룹을 지정합니다.

Default value: $Default
--content-type --ct

메시지 페이로드의 Content-Type을 지정하여 출력의 형식을 해당 형식으로 자동으로 지정합니다.

--device-id -d

대상 디바이스 ID입니다.

--device-query -q

디바이스를 필터링할 사용자 지정 쿼리를 지정합니다.

--enqueued-time --et -e

파티션에서 메시지를 읽기 위한 시작점으로 사용해야 하는 시간을 나타냅니다. 단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 "now"가 사용됩니다.

--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--interface -i

필터링할 대상 인터페이스 식별자입니다. 예: dtmi:com:example:TemperatureController;1.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--mc --message-count

모니터가 종료되기 전에 캡처할 원격 분석 메시지 수입니다. 지정하지 않은 경우 모니터는 허브에서 메시지를 받지 못하는 시간 제한 임계값을 충족할 때까지 계속 실행됩니다.

--module-id -m

대상 모듈 ID입니다.

--properties --props -p

출력할 키 메시지 속성을 나타냅니다. sys = 시스템 속성, app = application properties, anno = annotations.

허용되는 값: all, anno, app, sys
--repair -r

확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.

허용되는 값: false, true
Default value: False
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--timeout --to -t

메시지를 받지 않고 연결을 기본 최대 시간(초)입니다. 무한대에 0을 사용합니다.

Default value: 300
--yes -y

사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.

허용되는 값: false, true
Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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}

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login
Default value: key
--device-id -d

대상 디바이스 ID입니다.

--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--repair -r

확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.

허용되는 값: false, true
Default value: False
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--wait-on-msg -w

피드백 모니터는 특정 ID(uuid)가 있는 메시지를 받을 때까지 차단됩니다.

--yes -y

사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.

허용되는 값: false, true
Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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}'"

필수 매개 변수

--query-command -q

실행할 사용자 쿼리입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login
Default value: key
--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--top

반환할 최대 요소 수입니다. 기본적으로 쿼리에는 상한이 없습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot hub show

IoT Hub의 세부 정보를 가져옵니다.

az iot hub show [--ids]
                [--name]
                [--resource-group]
                [--subscription]

예제

IoT Hub의 세부 정보를 가져옵니다. (자동 생성됨)

az iot hub show --name MyIoTHub

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

선택적 매개 변수

--all

모든 공유 액세스 정책을 표시할 수 있습니다.

Default value: False
--hub-name --name -n

IoT Hub 이름입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--key

사용할 키입니다.

허용되는 값: primary, secondary
Default value: primary
--policy-name

사용할 공유 액세스 정책입니다.

Default value: iothubowner
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []
--c2d-max-delivery-count --cdd

IoT Hub가 디바이스에 클라우드-디바이스 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.

--c2d-ttl --ct

IoT Hub에서 만료되기 전에 디바이스에서 메시지를 사용할 수 있는 시간(1~48시간)입니다.

--dds --disable-device-sas

인증을 위해 모든 디바이스(Edge 디바이스를 포함하지만 모듈 제외)의 범위가 지정된 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--disable-local-auth --dla

인증을 위해 IoT Hub 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--disable-module-sas --dms

인증을 위해 모듈 범위 SAS 키를 사용하지 않도록 설정할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--fc --fileupload-storage-container-name

파일을 업로드하는 루트 컨테이너의 이름입니다. 컨테이너는 존재하지 않아도 되지만 지정된 connectionString을 사용하여 만들 수 있어야 합니다.

--fcs --fileupload-storage-connectionstring

파일이 업로드되는 Azure Storage 계정의 연결 문자열.

--fd --feedback-max-delivery-count

IoT Hub가 피드백 큐에서 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.

--feedback-lock-duration --fld

피드백 큐의 잠금 기간(5~300초)입니다.

--feedback-ttl --ft

IoT Hub가 1~48시간 사이에 클라우드-디바이스 메시지의 만료 또는 배달에 대한 피드백을 기본 기간입니다.

--fileupload-notification-lock-duration --fnld

파일 업로드 알림 큐의 잠금 기간(5~300초)입니다.

--fileupload-notification-max-delivery-count --fnd

IoT Hub가 파일 알림 메시지를 배달하려고 시도하는 횟수(1에서 100 사이)입니다.

--fileupload-notification-ttl --fnt

IoT Hub에서 만료되기 전까지 1~48시간 동안 서비스에서 파일 업로드 알림을 사용할 수 있는 시간입니다.

--fileupload-notifications --fn

업로드된 파일에 대한 정보를 메시지/servicebound/filenotifications IoT Hub 엔드포인트에 기록할지 여부를 나타내는 부울입니다.

허용되는 값: false, true
--fileupload-sas-ttl --fst

IoT Hub에서 생성된 SAS URI가 만료되기 전의 유효 기간(1~24시간)입니다.

--fileupload-storage-auth-type --fsa

파일이 업로드되는 Azure Storage 계정에 대한 인증 유형입니다.

허용되는 값: identityBased, keyBased
--fileupload-storage-identity --fsi

파일 업로드 인증에 사용할 관리 ID입니다. '[system]'을 사용하여 시스템 할당 관리 ID 또는 리소스 ID를 참조하여 사용자 할당 관리 ID를 참조합니다.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

IoT Hub 이름입니다.

--rd --retention-day

이 IoT Hub가 1일에서 7일 사이에 디바이스-클라우드 이벤트를 기본 기간을 지정합니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []
--sku

Azure IoT Hub에 대한 가격 책정 계층입니다. 각 구독에는 하나의 무료 IoT Hub 인스턴스(F1)만 허용됩니다. 무료 인스턴스가 1을 초과하면 예외가 throw됩니다.

허용되는 값: B1, B2, B3, F1, S1, S2, S3
--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--unit

IoT Hub의 단위입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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'"

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격(초)입니다.

Default value: 30
--name -n

IoT Hub 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.