az iot dps enrollment-group
참고
이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az iot dps enrollment-group 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.
Azure IoT Hub Device Provisioning Service를 관리합니다.
명령
| az iot dps enrollment-group create |
Azure IoT Hub Device Provisioning Service에서 등록 그룹을 만듭니다. |
| az iot dps enrollment-group delete |
Azure IoT Hub Device Provisioning Service에서 등록 그룹을 삭제합니다. |
| az iot dps enrollment-group list |
Azure IoT Hub Device Provisioning Service의 등록 그룹을 나열합니다. |
| az iot dps enrollment-group show |
Azure IoT Hub Device Provisioning Service에서 등록 그룹의 세부 정보를 얻습니다. |
| az iot dps enrollment-group update |
Azure IoT Hub Device Provisioning Service에서 등록 그룹을 업데이트합니다. |
az iot dps enrollment-group create
Azure IoT Hub Device Provisioning Service에서 등록 그룹을 만듭니다.
az iot dps enrollment-group create --dps-name
--enrollment-id
--resource-group
[--allocation-policy {custom, geolatency, hashed, static}]
[--api-version]
[--ca-name]
[--certificate-path]
[--edge-enabled {false, true}]
[--hn]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--pk]
[--provisioning-status {disabled, enabled}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
예제
중간 인증서를 기본 인증서로 사용하여 리소스 그룹 '{resource_group_name}'의 Azure IoT 프로비저닝 서비스 '{dps_name}'에 등록 그룹 '{enrollment_id}'을 만듭니다.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem
CA 인증서 {certificate_name}를 보조 인증서로 사용하여 리소스 그룹 '{resource_group_name}'의 Azure IoT 프로비저닝 서비스 '{dps_name}'에 등록 그룹 '{enrollment_id}'을 만듭니다.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}
중간 인증서를 기본 인증서로 사용하여 리소스 그룹 '{resource_group_name}', 대상 Azure IoT IoT Hub '{iothub_host_name}', 초기 쌍 속성 '{"location":{"region":"US"}}' 및 초기 쌍 태그 '{"version_dps":"1"}'을 사용하여 리소스 그룹 '{resource_group_name}'의 등록 그룹 '{enrollment_id}'을 만듭니다.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --iot-hub-host-name {iothub_host_name} --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"
증명 유형이 'symmetrickey'인 리소스 그룹 '{resource_group_name}의 Azure IoT 프로비저닝 서비스 '{dps_name}'에 등록 그룹 '{enrollment_id}'을 만듭니다.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {primary_key} --secondary-key {secondary_key}
사용자 지정 할당 정책을 사용하여 등록 그룹 '{enrollment_id}'을 만듭니다.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
필수 매개 변수
Azure IoT Hub 디바이스 프로비저닝 서비스의 이름입니다.
등록 그룹의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
허브에 할당된 디바이스에 대한 할당 유형입니다.
사용자 지정 할당 요청에서 전송된 프로비전 서비스 유형의 API 버전입니다. 지원되는 최소 버전: 2018-09-01-preview.
기본 루트 CA 인증서의 이름입니다. 루트 CA 인증서가 있는 증명을 원하는 경우 루트 ca 이름을 제공해야 합니다.
기본 인증서를 포함하는 파일의 경로입니다. 중간 인증서가 있는 증명을 원하는 경우 인증서 경로를 제공해야 합니다.
에지 사용을 나타내는 플래그입니다.
대상 IoT Hub 호스트 이름입니다.
대상 IoT Hub 호스트 이름입니다. 여러 IoT Hub에 대해 공백으로 구분된 목록을 사용합니다.
초기 쌍 속성입니다.
초기 쌍 태그입니다.
base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.
등록 항목을 사용하거나 사용하지 않도록 설정합니다.
다른 Iot Hub로 다시 프로비전할 때 처리할 디바이스 데이터입니다.
보조 루트 CA 인증서의 이름입니다. 루트 CA 인증서가 있는 증명을 원하는 경우 루트 ca 이름을 제공해야 합니다.
보조 인증서를 포함하는 파일의 경로입니다. 중간 인증서가 있는 증명을 원하는 경우 인증서 경로를 제공해야 합니다.
base64 형식으로 저장된 보조 대칭 공유 액세스 키입니다.
사용자 지정 할당 요청에 사용되는 웹후크 URL입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment-group delete
Azure IoT Hub Device Provisioning Service에서 등록 그룹을 삭제합니다.
az iot dps enrollment-group delete --dps-name
--enrollment-id
--resource-group
[--etag]
필수 매개 변수
Azure IoT Hub 디바이스 프로비저닝 서비스의 이름입니다.
등록 그룹의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment-group list
Azure IoT Hub Device Provisioning Service의 등록 그룹을 나열합니다.
az iot dps enrollment-group list --dps-name
--resource-group
[--top]
필수 매개 변수
Azure IoT Hub 디바이스 프로비저닝 서비스의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
반환할 최대 요소 수입니다. 무제한으로 -1을 사용합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment-group show
Azure IoT Hub Device Provisioning Service에서 등록 그룹의 세부 정보를 얻습니다.
az iot dps enrollment-group show --dps-name
--enrollment-id
--resource-group
[--keys {false, true}]
예제
기본적인 사용 방법
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
대칭 키 enrollment-group에 대한 결과에 전체 증명 정보 포함
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
필수 매개 변수
Azure IoT Hub 디바이스 프로비저닝 서비스의 이름입니다.
등록 그룹의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
등록 그룹 결과에 증명 키 및 정보를 포함합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot dps enrollment-group update
Azure IoT Hub Device Provisioning Service에서 등록 그룹을 업데이트합니다.
az iot dps enrollment-group update --dps-name
--enrollment-id
--resource-group
[--allocation-policy {custom, geolatency, hashed, static}]
[--api-version]
[--ca-name]
[--certificate-path]
[--edge-enabled {false, true}]
[--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}]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
예제
리소스 그룹 '{resource_group_name}'의 Azure IoT 프로비저닝 서비스 '{dps_name}'에서 등록 그룹 '{enrollment_id}'을 초기 쌍 속성 및 초기 트윈 태그로 업데이트합니다.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=
리소스 그룹 '{resource_group_name}'의 Azure IoT 프로비저닝 서비스 '{dps_name}'에서 등록 그룹 '{enrollment_id}'을 새 주 중간 인증서로 업데이트하고 기존 보조 중간 인증서를 제거합니다.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --remove-secondary-certificate --etag AAAAAAAAAAA=
리소스 그룹 '{resource_group_name}'의 Azure IoT 프로비저닝 서비스 '{dps_name}'에서 등록 그룹 '{enrollment_id}'을 새 보조 CA 인증서 '{certificate_name}'로 업데이트하고 기존 기본 CA 인증서를 제거합니다.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=
리소스 그룹 '{resource_group_name}'의 Azure IoT 프로비저닝 서비스 '{dps_name}'에서 등록 그룹 '{enrollment_id}'을 새 기본 키로 업데이트합니다.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
필수 매개 변수
Azure IoT Hub 디바이스 프로비저닝 서비스의 이름입니다.
등록 그룹의 ID입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
허브에 할당된 디바이스에 대한 할당 유형입니다.
사용자 지정 할당 요청에서 전송된 프로비전 서비스 유형의 API 버전입니다. 지원되는 최소 버전: 2018-09-01-preview.
기본 루트 CA 인증서의 이름입니다. 루트 CA 인증서가 있는 증명을 원하는 경우 루트 ca 이름을 제공해야 합니다.
기본 인증서를 포함하는 파일의 경로입니다. 중간 인증서가 있는 증명을 원하는 경우 인증서 경로를 제공해야 합니다.
에지 사용을 나타내는 플래그입니다.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
대상 IoT Hub 호스트 이름입니다.
대상 IoT Hub 호스트 이름입니다. 여러 IoT Hub에 대해 공백으로 구분된 목록을 사용합니다.
초기 쌍 속성입니다.
초기 쌍 태그입니다.
base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.
등록 항목을 사용하거나 사용하지 않도록 설정합니다.
현재 기본 인증서를 제거합니다.
현재 보조 인증서를 제거합니다.
다른 Iot Hub로 다시 프로비전할 때 처리할 디바이스 데이터입니다.
보조 루트 CA 인증서의 이름입니다. 루트 CA 인증서가 있는 증명을 원하는 경우 루트 ca 이름을 제공해야 합니다.
보조 인증서를 포함하는 파일의 경로입니다. 중간 인증서가 있는 증명을 원하는 경우 인증서 경로를 제공해야 합니다.
base64 형식으로 저장된 보조 대칭 공유 액세스 키입니다.
사용자 지정 할당 요청에 사용되는 웹후크 URL입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.