az iot hub

Azure IoT 허브를 관리합니다.

명령

az iot hub certificate

IoT Hub 인증서를 관리 합니다.

az iot hub certificate create

Azure IoT Hub 인증서를 만들거나 업로드 합니다.

az iot hub certificate delete

Azure IoT Hub 인증서를 삭제 합니다.

az iot hub certificate generate-verification-code

Azure IoT Hub 인증서에 대 한 확인 코드를 생성 합니다.

az iot hub certificate list

Azure IoT Hub 내에 포함 된 모든 인증서를 나열 합니다.

az iot hub certificate show

특정 Azure IoT Hub 인증서에 대 한 정보를 표시 합니다.

az iot hub certificate update

Azure IoT Hub 인증서를 업데이트 합니다.

az iot hub certificate verify

Azure IoT Hub 인증서를 확인 합니다.

az iot hub configuration

IoT 자동 디바이스 관리 구성을 대규모로 관리합니다.

az iot hub configuration create

대상 IoT Hub에서 IoT 자동 장치 관리 구성을 만듭니다.

az iot hub configuration delete

IoT 장치 구성을 삭제 합니다.

az iot hub configuration list

IoT Hub에서 IoT 자동 장치 관리 구성을 나열 합니다.

az iot hub configuration show

IoT 자동 장치 관리 구성에 대 한 세부 정보를 가져옵니다.

az iot hub configuration show-metric

IoT 장치 구성에 정의 된 대상 사용자 또는 시스템 메트릭을 평가 합니다.

az iot hub configuration update

IoT 자동 장치 관리 구성의 지정 된 속성을 업데이트 합니다.

구성 업데이트를 위해--set 다음에 속성 할당을 사용 합니다.

참고: 구성 콘텐츠를 변경할 수 없습니다. 업데이트할 수 있는 구성 속성은 ' 레이블 ', ' 메트릭 ', ' 우선 순위 ' 및 ' targetCondition '입니다.

az iot hub connection-string

IoT Hub 연결 문자열을 관리 합니다.

az iot hub connection-string show

IoT Hub에 대 한 연결 문자열을 표시 합니다.

az iot hub consumer-group

IoT hub의 event hub 소비자 그룹을 관리 합니다.

az iot hub consumer-group create

이벤트 허브 소비자 그룹을 만듭니다.

az iot hub consumer-group delete

이벤트 허브 소비자 그룹을 삭제 합니다.

az iot hub consumer-group list

이벤트 허브 소비자 그룹을 나열 합니다.

az iot hub consumer-group show

Event hubs 소비자 그룹에 대 한 세부 정보를 가져옵니다.

az iot hub create

Azure IoT hub를 만듭니다.

az iot hub delete

IoT hub를 삭제 합니다.

az iot hub device-identity

IoT 장치를 관리 합니다.

az iot hub device-identity add-children

지정 된에 지 장치의 자식으로 지정 된 쉼표로 구분 된 장치 id 목록을 추가 합니다.

az iot hub device-identity children

IoT 장치의 자식 장치를 관리 합니다.

az iot hub device-identity children add

지정 된 공백으로 구분 된 장치 id 목록을 지정 된에 지 장치의 자식으로 추가 합니다.

az iot hub device-identity children list

할당 된 자식 장치의 목록을 출력 합니다.

az iot hub device-identity children remove

지정 된에 지 장치에서 자식으로 장치를 제거 합니다.

az iot hub device-identity connection-string

IoT 장치의 연결 문자열을 관리 합니다.

az iot hub device-identity connection-string show

지정 된 IoT Hub 장치 연결 문자열을 표시 합니다.

az iot hub device-identity create

IoT Hub에서 장치를 만듭니다.

az iot hub device-identity delete

IoT Hub 장치를 삭제 합니다.

az iot hub device-identity export

IoT Hub에서 Azure Storage blob 컨테이너로 모든 장치 id를 내보냅니다. 인라인 blob 컨테이너 SAS uri 입력의 경우 사용자 환경의 입력 규칙을 검토 하세요.

az iot hub device-identity get-parent

지정 된 장치의 부모 장치를 가져옵니다.

az iot hub device-identity import

Blob에서 장치 id를 IoT Hub 가져옵니다. 인라인 blob 컨테이너 SAS uri 입력의 경우 사용자 환경의 입력 규칙을 검토 하세요.

az iot hub device-identity list

IoT Hub에서 장치를 나열 합니다.

az iot hub device-identity list-children

할당 된 자식 장치의 쉼표로 구분 된 목록을 출력 합니다.

