az iot hub device-identity

참고 항목

이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot hub device-identity 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

IoT 디바이스를 관리합니다.

명령

Name	Description	형식	상태
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-identity create

IoT Hub에서 디바이스를 만듭니다.

shared_private_key 인증 방법(대칭 키라고도 함)을 사용하는 경우 사용자 지정 키가 제공되지 않으면 서비스에서 디바이스에 대해 생성합니다.

에지 디바이스에 대한 디바이스 범위가 제공되면 값이 자동으로 부모 범위로 변환됩니다.

az iot hub device-identity create --device-id
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--sta {disabled, enabled}]
                                  [--star]
                                  [--valid-days]

예제

기본 권한 부여(공유 프라이빗 키)를 사용하여 에지 지원 IoT 디바이스를 만듭니다.

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

자체 서명된 인증서 권한 부여를 사용하여 IoT 디바이스를 만들고, 10일 동안 유효한 인증서를 생성한 다음, 지문을 사용합니다.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

자체 서명된 인증서 권한 부여를 사용하여 IoT 디바이스를 만들고, 기본 만료 인증서(365일)를 생성하고, 대상 디렉터리에 출력합니다.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

자체 서명된 인증서 권한 부여를 사용하여 IoT 디바이스를 만들고 기본 및 보조 지문을 명시적으로 제공합니다.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

사용 안 함 상태 및 이유를 사용하여 루트 CA 권한 부여를 사용하여 IoT 디바이스를 만듭니다.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

디바이스 범위를 사용하여 IoT 디바이스를 만듭니다.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

선택적 매개 변수

--am --auth-method

엔터티를 만들 권한 부여 메서드입니다.

허용되는 값: shared_private_key, x509_ca, x509_thumbprint

Default value: shared_private_key

--auth-type

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

허용되는 값: key, login

Default value: key

--device-scope

디바이스의 범위입니다. 에지 디바이스의 경우 자동 생성되고 변경할 수 없습니다. 리프 디바이스의 경우 자식/부모 관계를 만들도록 설정합니다.

--edge-enabled --ee

에지 사용 설정을 나타내는 플래그입니다.

허용되는 값: false, true

Default value: False

--hub-name -n

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

--login -l

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

--od --output-dir

자체 서명된 인증서를 생성하고 지문을 사용합니다. 지정된 대상 디렉터리에 출력합니다.

--pk --primary-key

base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.

--primary-thumbprint --ptp

기본 지문에 사용할 자체 서명된 인증서 지문입니다.

--resource-group -g

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

--secondary-key --sk

base64 형식으로 저장된 보조 대칭 공유 액세스 키입니다.

--secondary-thumbprint --stp

보조 지문에 사용할 자체 서명된 인증서 지문입니다.

--sta --status

만들 때 디바이스 상태를 설정합니다.

허용되는 값: disabled, enabled

Default value: enabled

--star --status-reason

디바이스 상태에 대한 설명입니다.

--valid-days --vd

자체 서명된 인증서를 생성하고 지문을 사용합니다. 지정된 일 수에 유효합니다. 기본값: 365.

전역 매개 변수

--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 device-identity delete

IoT Hub 디바이스를 삭제합니다.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

선택적 매개 변수

--auth-type

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

허용되는 값: key, login

Default value: key

--etag -e

리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 값 '*'이 사용됩니다.

--hub-name -n

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

--login -l

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

--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 device-identity export

모든 디바이스 ID를 IoT Hub에서 Azure Storage Blob 컨테이너로 내보냅니다.

디바이스 ID를 포함하는 출력 Blob은 'devices.txt'이라는 텍스트 파일입니다.

필요한 권한 - '레지스트리 읽기 및 레지스트리 쓰기'를 지원하는 IoT Hub 공유 액세스 정책 또는 IoT Hub에서 'IoT Hub 데이터 기여자' 역할을 가진 보안 주체 중 하나.

스토리지 계정 이름 및 Blob 컨테이너 이름 매개 변수는 스토리지 계정이 입력 IoT Hub와 동일한 구독에 있는 경우에만 사용할 수 있습니다. 인라인 Blob 컨테이너 SAS uri 입력의 경우 환경의 입력 규칙을 검토하세요.

