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 사이)입니다.

기본값: 10

--c2d-ttl --ct

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

기본값: 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 사이)입니다.

기본값: 10

--feedback-lock-duration --fld

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

기본값: 5

--feedback-ttl --ft

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

기본값: 1

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

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

기본값: 5

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

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

기본값: 10

--fileupload-notification-ttl --fnt

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

기본값: 1

--fileupload-notifications --fn

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

허용되는 값: false, true

기본값: False

--fileupload-sas-ttl --fst

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

기본값: 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

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

기본값: False

--partition-count

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

기본값: 4

--rd --retention-day

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

기본값: 1

--role

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

--scopes

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

--sku

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

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

기본값: S1

--tags

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

--unit

IoT Hub의 단위입니다.

기본값: 1

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: 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

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

기본값: 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

기본값: 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

기본값: key

--connection-string --cs

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

--device-id -d

대상 디바이스 ID입니다.

--du --duration

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

기본값: 3600

--hub-name -n

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

--key-type --kt

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

허용되는 값: primary, secondary

기본값: primary

--login -l

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

--module-id -m

대상 모듈 ID입니다.

--pn --policy-name

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

기본값: iothubowner

--resource-group -g

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

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: 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

기본값: key

--hub-name -n

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

--login -l

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

--method-payload --mp

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

기본값: {}

--resource-group -g

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

--timeout --to

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

기본값: 30

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: 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

기본값: key

--hub-name -n

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

--login -l

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

--method-payload --mp

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

기본값: {}

--resource-group -g

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

--timeout --to

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

기본값: 30

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: 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

기본값: 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

기본값: 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

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

기본값: 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

기본값: 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

--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

기본값: False

--resource-group -g

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

--timeout --to -t

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

기본값: 300

--yes -y

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

허용되는 값: false, true

기본값: False

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: 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

기본값: key

--device-id -d

대상 디바이스 ID입니다.

--hub-name -n

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

--login -l

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

--repair -r

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

허용되는 값: false, true

기본값: False

--resource-group -g

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

--wait-on-msg -w

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

--yes -y

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

허용되는 값: false, true

기본값: False

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: 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

기본값: 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

기본값: 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

기본값: 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

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

기본값: False

--hub-name --name -n

IoT Hub 이름입니다.

--ids

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

--key

사용할 키입니다.

허용되는 값: primary, secondary

기본값: primary

--policy-name

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

기본값: 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

기본값: 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

기본값: 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

기본값: 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>

기본값: []

--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으로 변환하는 대신 문자열 리터럴을 유지합니다.

기본값: 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.

기본값: []

--resource-group -g

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

--set

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

기본값: 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'를 사용하여 생성될 때까지 기다립니다.

기본값: False

--custom

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

--deleted

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

기본값: False

--exists

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

기본값: False

--ids

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

--interval

폴링 간격(초)입니다.

기본값: 30

--name -n

IoT Hub 이름입니다.

--resource-group -g

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

--subscription

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

--timeout

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

기본값: 3600

--updated

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

기본값: False

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

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

--subscription

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

--verbose

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