az iot dps enrollment
참고
이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.17.1 이상 이어야 합니다. 확장은 az iot dps 등록 명령을 처음 실행할 때 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요.
Azure IoT 허브 장치 프로 비전 서비스에서 등록를 관리 합니다.
명령
| az iot dps enrollment create |
Azure IoT 허브 장치 프로 비전 서비스에서 장치 등록을 만듭니다. |
| az iot dps enrollment delete |
Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 삭제 합니다. |
| az iot dps enrollment list |
Azure IoT 허브 장치 프로 비전 서비스에서 장치 등록를 나열 합니다. |
| az iot dps enrollment show |
Azure IoT 허브 장치 프로 비전 서비스에서 장치 등록 정보를 가져옵니다. |
| az iot dps enrollment update |
Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 업데이트 합니다. |
az iot dps enrollment create
Azure IoT 허브 장치 프로 비전 서비스에서 장치 등록을 만듭니다.
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} '에서 증명 형식이 ' m a s s ' 인 등록 ' 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}
필수 매개 변수
증명 메커니즘.
Azure IoT 허브 장치 프로 비전 서비스의 이름입니다.
장치 등록 레코드의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
허브에 할당 된 장치에 대 한 할당 유형입니다.
사용자 지정 할당 요청에서 전송 된 프로 비전 서비스 형식의 API 버전입니다. 지원 되는 최소 버전: 2018-09-01-미리 보기
기본 인증서를 포함 하는 파일의 경로입니다. 증명 형식으로 x509를 선택 하는 경우 인증서 경로 중 하나가 필요 합니다.
장치 ID를 IoT Hub 합니다.
가장자리 활성화를 나타내는 플래그입니다.
TPM 장치에 대 한 TPM 인증 키입니다. Tpm을 증명 형식으로 선택 하는 경우 인증 키가 필요 합니다.
대상 IoT Hub의 호스트 이름입니다.
대상 IoT Hub의 호스트 이름입니다. 여러 IoT Hub에 공백으로 구분 된 목록을 사용 합니다.
초기 쌍 속성입니다.
초기 쌍 태그입니다.
Base64 형식으로 저장 된 기본 대칭 공유 액세스 키입니다.
등록 항목을 사용 하거나 사용 하지 않도록 설정 합니다.
다른 Iot Hub에 다시 프로 비전 할 때 처리할 장치 데이터입니다.
보조 인증서를 포함 하는 파일의 경로입니다. 증명 형식으로 x509를 선택 하는 경우 인증서 경로 중 하나가 필요 합니다.
Base64 형식으로 저장 된 보조 대칭 공유 액세스 키입니다.
사용자 지정 할당 요청에 사용 되는 webhook URL입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment delete
Azure IoT Hub 장치 프로 비전 서비스에서 장치 등록을 삭제 합니다.
az iot dps enrollment delete --dps-name
--enrollment-id
--resource-group
[--etag]
필수 매개 변수
Azure IoT 허브 장치 프로 비전 서비스의 이름입니다.
장치 등록 레코드의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
리소스의 마지막 상태에 해당 하는 Etag 또는 엔터티 태그입니다. Etag를 제공 하지 않으면 ' ' 값 * 이 사용 됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment list
Azure IoT 허브 장치 프로 비전 서비스에서 장치 등록를 나열 합니다.
az iot dps enrollment list --dps-name
--resource-group
[--top]
필수 매개 변수
Azure IoT 허브 장치 프로 비전 서비스의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
반환할 최대 요소 수입니다. 무제한의 경우-1을 사용 합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment show
Azure IoT 허브 장치 프로 비전 서비스에서 장치 등록 정보를 가져옵니다.
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
필수 매개 변수
Azure IoT 허브 장치 프로 비전 서비스의 이름입니다.
장치 등록 레코드의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
등록 결과에 증명 키와 정보를 포함 합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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=
' {enrollment_id} ' 등록을 ' {resource_group_name} ' 리소스 그룹의 Azure IoT 장치 프로 비전 서비스 ' {dps_name} '에 있는 새 할당 정책으로 업데이트 하세요.
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'}"
필수 매개 변수
Azure IoT 허브 장치 프로 비전 서비스의 이름입니다.
장치 등록 레코드의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
허브에 할당 된 장치에 대 한 할당 유형입니다.
사용자 지정 할당 요청에서 전송 된 프로 비전 서비스 형식의 API 버전입니다. 지원 되는 최소 버전: 2018-09-01-미리 보기
기본 인증서를 포함 하는 파일의 경로입니다.
장치 ID를 IoT Hub 합니다.
가장자리 활성화를 나타내는 플래그입니다.
TPM 장치에 대 한 TPM 인증 키입니다.
리소스의 마지막 상태에 해당 하는 Etag 또는 엔터티 태그입니다. Etag를 제공 하지 않으면 ' ' 값 * 이 사용 됩니다.
대상 IoT Hub의 호스트 이름입니다.
대상 IoT Hub의 호스트 이름입니다. 여러 IoT Hub에 공백으로 구분 된 목록을 사용 합니다.
초기 쌍 속성입니다.
초기 쌍 태그입니다.
Base64 형식으로 저장 된 기본 대칭 공유 액세스 키입니다.
등록 항목을 사용 하거나 사용 하지 않도록 설정 합니다.
현재 기본 인증서를 제거 합니다.
현재 보조 인증서를 제거 합니다.
다른 Iot Hub에 다시 프로 비전 할 때 처리할 장치 데이터입니다.
보조 인증서를 포함 하는 파일의 경로입니다.
Base64 형식으로 저장 된 보조 대칭 공유 액세스 키입니다.
사용자 지정 할당 요청에 사용 되는 webhook URL입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.