az iot device registration

미리 보기
참조

참고 항목

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

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Device Provisioning Service에 대한 IoT 디바이스 등록을 관리합니다.

등록을 사용 az iot dps enrollment registration 하거나 az iot dps enrollment-group registration 삭제합니다.

명령

Name	Description	형식	상태
az iot device registration create	IoT Device Provisioning Service에 IoT 디바이스를 등록합니다.	내선 번호	미리 보기

az iot device registration create

미리 보기

명령 그룹 'iot 디바이스 등록'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Device Provisioning Service에 IoT 디바이스를 등록합니다.

지원되는 증명 메커니즘은 다음과 같습니다.

대칭 키
x509 인증서 x509 인증 방법을 사용하는 경우 인증서 및 키 파일(필요한 경우 암호)을 제공해야 합니다.

az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

예제

개별 등록을 사용하여 IoT 디바이스를 등록합니다.

az iot device registration create -n {dps_name} --rid {registration_id}

그룹 등록을 사용하여 IoT 디바이스를 등록합니다.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

개별 등록, Device Provisioning Service ID 범위 및 지정된 대칭 키를 사용하여 IoT 디바이스를 등록합니다. 이렇게 하면 ID 범위 및 individal 등록 대칭 키 검색을 무시합니다.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

그룹 등록, Device Provisioning Service ID 범위 및 지정된 등록 그룹 대칭 키를 사용하여 IoT 디바이스를 등록합니다. 이렇게 하면 ID 범위 및 등록 그룹 대칭 키 검색을 무시합니다. 디바이스 등록에 사용되는 대칭 키는 지정된 대칭 키에서 계산됩니다.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

그룹 등록, Device Provisioning Service ID 범위 및 지정된 대칭 키를 사용하여 IoT 디바이스를 등록합니다. 이렇게 하면 ID 범위 검색이 무시됩니다. 대칭 키는 계산된 디바이스 키여야 하므로 등록 그룹 ID가 필요하지 않습니다.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

개별 등록, Device Provisioning Service ID 범위 및 지정된 인증서 및 키 파일을 사용하여 IoT 디바이스를 등록합니다. 이렇게 하면 ID 범위 검색이 무시됩니다.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

개별 등록, Device Provisioning Service ID 범위, 키 파일에 대한 인증서 및 키 파일 및 암호를 사용하여 IoT 디바이스를 등록합니다. 이렇게 하면 ID 범위 검색이 무시됩니다.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

그룹 등록, Device Provisioning Service ID 범위 및 지정된 인증서 및 키 파일을 사용하여 IoT 디바이스를 등록합니다. 이렇게 하면 ID 범위 검색이 무시됩니다. x509 증명에는 그룹 등록 ID가 필요하지 않으며 인증서 파일의 주체는 등록 ID입니다.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

필수 매개 변수

--registration-id --rid

디바이스 등록 ID 또는 개별 등록 ID입니다.

선택적 매개 변수

--auth-type

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

허용되는 값: key, login

기본값: key

--certificate-file-path --cp

인증서 PEM 파일의 경로입니다. x509 등록에 필요합니다.

--ck --compute-key

--symmetric-key를 사용하여 지정된 키에서 디바이스 등록에 대한 대칭 키를 계산해야 함을 나타내는 플래그입니다.

기본값: False

--dps-name -n

Azure IoT Hub Device Provisioning Service의 이름입니다. --login이 제공되지 않거나 authenticaton 인수 및 --id 범위가 제공되지 않는 경우 필요합니다.

--enrollment-group-id --gid --group-id

등록 그룹 ID입니다. 인증 인수를 검색하는 데만 필요합니다.

--host --provisioning-host

사용할 프로비저닝 호스트를 가리키는 엔드포인트입니다.

기본값: global.azure-devices-provisioning.net

--id-scope --scope

Azure IoT Hub Device Provisioning Service의 ID 범위입니다. 인증 인수와 함께 제공되는 경우 세션 로그인을 방지합니다.

--key --symmetric-key

디바이스 등록에 대한 대칭 공유 액세스 키입니다.

--key-file-path --kp

키 PEM 파일의 경로입니다. x509 등록에 필요합니다.

--login -l

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

--pass --passphrase

인증서의 암호입니다.

--payload

JSON으로 사용자 지정 할당 페이로드. 특히 Azure Functions를 사용하는 사용자 지정 할당 정책에 사용할 수 있습니다.

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

명령

az iot device registration create

예제

필수 매개 변수

선택적 매개 변수

피드백

추가 리소스