자세한 내용은 https://aka.ms/iothub-device-exportimport를 참조하세요.

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc]
                                  [--bcu]
                                  [--hub-name]
                                  [--identity]
                                  [--ik {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa]

예제

모든 디바이스 ID를 구성된 Blob 컨테이너로 내보내고 디바이스 키를 포함합니다. Blob 컨테이너 이름 및 스토리지 계정 이름은 명령에 대한 매개 변수로 제공됩니다.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}

모든 디바이스 ID를 구성된 Blob 컨테이너로 내보내고 디바이스 키를 포함합니다. 인라인 SAS uri 예제를 사용합니다.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

SAS URI가 포함된 파일 경로를 사용하여 구성된 Blob 컨테이너로 모든 디바이스 ID를 내보냅니다.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

모든 디바이스 ID를 구성된 Blob 컨테이너로 내보내고 디바이스 키를 포함합니다. 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 있는 시스템 할당 ID를 사용합니다. Blob 컨테이너 이름 및 스토리지 계정 이름은 명령에 대한 매개 변수로 제공됩니다.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]

모든 디바이스 ID를 구성된 Blob 컨테이너로 내보내고 디바이스 키를 포함합니다. 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 있는 시스템 할당 ID를 사용합니다. Blob 컨테이너 URI에는 Blob SAS 토큰이 필요하지 않습니다.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]

모든 디바이스 ID를 구성된 Blob 컨테이너로 내보내고 디바이스 키를 포함합니다. 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 있는 사용자 할당 관리 ID를 사용합니다. Blob 컨테이너 이름 및 스토리지 계정 이름은 명령에 대한 매개 변수로 제공됩니다.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}

모든 디바이스 ID를 구성된 Blob 컨테이너로 내보내고 디바이스 키를 포함합니다. 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 있는 사용자 할당 관리 ID를 사용합니다. Blob 컨테이너 URI에는 Blob SAS 토큰이 필요하지 않습니다.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}

선택적 매개 변수

--auth-type

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

허용되는 값: key, login

Default value: key

--bc --blob-container

이 Blob 컨테이너는 디바이스 ID 가져오기 작업의 상태 및 결과를 출력하는 데 사용됩니다. 매개 변수는 blob_container_uri 제공될 때 무시됩니다. 이 Blob 컨테이너에는 쓰기, 읽기 및 삭제 액세스가 필요합니다.

--bcu --blob-container-uri

Blob 컨테이너에 대한 쓰기, 읽기 및 삭제 액세스 권한이 있는 Blob 공유 액세스 서명 URI입니다. 작업 상태 및 결과를 출력하는 데 사용됩니다. 참고: ID 기반 인증을 사용하는 경우 https:// URI가 여전히 필요하지만 SAS 토큰은 필요하지 않습니다. 이 인수에 대한 입력은 인라인 또는 파일 경로에서 입력할 수 있습니다.

--hub-name -n

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

--identity

관리 ID 유형은 시스템 할당 관리 ID 또는 사용자 할당 관리 ID가 사용되는지 여부를 확인합니다. 시스템 할당 관리 ID의 경우 [시스템]을 사용합니다. 사용자가 할당한 관리 ID의 경우 사용자에게 할당된 관리 ID 리소스 ID를 제공합니다. 이 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 필요합니다.

--ik --include-keys

설정된 경우 키를 정상적으로 내보냅니다. 그렇지 않으면 내보내기 출력에서 키가 null로 설정됩니다.

허용되는 값: false, true

Default value: False

--login -l

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

--resource-group -g

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

--sa --storage-account

출력 Blob 컨테이너를 포함하는 Azure Storage 계정의 이름입니다. 매개 변수는 blob_container_uri 제공될 때 무시됩니다. 쓰기, 읽기 및 삭제 액세스가 필요합니다.

전역 매개 변수

--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 device-identity import

스토리지 컨테이너 Blob에서 IoT Hub로 디바이스 ID를 가져옵니다.

디바이스 ID를 포함하는 예상 입력 파일의 이름은 'devices.txt'이어야 합니다. 가져오기에 성공하면 출력 로그 파일 'importErrors.log'이 비어 있으며 가져오기 실패 시 오류 로그가 포함됩니다.

필요한 권한 - '레지스트리 읽기 및 레지스트리 쓰기'를 지원하는 IoT Hub 공유 액세스 정책 또는 IoT Hub에서 'IoT Hub 데이터 기여자' 역할을 가진 보안 주체 중 하나.