az iot hub device-identity parent

IoT 장치의 부모 장치를 관리 합니다.

az iot hub device-identity parent set

지정 된 장치의 부모 장치를 설정 합니다.

az iot hub device-identity parent show

지정 된 장치의 부모 장치를 가져옵니다.

az iot hub device-identity remove-children

지정 된에 지 장치에서 자식으로 장치를 제거 합니다.

az iot hub device-identity renew-key

Sas 인증을 사용 하 여 IoT Hub 장치의 대상 키를 갱신 합니다.

az iot hub device-identity set-parent

지정 된 장치의 부모 장치를 설정 합니다.

az iot hub device-identity show

IoT Hub 장치에 대 한 세부 정보를 가져옵니다.

az iot hub device-identity show-connection-string

지정 된 IoT Hub 장치 연결 문자열을 표시 합니다.

az iot hub device-identity update

IoT Hub 장치를 업데이트 합니다.

az iot hub devicestream

IoT hub의 장치 스트림을 관리 합니다.

az iot hub devicestream show

IoT Hub의 장치 스트림 끝점을 가져옵니다.

az iot hub device-twin

IoT 장치 쌍 구성을 관리 합니다.

az iot hub device-twin replace

장치 쌍 정의를 대상 json으로 바꿉니다.

az iot hub device-twin show

장치 쌍 정의를 가져옵니다.

az iot hub device-twin update

장치 쌍 desired 속성 및 태그를 업데이트 합니다.

az iot hub digital-twin

IoT Hub 장치의 디지털 쌍을 조작 하 고 상호 작용 합니다.

az iot hub digital-twin invoke-command

디지털 쌍 장치의 루트 또는 구성 요소 수준 명령을 호출 합니다.

az iot hub digital-twin show

IoT Hub 장치의 디지털 쌍을 표시 합니다.

az iot hub digital-twin update

JSON 패치 사양을 통해 디지털 쌍 장치의 읽기/쓰기 속성을 업데이트 합니다.

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 토큰을 생성 합니다.

az iot hub invoke-device-method

장치 메서드를 호출 합니다.

az iot hub invoke-module-method

Edge 모듈 메서드를 호출 합니다.

az iot hub job

IoT Hub 작업 (v2)을 관리 합니다.

az iot hub job cancel

IoT Hub 작업을 취소 합니다.

az iot hub job create

실행할 IoT Hub 작업을 만들고 예약 합니다.

az iot hub job list

IoT Hub의 기록 작업을 나열 합니다.

az iot hub job show

기존 IoT Hub 작업에 대 한 세부 정보를 표시 합니다.

az iot hub list

IoT hub를 나열 합니다.

az iot hub list-skus

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

az iot hub manual-failover

지역 쌍을 이루는 재해 복구 지역에 대 한 IoT Hub 수동 장애 조치 (failover)를 시작 합니다.

az iot hub message-enrichment

IoT Hub의 끝점에 대 한 메시지 강화를 관리 합니다.

az iot hub message-enrichment create

IoT Hub에서 선택한 끝점에 대 한 메시지 보강를 만듭니다.

az iot hub message-enrichment delete

IoT hub에서 보강 메시지를 삭제 합니다 (키로).

az iot hub message-enrichment list

IoT Hub에 대 한 모든 메시지 강화에 대 한 정보를 가져옵니다.

az iot hub message-enrichment update

IoT hub에서 보강 메시지를 업데이트 합니다 (키로).

az iot hub module-identity

IoT 장치 모듈을 관리 합니다.

az iot hub module-identity connection-string

IoT 장치 모듈의 연결 문자열을 관리 합니다.

az iot hub module-identity connection-string show

대상 IoT 장치 모듈 연결 문자열을 표시 합니다.

az iot hub module-identity create

IoT Hub에서 대상 IoT 장치에 모듈을 만듭니다.

az iot hub module-identity delete

IoT Hub에서 장치를 삭제 합니다.

az iot hub module-identity list

IoT Hub의 IoT 장치에 있는 모듈을 나열 합니다.

az iot hub module-identity show

IoT Hub에서 IoT 장치 모듈의 세부 정보를 가져옵니다.

az iot hub module-identity show-connection-string

대상 IoT 장치 모듈 연결 문자열을 표시 합니다.

az iot hub module-identity update

IoT Hub 장치 모듈을 업데이트 합니다.

az iot hub module-twin

IoT 장치 모듈 쌍 구성을 관리 합니다.

az iot hub module-twin replace

모듈 쌍 정의를 대상 json으로 바꿉니다.

az iot hub module-twin show

