az iot dps enrollment

참고

이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.0.70 이상 이어야 합니다. 확장은 az iot dps 등록 명령을 처음 실행할 때 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요 .

Azure IoT Hub 장치 프로 비전 서비스에서 등록를 관리 합니다.

명령

az iot dps enrollment create

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 만듭니다.

az iot dps enrollment delete

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 삭제 합니다.

az iot dps enrollment list

장치 프로 비전 서비스 Azure IoT Hub 장치 등록를 나열 합니다.

az iot dps enrollment show

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록 정보를 가져옵니다.

az iot dps enrollment update

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 업데이트 합니다.

az iot dps enrollment create

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 만듭니다.

az iot dps enrollment create --at {symmetricKey, tpm, x509}
                             --dps-name
                             --enrollment-id
                             --resource-group
                             [--allocation-policy {custom, geolatency, hashed, static}]
                             [--api-version]
                             [--certificate-path]
                             [--device-id]
                             [--edge-enabled {false, true}]
                             [--ek]
                             [--hn]
                             [--ih]
                             [--initial-twin-properties]
                             [--initial-twin-tags]
                             [--pk]
                             [--provisioning-status {disabled, enabled}]
                             [--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
                             [--scp]
                             [--secondary-key]
                             [--webhook-url]

예제

리소스 그룹 ' {resource_group_name} '의 Azure IoT 프로 비전 서비스 ' {dps_name} '에서 증명 형식이 ' x509 ' 인 등록 ' {enrollment_id} '을 (를) 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type x509 --certificate-path /certificates/Certificate.pem

프로 비전 상태가 ' disabled ' 인 리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 증명 형식 ' x509 '로 등록 ' {enrollment_id} '을 (를) 만듭니다. 대상 IoT Hub ' {iothub_host_name} ', 장치 id ' {device_id} ', 초기 쌍 속성 ' {"location": {"region": "US"}} ' 및 초기 쌍 태그 ' {"version": "1"} '.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type x509 --certificate-path /certificates/Certificate.pem --provisioning-status disabled --iot-hub-host-name {iothub_host_name} --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version':'1'}" --device-id {device_id}

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 증명 형식이 ' tpm ' 인 등록 ' MyEnrollment '을 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 증명 형식이 ' symmetrickey ' 인 등록 ' MyEnrollment '을 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --primary-key {primary_key} --secondary-key {secondary_key}

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 다시 구축를 사용 하 여 ' MyEnrollment ' 등록을 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --reprovision-policy {reprovision_type} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 정적 할당 정책을 사용 하 여 ' MyEnrollment ' 등록을 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy static --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name}

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 해시 된 할당 정책 및 여러 허브를 사용 하 여 ' MyEnrollment ' 등록을 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy hashed --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs "{iot_hub_host_name1} {iot_hub_host_name2}"

사용자 지정 할당 정책으로 ' MyEnrollment ' 등록을 만듭니다.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}

필수 매개 변수

--at --attestation-type

증명 메커니즘.

허용되는 값: symmetricKey, tpm, x509
--dps-name

Azure IoT Hub 장치 프로 비전 서비스의 이름입니다.

--enrollment-id

장치 등록 레코드의 ID입니다.

--resource-group -g

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

선택적 매개 변수

--allocation-policy --ap

허브에 할당 된 장치에 대 한 할당 유형입니다.

허용되는 값: custom, geolatency, hashed, static
--api-version --av

사용자 지정 할당 요청에서 전송 된 프로 비전 서비스 형식의 API 버전입니다. 지원 되는 최소 버전: 2018-09-01-미리 보기

--certificate-path --cp

기본 인증서를 포함 하는 파일의 경로입니다. 증명 형식으로 x509를 선택 하는 경우 인증서 경로 중 하나가 필요 합니다.

--device-id -d

장치 ID를 IoT Hub 합니다.

--edge-enabled --ee

가장자리 활성화를 나타내는 플래그입니다.

허용되는 값: false, true
--ek --endorsement-key

TPM 장치에 대 한 TPM 인증 키입니다. Tpm을 증명 형식으로 선택 하는 경우 인증 키가 필요 합니다.

--hn --iot-hub-host-name

대상 IoT Hub의 호스트 이름입니다.

--ih --iot-hubs

대상 IoT Hub의 호스트 이름입니다. 여러 IoT Hub에 공백으로 구분 된 목록을 사용 합니다.

--initial-twin-properties --props

초기 쌍 속성입니다.

--initial-twin-tags --tags

초기 쌍 태그입니다.

--pk --primary-key

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

--provisioning-status --ps

등록 항목을 사용 하거나 사용 하지 않도록 설정 합니다.

허용되는 값: disabled, enabled
--reprovision-policy --rp

다른 Iot Hub에 다시 프로 비전 할 때 처리할 장치 데이터입니다.

허용되는 값: never, reprovisionandmigratedata, reprovisionandresetdata
--scp --secondary-certificate-path

보조 인증서를 포함 하는 파일의 경로입니다. 증명 형식으로 x509를 선택 하는 경우 인증서 경로 중 하나가 필요 합니다.

--secondary-key --sk

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

--webhook-url --wh

사용자 지정 할당 요청에 사용 되는 webhook URL입니다.

az iot dps enrollment delete

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 삭제 합니다.

