az iot dps enrollment
참고 항목
이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot dps enrollment 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 관리합니다.
명령
Name | Description | 형식 | 상태 |
---|---|---|---|
az iot dps enrollment create |
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 만듭니다. |
내선 번호 | GA |
az iot dps enrollment delete |
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 삭제합니다. |
내선 번호 | GA |
az iot dps enrollment list |
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 나열합니다. |
내선 번호 | GA |
az iot dps enrollment registration |
Azure IoT Hub Device Provisioning Service에서 개별 등록에 대한 서비스 쪽 디바이스 등록을 관리합니다. |
내선 번호 | GA |
az iot dps enrollment registration delete |
Azure IoT Hub Device Provisioning Service에서 개별 등록에 대한 디바이스 등록을 삭제합니다. |
내선 번호 | GA |
az iot dps enrollment registration show |
Azure IoT Hub Device Provisioning Service에서 개별 등록에 대한 디바이스 등록을 가져옵니다. |
내선 번호 | GA |
az iot dps enrollment show |
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록 세부 정보를 가져옵니다. |
내선 번호 | GA |
az iot dps enrollment update |
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 업데이트합니다. |
내선 번호 | GA |
az iot dps enrollment create
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 만듭니다.
Base64 ASCII 인코딩을 사용하여 인증서 형식을 제공하세요. 인증서에 일치하는 BEGIN 및 END 세그먼트가 있어야 합니다(예: '-----BEGIN CERTIFICATE-----'로 시작하고 '-----END CERTIFICATE-----'로 끝납니다.
az iot dps enrollment create --at {symmetricKey, tpm, x509}
--eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--certificate-path]
[--device-id]
[--device-information]
[--dps-name]
[--edge-enabled {false, true}]
[--ek]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scp]
[--secondary-key]
[--webhook-url]
예제
리소스 그룹 '{enrollment_id}'의 Azure IoT Device Provisioning Service '{dps_name}'에서 증명 유형이 'x509'인 등록 '{resource_group_name}'을(를) 프로비전 상태가 '사용 안 함'으로 만듭니다. 디바이스 ID '{device_id}', 초기 트윈 속성 '{"location":{"region":"US"}}', 초기 트윈 태그 '{"version":"1"}' 및 디바이스 정보 '{"color":"red"}'.
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 --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version':'1'}" --device-info "{'color':'red'}" --device-id {device_id}
리소스 그룹 '{resource_group_name}'의 Azure IoT Device Provisioning Service '{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 Device Provisioning Service '{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 Device Provisioning Service '{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 Device Provisioning Service '{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 Device Provisioning Service '{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}
필수 매개 변수
DPS에 대한 인증에 사용되는 증명 메커니즘입니다.
개별 디바이스 등록 ID입니다.
선택적 매개 변수
디바이스가 IoT Hub에 할당되는 방법을 결정하는 할당 정책 유형입니다. 할당 정책이 제공되지 않으면 Device Provisioning Service 인스턴스에 대한 현재 할당 정책 기본값이 됩니다.
사용자 지정 할당 요청에서 전송된 프로비저닝 서비스 유형의 API 버전입니다. 지원되는 최소 버전: 2018-09-01-preview.
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iotdps-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
기본 인증서를 포함하는 파일의 경로입니다. 증명 유형으로 x509를 선택할 때 필요하며 보조 인증서 경로가 제공되지 않습니다.
IoT Hub에 등록된 디바이스 ID입니다.
선택적 디바이스 정보입니다.
Azure IoT Hub Device Provisioning Service의 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
에지 사용 설정을 나타내는 플래그입니다.
TPM 디바이스에 대한 TPM 인증 키입니다. tpm을 증명 유형으로 선택하는 경우 인증 키가 필요합니다.
할당 정책과 연결된 대상 IoT Hub의 호스트 이름입니다. 여러 IoT Hub에 대해 공백으로 구분된 목록을 사용합니다.
초기 디바이스 쌍 속성입니다.
초기 디바이스 쌍 태그입니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --dps-name이 제공되지 않은 경우 필수입니다.
base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.
등록 항목을 사용하거나 사용하지 않도록 설정합니다.
다른 IoT Hub에 다시 프로비전할 때 디바이스 데이터를 처리하는 방법을 결정하는 정책입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
보조 인증서를 포함하는 파일의 경로입니다. x509를 증명 유형으로 선택할 때 필요하며 기본 인증서 경로가 제공되지 않습니다.
base64 형식으로 저장된 보조 대칭 공유 액세스 키입니다.
사용자 지정 할당 요청에 사용되는 Azure Function 웹후크 URL입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment delete
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 삭제합니다.
az iot dps enrollment delete --eid
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
필수 매개 변수
개별 디바이스 등록 ID입니다.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iotdps-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
Azure IoT Hub Device Provisioning Service의 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 값 '*'이 사용됩니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --dps-name이 제공되지 않은 경우 필수입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment list
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 나열합니다.
az iot dps enrollment list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iotdps-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
Azure IoT Hub Device Provisioning Service의 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --dps-name이 제공되지 않은 경우 필수입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
반환할 최대 요소 수입니다. 무제한으로 -1을 사용합니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment show
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록 세부 정보를 가져옵니다.
az iot dps enrollment show --eid
[--auth-type {key, login}]
[--dps-name]
[--keys {false, true}]
[--login]
[--resource-group]
예제
기본 사용법
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
필수 매개 변수
개별 디바이스 등록 ID입니다.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iotdps-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
Azure IoT Hub Device Provisioning Service의 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
등록 결과에 증명 키 및 정보를 포함합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --dps-name이 제공되지 않은 경우 필수입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment update
Azure IoT Hub Device Provisioning Service에서 개별 디바이스 등록을 업데이트합니다.
Base64 ASCII 인코딩을 사용하여 인증서 형식을 제공하세요. 인증서에 일치하는 BEGIN 및 END 세그먼트가 있어야 합니다(예: '-----BEGIN CERTIFICATE-----'로 시작하고 '-----END CERTIFICATE-----'로 끝납니다.
az iot dps enrollment update --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--certificate-path]
[--device-id]
[--device-information]
[--dps-name]
[--edge-enabled {false, true}]
[--ek]
[--etag]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--rc {false, true}]
[--remove-secondary-certificate {false, true}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scp]
[--secondary-key]
[--webhook-url]
예제
리소스 그룹 '{resource_group_name}'의 Azure IoT Device Provisioning Service '{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 Device Provisioning Service '{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 Device Provisioning Service '{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 Device Provisioning Service '{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 Device Provisioning Service '{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"}}', 초기 트윈 태그 'dps_name{"version":"2"}' 및 디바이스 정보 '{"color":"red"}'를 사용하여 리소스 그룹 '{resource_group_name}'의 Azure IoT Device Provisioning Service '{enrollment_id}'에서 등록 '{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'}" --device-info "{'color':'red'}"
필수 매개 변수
개별 디바이스 등록 ID입니다.
선택적 매개 변수
디바이스가 IoT Hub에 할당되는 방법을 결정하는 할당 정책 유형입니다. 할당 정책이 제공되지 않으면 Device Provisioning Service 인스턴스에 대한 현재 할당 정책 기본값이 됩니다.
사용자 지정 할당 요청에서 전송된 프로비저닝 서비스 유형의 API 버전입니다. 지원되는 최소 버전: 2018-09-01-preview.
작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iotdps-data-auth-type=<auth-type-value>
기본값을 구성할 수 있습니다.
기본 인증서를 포함하는 파일의 경로입니다.
IoT Hub에 등록된 디바이스 ID입니다.
선택적 디바이스 정보입니다.
Azure IoT Hub Device Provisioning Service의 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
에지 사용 설정을 나타내는 플래그입니다.
TPM 디바이스에 대한 TPM 인증 키입니다.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 값 '*'이 사용됩니다.
할당 정책과 연결된 대상 IoT Hub의 호스트 이름입니다. 여러 IoT Hub에 대해 공백으로 구분된 목록을 사용합니다.
초기 디바이스 쌍 속성입니다.
초기 디바이스 쌍 태그입니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --dps-name이 제공되지 않은 경우 필수입니다.
base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.
등록 항목을 사용하거나 사용하지 않도록 설정합니다.
현재 기본 인증서를 제거하는 플래그입니다.
현재 보조 인증서를 제거하는 플래그입니다.
다른 IoT Hub에 다시 프로비전할 때 디바이스 데이터를 처리하는 방법을 결정하는 정책입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
보조 인증서를 포함하는 파일의 경로입니다.
base64 형식으로 저장된 보조 대칭 공유 액세스 키입니다.
사용자 지정 할당 요청에 사용되는 Azure Function 웹후크 URL입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
Azure CLI