모듈 쌍 정의를 표시 합니다.

az iot hub module-twin update

모듈 쌍 desired 속성 및 태그를 업데이트 합니다.

az iot hub monitor-events

IoT Hub에 전송 된 메시지 & 장치 원격 분석을 모니터링 합니다.

az iot hub monitor-feedback

장치에서 보낸 피드백을 모니터링 하 여 클라우드-장치 (C2D) 메시지를 승인 합니다.

az iot hub policy

IoT hub의 공유 액세스 정책을 관리 합니다.

az iot hub policy create

IoT hub에 새 공유 액세스 정책을 만듭니다.

az iot hub policy delete

IoT hub에서 공유 액세스 정책을 삭제 합니다.

az iot hub policy list

IoT hub에 대 한 공유 액세스 정책을 나열 합니다.

az iot hub policy renew-key

IoT hub의 공유 액세스 정책 키를 다시 생성 합니다.

az iot hub policy show

IoT hub의 공유 액세스 정책에 대 한 세부 정보를 가져옵니다.

az iot hub query

강력한 SQL 유사 언어를 사용 하 여 IoT Hub를 쿼리 합니다.

az iot hub route

IoT hub의 경로를 관리 합니다.

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 hub의 사용자 지정 끝점을 관리 합니다.

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에 대 한 세부 정보를 가져옵니다.

az iot hub show-connection-string

IoT hub에 대 한 연결 문자열을 표시 합니다.

az iot hub show-quota-metrics

IoT hub에 대 한 할당량 메트릭을 가져옵니다.

az iot hub show-stats

IoT hub에 대 한 통계를 가져옵니다.

az iot hub update