스토리지 계정 이름 및 Blob 컨테이너 이름 매개 변수는 스토리지 계정이 입력 IoT Hub와 동일한 구독에 있는 경우에만 사용할 수 있습니다. 인라인 Blob 컨테이너 SAS uri 입력의 경우 환경의 입력 규칙을 검토하세요.

자세한 내용은 https://aka.ms/iothub-device-exportimport를 참조하세요.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc]
                                  [--ibcu]
                                  [--identity]
                                  [--input-storage-account]
                                  [--login]
                                  [--obc]
                                  [--obcu]
                                  [--osa]
                                  [--resource-group]

예제

입력 Blob 컨테이너 및 스토리지 계정과 출력 Blob 컨테이너 및 스토리지 계정에 대한 명령 매개 변수를 제공하여 Blob에서 모든 디바이스 ID를 가져옵니다.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}

인라인 SAS URI를 사용하여 Blob에서 모든 디바이스 ID를 가져옵니다.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

SAS URI가 포함된 파일 경로를 사용하여 Blob에서 모든 디바이스 ID를 가져옵니다.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

두 스토리지 계정에 대해 Storage Blob 데이터 기여자 역할이 있는 시스템 할당 ID를 사용하여 Blob에서 모든 디바이스 ID를 가져옵니다. 입력 Blob 컨테이너 및 스토리지 계정뿐만 아니라 출력 Blob 컨테이너 및 스토리지 계정은 명령에 대한 매개 변수로 제공됩니다.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]

두 스토리지 계정에 대해 Storage Blob 데이터 기여자 역할이 있는 시스템 할당 ID를 사용하여 Blob에서 모든 디바이스 ID를 가져옵니다. Blob 컨테이너 URI에는 Blob SAS 토큰이 필요하지 않습니다.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]

두 스토리지 계정에 대해 Storage Blob 데이터 기여자 역할이 있는 사용자 할당 관리 ID를 사용하여 Blob에서 모든 디바이스 ID를 가져옵니다. 입력 Blob 컨테이너 및 스토리지 계정뿐만 아니라 출력 Blob 컨테이너 및 스토리지 계정은 명령에 대한 매개 변수로 제공됩니다.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}

두 스토리지 계정에 대해 Storage Blob 데이터 기여자 역할이 있는 사용자 할당 관리 ID를 사용하여 Blob에서 모든 디바이스 ID를 가져옵니다. Blob 컨테이너 URI에는 Blob SAS 토큰이 필요하지 않습니다.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_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이 제공되지 않은 경우 필요합니다.

--ibc --input-blob-container

이 Blob 컨테이너는 ID 레지스트리에서 수행할 작업을 정의하는 파일을 저장합니다. 매개 변수는 input_blob_container_uri 제공될 때 무시됩니다. 이 Blob 컨테이너에는 읽기 액세스가 필요합니다.

--ibcu --input-blob-container-uri

Blob 컨테이너에 대한 읽기 권한이 있는 Blob 공유 액세스 서명 URI입니다. 이 Blob에는 ID 레지스트리에서 수행할 작업이 포함됩니다. 참고: ID 기반 인증을 사용하는 경우 https:// URI가 여전히 필요하지만 SAS 토큰은 필요하지 않습니다. 이 인수에 대한 입력은 인라인 또는 파일 경로에서 입력할 수 있습니다.

--identity

관리 ID 유형은 시스템 할당 관리 ID 또는 사용자 할당 관리 ID가 사용되는지 여부를 확인합니다. 시스템 할당 관리 ID의 경우 [시스템]을 사용합니다. 사용자가 할당한 관리 ID의 경우 사용자에게 할당된 관리 ID 리소스 ID를 제공합니다. 이 ID에는 IoT Hub의 대상 스토리지 계정 및 기여자 역할에 대한 Storage Blob 데이터 기여자 역할이 필요합니다.

--input-storage-account --isa

입력 Blob 컨테이너를 포함하는 Azure Storage 계정의 이름입니다. input_blob_container_uri 제공되지 않은 경우에만 필요합니다. 읽기 액세스가 필요합니다.

--login -l

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

--obc --output-blob-container

