az iot dps enrollment-group

참고

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

Azure IoT Hub Device Provisioning Service를 관리합니다.

명령

az iot dps enrollment-group create

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

az iot dps enrollment-group delete

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

az iot dps enrollment-group list

Azure IoT Hub 장치 프로 비전 서비스에서 등록 그룹을 나열 합니다.

az iot dps enrollment-group show

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

az iot dps enrollment-group update

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

az iot dps enrollment-group create

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

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}

프로 비전 상태가 ' enabled ' 인 리소스 그룹 ' {resource_group_name} '의 Azure IoT 프로 비전 서비스 ' MyDps '에 등록 그룹 ' {enrollment_id} '을 (를) 만듭니다. 대상 IoT Hub ' {iothub_host_name} ', 초기 쌍 속성 ' {"location": {"region": "US"}} ' 및 초기 쌍 태그 ' {"version_dps": "1"} ' 기본 인증서로 중간 인증서 사용 '.

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}

필수 매개 변수

--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-미리 보기

--ca-name --cn --root-ca-name

주 루트 CA 인증서의 이름입니다. 루트 CA 인증서를 사용 하는 증명을 원하는 경우 루트 ca 이름을 제공 해야 합니다.

--certificate-path --cp

기본 인증서를 포함 하는 파일의 경로입니다. 중간 인증서를 사용 하는 증명을 원하는 경우 인증서 경로를 제공 해야 합니다.

--edge-enabled --ee

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

허용되는 값: false, true
--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
--scn --secondary-ca-name --secondary-root-ca-name

보조 루트 CA 인증서의 이름입니다. 루트 CA 인증서를 사용 하는 증명을 원하는 경우 루트 ca 이름을 제공 해야 합니다.

--scp --secondary-certificate-path

보조 인증서를 포함 하는 파일의 경로입니다. 중간 인증서를 사용 하는 증명을 원하는 경우 인증서 경로를 제공 해야 합니다.

--secondary-key --sk

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

--webhook-url --wh

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

az iot dps enrollment-group delete

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

az iot dps enrollment-group 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-group list

Azure IoT Hub 장치 프로 비전 서비스에서 등록 그룹을 나열 합니다.

az iot dps enrollment-group 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-group show

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

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}

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

az iot dps enrollment-group 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-group update

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

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=

새 보조 CA 인증서 ' {certificate_name} '를 사용 하 여 리소스 그룹 ' {resource_group_name} '의 Azure IoT 프로 비전 서비스 ' {dps_name} '에서 등록 그룹 ' {enrollment_id} '을 (를) 업데이트 하 고 기존 기본 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=

필수 매개 변수

--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-미리 보기

--ca-name --cn --root-ca-name

주 루트 CA 인증서의 이름입니다. 루트 CA 인증서를 사용 하는 증명을 원하는 경우 루트 ca 이름을 제공 해야 합니다.

--certificate-path --cp

기본 인증서를 포함 하는 파일의 경로입니다. 중간 인증서를 사용 하는 증명을 원하는 경우 인증서 경로를 제공 해야 합니다.

--edge-enabled --ee

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

허용되는 값: false, true
--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
--scn --secondary-ca-name --secondary-root-ca-name

보조 루트 CA 인증서의 이름입니다. 루트 CA 인증서를 사용 하는 증명을 원하는 경우 루트 ca 이름을 제공 해야 합니다.

--scp --secondary-certificate-path

보조 인증서를 포함 하는 파일의 경로입니다. 중간 인증서를 사용 하는 증명을 원하는 경우 인증서 경로를 제공 해야 합니다.

--secondary-key --sk

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

--webhook-url --wh

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