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}

필수 매개 변수

--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-preview.

--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

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

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]

필수 매개 변수

--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 Device Provisioning Service의 등록 그룹을 나열합니다.

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 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

필수 매개 변수

--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 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=

필수 매개 변수

--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-preview.

--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

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