이 Blob 컨테이너는 디바이스 ID 가져오기 작업의 상태 및 결과를 출력하는 데 사용됩니다. input_blob_container_uri 제공되지 않은 경우에만 필요합니다. 이 Blob 컨테이너에는 쓰기 액세스가 필요합니다.

--obcu --output-blob-container-uri

Blob 컨테이너에 대한 쓰기 권한이 있는 Blob 공유 액세스 서명 URI입니다. 작업 상태 및 결과를 출력하는 데 사용됩니다. 참고: ID 기반 인증을 사용하는 경우 SAS 토큰이 없는 https:// URI는 여전히 필요합니다. 이 인수에 대한 입력은 인라인 또는 파일 경로에서 입력할 수 있습니다.

--osa --output-storage-account

출력 Blob 컨테이너를 포함하는 Azure Storage 계정의 이름입니다. 매개 변수는 output_blob_container_uri 제공될 때 무시됩니다. 쓰기 액세스가 필요합니다.

--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 device-identity list

IoT Hub에서 디바이스를 나열합니다.

이 명령은 이 명령에 대해 권장되는 별칭 az iot hub device-twin list입니다. 나중에 이 az iot hub device-identity list 명령은 변경되거나 사용되지 않을 수 있습니다.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

선택적 매개 변수

--auth-type

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

허용되는 값: key, login

Default value: key

--edge-enabled --ee

에지 사용 설정을 나타내는 플래그입니다.

허용되는 값: false, true

Default value: False

--hub-name -n

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

--login -l

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

--resource-group -g

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

--top

반환할 최대 요소 수입니다. 무제한으로 -1을 사용합니다.

Default value: 1000

전역 매개 변수

--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 device-identity renew-key

sas 인증을 사용하여 IoT Hub 디바이스의 대상 키를 갱신합니다.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type {primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--login]
                                     [--resource-group]

예제

기본 키를 갱신합니다.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

기본 키와 보조 키를 교환합니다.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

--hub-name -n

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

--key-type --kt

다시 생성할 대상 키 형식입니다.

허용되는 값: primary, secondary, swap

선택적 매개 변수

--auth-type

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

허용되는 값: key, login

Default value: key

--etag -e

리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 값 '*'이 사용됩니다.

--login -l

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

--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 device-identity show

IoT Hub 디바이스의 세부 정보를 가져옵니다.

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

필수 매개 변수

--device-id -d

대상 디바이스 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이 제공되지 않은 경우 필요합니다.

--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 device-identity update

IoT Hub 디바이스를 업데이트합니다.

디바이스를 업데이트하기 위해 --set 다음에 속성 할당을 사용합니다. 'iot hub device-identity show'에서 반환된 매개 변수를 활용합니다.

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--set]
                                  [--sta {disabled, enabled}]
                                  [--star]

예제

디바이스에 대한 에지 기능 켜기

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

편리한 인수를 사용하여 디바이스에 대한 에지 기능을 켭니다.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

디바이스 상태 사용 안 함

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

편의 인수를 사용하여 디바이스 상태를 사용하지 않도록 설정합니다.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

한 명령에서

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

선택적 매개 변수

--add

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

Default value: []

--am --auth-method

엔터티를 만들 권한 부여 메서드입니다.

허용되는 값: shared_private_key, x509_ca, x509_thumbprint

--auth-type

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

허용되는 값: key, login

Default value: key

--edge-enabled --ee

에지 사용 설정을 나타내는 플래그입니다.

허용되는 값: false, true

--etag -e

리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 값 '*'이 사용됩니다.

--force-string

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

Default value: False

--hub-name -n

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

--login -l

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

--pk --primary-key

base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.

--primary-thumbprint --ptp

기본 지문에 사용할 자체 서명된 인증서 지문입니다.

--remove

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

Default value: []

--resource-group -g

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

--secondary-key --sk

base64 형식으로 저장된 보조 대칭 공유 액세스 키입니다.

--secondary-thumbprint --stp

보조 지문에 사용할 자체 서명된 인증서 지문입니다.

--set

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

Default value: []

--sta --status

만들 때 디바이스 상태를 설정합니다.

허용되는 값: disabled, enabled

--star --status-reason

디바이스 상태에 대한 설명입니다.

전역 매개 변수

--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를 사용합니다.