IoT hub에 대 한 메타 데이터를 업데이트 합니다.

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]
                  [--fc]
                  [--fcs]
                  [--fcu]
                  [--fd]
                  [--feedback-lock-duration]
                  [--feedback-ttl]
                  [--fileupload-notification-max-delivery-count]
                  [--fileupload-notification-ttl]
                  [--fileupload-notifications {false, true}]
                  [--fileupload-sas-ttl]
                  [--fileupload-storage-auth-type]
                  [--location]
                  [--min-tls-version]
                  [--partition-count]
                  [--rd]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--subscription]
                  [--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

필수 매개 변수

--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
--fc --fileupload-storage-container-name

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

--fcs --fileupload-storage-connectionstring

파일이 업로드 되는 Azure Storage 계정에 대 한 연결 문자열입니다.

--fcu --fileupload-storage-container-uri

파일이 업로드 되는 Azure Storage 계정의 컨테이너 URI입니다.

--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-max-delivery-count --fnd

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

기본값: 10
--fileupload-notification-ttl --fnt

48 시간 사이에 IoT Hub에 의해 만료 되기 전에 서비스에서 파일 업로드 알림을 사용할 수 있는 시간입니다.

기본값: 1
--fileupload-notifications --fn

업로드 된 파일에 대 한 정보를 messages/servicebound/filenotifications IoT Hub 끝점에 기록할지 여부를 나타내는 부울입니다.

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

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

기본값: 1
--fileupload-storage-auth-type --fsa

파일이 업로드 되는 Azure Storage 계정의 인증 유형입니다. 가능한 값은 keyBased 및 identityBased입니다.

--location -l

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

--min-tls-version --mintls

이 허브에 대해 지원할 최소 TLS 버전을 지정 합니다. 클라이언트에서 1.2 이하의 TLS 버전을 사용 하는 경우 "1.2"으로 설정 하 여 거부 될 수 있습니다.

--partition-count

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

기본값: 4
--rd --retention-day

이 IoT hub에서 1 ~ 7 일 사이의 장치-클라우드 이벤트를 유지 관리할 기간을 지정 합니다.

기본값: 1
--sku

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

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

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

--tags

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

--unit

IoT Hub 단위.

기본값: 1

az iot hub delete

IoT hub를 삭제 합니다.

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

예제

IoT hub를 삭제 합니다. 자동 생성

az iot hub delete --name MyIoTHub --resource-group MyResourceGroup

선택적 매개 변수

--ids

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

--name -n

IoT Hub 이름입니다.

--resource-group -g

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

--subscription

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

az iot hub generate-sas-token

대상 IoT Hub, 장치 또는 모듈에 대 한 SAS 토큰을 생성 합니다.

장치 SAS 토큰의 경우 정책 매개 변수는 장치 레지스트리에만 액세스 하는 데 사용 됩니다. 따라서 정책에는 레지스트리에 대 한 읽기 권한이 있어야 합니다. IoT Hub 토큰의 경우이 정책은 SAS의 일부입니다.

az iot hub generate-sas-token [--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'

선택적 매개 변수

--device-id -d

대상 장치.

--du --duration

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

기본값: 3600
--hub-name -n

IoT Hub 이름입니다.

--key-type --kt

Auth에 대 한 공유 액세스 정책 키 유형입니다.

허용되는 값: primary, secondary
기본값: primary
--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--module-id -m

대상 모듈.

--pn --policy-name

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

기본값: iothubowner
--resource-group -g

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

az iot hub invoke-device-method

장치 메서드를 호출 합니다.

az iot hub invoke-device-method --device-id
                                --method-name
                                [--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

대상 장치.

--method-name --mn

호출할 대상 메서드입니다.

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--method-payload --mp

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

기본값: {}
--resource-group -g

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

--timeout --to

장치 메서드 결과를 대기 하는 최대 시간 (초)입니다.

기본값: 30

az iot hub invoke-module-method

Edge 모듈 메서드를 호출 합니다.

az iot hub invoke-module-method --device-id
                                --method-name
                                --module-id
                                [--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

대상 장치.

--method-name --mn

호출할 대상 메서드입니다.

--module-id -m

대상 모듈.

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--method-payload --mp

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

기본값: {}
--resource-group -g

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

--timeout --to

장치 메서드 결과를 대기 하는 최대 시간 (초)입니다.

기본값: 30

az iot hub list

IoT hub를 나열 합니다.

az iot hub list [--query-examples]
                [--resource-group]
                [--subscription]

예제

구독의 모든 IoT hub를 나열 합니다.

az iot hub list

리소스 그룹 ' MyGroup '의 모든 IoT hub를 나열 합니다.

az iot hub list --resource-group MyGroup

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

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

--subscription

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

az iot hub list-skus

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

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

예제

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

az iot hub list-skus --name MyIoTHub

선택적 매개 변수

--ids

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

--name -n

IoT Hub 이름입니다.

--resource-group -g

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

--subscription

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

az iot hub manual-failover

지역 쌍을 이루는 재해 복구 지역에 대 한 IoT Hub 수동 장애 조치 (failover)를 시작 합니다.

az iot hub manual-failover [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]

예제

주 지역에서 보조 지역으로 "myhub" 장애 조치 (failover)를 시작 합니다.

az iot hub manual-failover -n myhub

선택적 매개 변수

--ids

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

--name -n

IoT Hub 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

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

--subscription

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

az iot hub monitor-events

IoT Hub에 전송 된 메시지 & 장치 원격 분석을 모니터링 합니다.

실험적에는 Python 3.5 이상이 필요 합니다 .이 명령은 처음 실행할 때 uamqp (dependent Cython package)를 사용 하 고 설치할 수 있습니다. 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]
                          [--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에서 와일드 카드를 사용 하 여 대상 장치를 필터링 할 때의 기본 사용

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

장치를 필터링 하 고 바인딩할 이벤트 허브 소비자 그룹을 지정 합니다.

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

선택적 매개 변수

--cg --consumer-group -c

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

기본값: $Default
--content-type --ct

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

--device-id -d

대상 장치.

--device-query -q

사용자 지정 쿼리를 지정 하 여 장치를 필터링 합니다.

--enqueued-time --et -e

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

--hub-name -n

IoT Hub 이름입니다.

--interface -i

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

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--module-id -m

대상 모듈.

--properties --props -p

출력할 키 메시지 속성을 표시 합니다. sys = 시스템 속성, 앱 = 응용 프로그램 속성, anno = 주석

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

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

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

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

--timeout --to -t

메시지를 받지 않고 연결을 유지 하는 최대 시간 (초)입니다. Infinity에 0을 사용 합니다.

기본값: 300
--yes -y

사용자 프롬프트를 건너뜁니다. 종속성 설치의 수락을 나타냅니다 (필요한 경우). 주로 자동화 시나리오에 사용 됩니다. 기본값: false입니다.

허용되는 값: false, true

az iot hub monitor-feedback

장치에서 보낸 피드백을 모니터링 하 여 클라우드-장치 (C2D) 메시지를 승인 합니다.

실험적에는 Python 3.4 이상이 필요 합니다 .이 명령은 처음 실행할 때 uamqp (dependent Cython package)를 사용 하 고 설치할 수 있습니다. https://github.com/Azure/azure-uamqp-python.

az iot hub monitor-feedback [--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}

선택적 매개 변수

--device-id -d

대상 장치.

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--repair -r

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

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

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

--wait-on-msg -w

사용자 의견 모니터는 특정 id (uuid)가 포함 된 메시지를 받을 때까지 차단 됩니다.

--yes -y

사용자 프롬프트를 건너뜁니다. 종속성 설치의 수락을 나타냅니다 (필요한 경우). 주로 자동화 시나리오에 사용 됩니다. 기본값: false입니다.

허용되는 값: false, true

az iot hub query

강력한 SQL 유사 언어를 사용 하 여 IoT Hub를 쿼리 합니다.

강력한 SQL 유사 언어를 사용 하 여 IoT Hub을 쿼리하여 장치 및 모듈 쌍, 작업 및 메시지 라우팅에 대 한 정보를 검색 합니다. 자세한 내용은 https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language 을 참조하세요.

az iot hub query --query-command
                 [--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

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

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--resource-group -g

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

--top

반환할 최대 요소 수입니다. 기본적으로 쿼리는 캡을 포함 하지 않습니다.

az iot hub show

IoT hub에 대 한 세부 정보를 가져옵니다.

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

예제

IoT hub에 대 한 세부 정보를 가져옵니다. 자동 생성

az iot hub show --name MyIoTHub

선택적 매개 변수

--ids

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

--name -n

IoT Hub 이름입니다.

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

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

--subscription

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

az iot hub show-connection-string

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

정책 ' service ' 및 보조 키를 사용 하 여 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

모든 공유 액세스 정책을 표시 하도록 허용 합니다.

--hub-name --name -n

IoT Hub 이름입니다.

--ids

하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 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 .

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 (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.

--name -n

IoT Hub 이름입니다.

--resource-group -g

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

--subscription

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

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 (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.

--name -n

IoT Hub 이름입니다.

--resource-group -g

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

--subscription

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

az iot hub update

IoT hub에 대 한 메타 데이터를 업데이트 합니다.

az iot hub update [--add]
                  [--c2d-max-delivery-count]
                  [--c2d-ttl]
                  [--fc]
                  [--fcs]
                  [--fcu]
                  [--fd]
                  [--feedback-lock-duration]
                  [--feedback-ttl]
                  [--fileupload-notification-max-delivery-count]
                  [--fileupload-notification-ttl]
                  [--fileupload-notifications {false, true}]
                  [--fileupload-sas-ttl]
                  [--fileupload-storage-auth-type]
                  [--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

S2로 IoT Hub에 대 한 가격 책정 계층 업데이트

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 파일 업로드 설정을 업데이트 합니다.

az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased

IoT Hub 파일 업로드 알림 설정 업데이트

az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications

선택적 매개 변수

--add

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

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

IoT hub가 장치에 클라우드-장치 메시지를 배달 하려고 시도 하는 횟수입니다 (1 ~ 100).

--c2d-ttl --ct

장치가 IoT Hub에서 만료 되기 전에 사용할 수 있는 시간 (1 ~ 48 시간)입니다.

--fc --fileupload-storage-container-name

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

--fcs --fileupload-storage-connectionstring

파일이 업로드 되는 Azure Storage 계정에 대 한 연결 문자열입니다.

--fcu --fileupload-storage-container-uri

파일이 업로드 되는 Azure Storage 계정의 컨테이너 URI입니다.

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

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

--feedback-lock-duration --fld

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

--feedback-ttl --ft

IoT hub에서 클라우드-장치 메시지의 만료 또는 배달에 대 한 피드백을 유지 관리 하는 기간 (1 ~ 48 시간)입니다.

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

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

--fileupload-notification-ttl --fnt

48 시간 사이에 IoT Hub에 의해 만료 되기 전에 서비스에서 파일 업로드 알림을 사용할 수 있는 시간입니다.

--fileupload-notifications --fn

업로드 된 파일에 대 한 정보를 messages/servicebound/filenotifications IoT Hub 끝점에 기록할지 여부를 나타내는 부울입니다.

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

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

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

파일이 업로드 되는 Azure Storage 계정의 인증 유형입니다. 가능한 값은 keyBased 및 identityBased입니다.

--force-string

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

--ids

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

--name -n

IoT Hub 이름입니다.

--rd --retention-day

이 IoT hub에서 1 ~ 7 일 사이의 장치-클라우드 이벤트를 유지 관리할 기간을 지정 합니다.

--remove

목록에서 속성이 나 요소를 제거 합니다. 예:--속성을 제거 합니다. 목록 또는--propertyToRemove을 제거 합니다.

--resource-group -g

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

--set

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

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

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

--unit

IoT Hub 단위.