az iot device registration

참고

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

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

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

명령

az iot device registration create

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

az iot device registration create

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

--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-scope가 제공되지 않은 경우 필요합니다.

--pass --passphrase

인증서의 암호입니다.

--payload

JSON으로 사용자 지정 할당 페이로드. 특히 Azure Functions 사용하여 사용자 지정 할당 정책에 사용합니다.

--resource-group -g

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