az iot dps enrollment delete --dps-name
                             --enrollment-id
                             --resource-group
                             [--etag]

필수 매개 변수

--dps-name

Azure IoT Hub 장치 프로 비전 서비스의 이름입니다.

--enrollment-id

장치 등록 레코드의 ID입니다.

--resource-group -g

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

선택적 매개 변수

--etag -e

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

az iot dps enrollment list

장치 프로 비전 서비스 Azure IoT Hub 장치 등록를 나열 합니다.

az iot dps enrollment list --dps-name
                           --resource-group
                           [--top]

필수 매개 변수

--dps-name

Azure IoT Hub 장치 프로 비전 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--top

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

az iot dps enrollment show

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록 정보를 가져옵니다.

az iot dps enrollment show --dps-name
                           --enrollment-id
                           --resource-group
                           [--keys {false, true}]

예제

기본적인 사용 방법

az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}

대칭 키 등록 결과에 전체 증명 정보 포함

az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys

필수 매개 변수

--dps-name

Azure IoT Hub 장치 프로 비전 서비스의 이름입니다.

--enrollment-id

장치 등록 레코드의 ID입니다.

--resource-group -g

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

선택적 매개 변수

--keys --show-keys

등록 결과에 증명 키와 정보를 포함 합니다.

허용되는 값: false, true

az iot dps enrollment update

Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 업데이트 합니다.

az iot dps enrollment update --dps-name
                             --enrollment-id
                             --resource-group
                             [--allocation-policy {custom, geolatency, hashed, static}]
                             [--api-version]
                             [--certificate-path]
                             [--device-id]
                             [--edge-enabled {false, true}]
                             [--ek]
                             [--etag]
                             [--hn]
                             [--ih]
                             [--initial-twin-properties]
                             [--initial-twin-tags]
                             [--pk]
                             [--provisioning-status {disabled, enabled}]
                             [--rc {false, true}]
                             [--remove-secondary-certificate {false, true}]
                             [--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
                             [--scp]
                             [--secondary-key]
                             [--webhook-url]

예제

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 새 x509 인증서로 등록 ' {enrollment_id} '을 (를) 업데이트 하세요.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 새 인증 키로 ' {enrollment_id} ' 등록을 업데이트 합니다.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --etag AAAAAAAAAAA=

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 새 기본 키로 등록 ' {enrollment_id} '을 (를) 업데이트 하세요.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 새 다시 구축 형식으로 ' {enrollment_id} ' 등록을 업데이트 합니다.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --reprovision-policy {reprovision_type} --etag AAAAAAAAAAA=

리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 새 할당 정책으로 ' {enrollment_id} ' 등록을 업데이트 합니다.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy geolatency --etag AAAAAAAAAAA= --iot-hubs "{iot_hub_host_name1} {iot_hub_host_name2} {iot_hub_host_name3}"

초기 쌍 속성 ' {"location": {"region": "USA"}} ' 및 초기 쌍 태그 ' {"version": "2"} ' 인 리소스 그룹 ' {resource_group_name} '의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에서 ' {enrollment_id} ' 등록을 업데이트 합니다.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version1':'2'}"

필수 매개 변수

--dps-name

Azure IoT Hub 장치 프로 비전 서비스의 이름입니다.

--enrollment-id

장치 등록 레코드의 ID입니다.

--resource-group -g

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

선택적 매개 변수

--allocation-policy --ap

허브에 할당 된 장치에 대 한 할당 유형입니다.

허용되는 값: custom, geolatency, hashed, static
--api-version --av

사용자 지정 할당 요청에서 전송 된 프로 비전 서비스 형식의 API 버전입니다. 지원 되는 최소 버전: 2018-09-01-미리 보기

--certificate-path --cp

기본 인증서를 포함 하는 파일의 경로입니다.

--device-id -d

장치 ID를 IoT Hub 합니다.

--edge-enabled --ee

가장자리 활성화를 나타내는 플래그입니다.

허용되는 값: false, true
--ek --endorsement-key

TPM 장치에 대 한 TPM 인증 키입니다.

--etag -e

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

--hn --iot-hub-host-name

대상 IoT Hub의 호스트 이름입니다.

--ih --iot-hubs

대상 IoT Hub의 호스트 이름입니다. 여러 IoT Hub에 공백으로 구분 된 목록을 사용 합니다.

--initial-twin-properties --props

초기 쌍 속성입니다.

--initial-twin-tags --tags

초기 쌍 태그입니다.

--pk --primary-key

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

--provisioning-status --ps

등록 항목을 사용 하거나 사용 하지 않도록 설정 합니다.

허용되는 값: disabled, enabled
--rc --remove-certificate

현재 기본 인증서를 제거 합니다.

허용되는 값: false, true
--remove-secondary-certificate --rsc

현재 보조 인증서를 제거 합니다.

허용되는 값: false, true
--reprovision-policy --rp

다른 Iot Hub에 다시 프로 비전 할 때 처리할 장치 데이터입니다.

허용되는 값: never, reprovisionandmigratedata, reprovisionandresetdata
--scp --secondary-certificate-path

보조 인증서를 포함 하는 파일의 경로입니다.

--secondary-key --sk

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

--webhook-url --wh

사용자 지정 할당 요청에 사용 되는 webhook URL입니다.