az iot central enrollment-group

참조

참고 항목

이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot central enrollment-group 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

IoT Central 등록 그룹을 관리하고 구성합니다.

명령

Name	Description	형식	상태
az iot central enrollment-group create	등록 그룹을 만듭니다.	내선 번호	GA
az iot central enrollment-group delete	ID별로 등록 그룹을 삭제합니다.	내선 번호	GA
az iot central enrollment-group generate-verification-code	등록 그룹의 기본 또는 보조 x509 인증서에 대한 확인 코드를 생성합니다.	내선 번호	GA
az iot central enrollment-group list	애플리케이션의 등록 그룹 목록을 가져옵니다.	내선 번호	GA
az iot central enrollment-group show	ID별로 등록 그룹에 대한 세부 정보를 가져옵니다.	내선 번호	GA
az iot central enrollment-group update	등록 그룹을 업데이트합니다.	내선 번호	GA
az iot central enrollment-group verify-certificate	등록 그룹의 기본 또는 보조 x509 인증서를 확인합니다.	내선 번호	GA

az iot central enrollment-group create

등록 그룹을 만듭니다.

az iot central enrollment-group create --app-id
                                       --at {symmetricKey, x509}
                                       --display-name
                                       --group-id
                                       --type
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--certificate-path]
                                       [--etag]
                                       [--pk]
                                       [--provisioning-status {disabled, enabled}]
                                       [--scp]
                                       [--secondary-key]
                                       [--token]

예제

등록 그룹 만들기

az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at {attestation} --display-name {displayName} --type {type}

x509 기본 인증을 사용하여 등록 그룹 만들기

az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at 'x509' --display-name {displayName} --type {type} --cp {primayCertPath}

지정된 대칭 키 인증을 사용하여 등록 그룹 만들기

az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at 'symmetricKey' --display-name {displayName} --type {type} --pk {primaryKey} --sk {secondaryKey}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--at --attestation-type

등록 그룹에 대한 증명 메커니즘입니다. 'x509' 또는 'symmetricKey'만 허용됩니다. 기본적으로 'symmetricKey'는 증명에 사용됩니다.

허용되는 값: symmetricKey, x509

Default value: symmetricKey

--display-name

등록 그룹의 표시 이름입니다.

--group-id --id

등록 그룹에 대한 고유 식별자입니다.

--type

그룹을 통해 연결하는 디바이스의 유형입니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--certificate-path --cp

기본 인증서를 포함하는 파일의 경로입니다.

--etag -e

리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 값 '*'이 사용됩니다.

--pk --primary-key

base64 형식으로 저장된 기본 대칭 공유 액세스 키입니다.

--provisioning-status --ps

그룹을 사용하는 디바이스가 IoT Central에 연결할 수 있는지 여부입니다. True 또는 False

허용되는 값: disabled, enabled

Default value: enabled

--scp --secondary-certificate-path

보조 인증서를 포함하는 파일의 경로입니다.

--secondary-key --sk

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

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central enrollment-group delete

ID별로 등록 그룹을 삭제합니다.

az iot central enrollment-group delete --app-id
                                       --group-id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--token]

예제

ID별로 등록 그룹 삭제

az iot central enrollment-group delete --app-id {appid} --id {enrollmentGroupId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--group-id --id

등록 그룹에 대한 고유 식별자입니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--token

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central enrollment-group generate-verification-code

등록 그룹의 기본 또는 보조 x509 인증서에 대한 확인 코드를 생성합니다.

az iot central enrollment-group generate-verification-code --app-id
                                                           --group-id
                                                           [--api-version {2022-06-30-preview, 2022-07-31}]
                                                           [--central-api-uri]
                                                           [--certificate-entry {primary, secondary}]
                                                           [--token]

예제

등록 그룹의 기본 x509 인증서에 대한 확인 코드 생성

az iot central enrollment-group generate-verification-code --app-id {appid} --id {enrollmentGroupId} --entry 'primary'

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--group-id --id

등록 그룹에 대한 고유 식별자입니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--certificate-entry --entry

'primary' 및 'secondary'만 허용하는 x509 인증서의 항목 유형입니다.

허용되는 값: primary, secondary

--token

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central enrollment-group list

애플리케이션의 등록 그룹 목록을 가져옵니다.

az iot central enrollment-group list --app-id
                                     [--api-version {2022-06-30-preview, 2022-07-31}]
                                     [--central-api-uri]
                                     [--token]

예제

애플리케이션에서 등록 그룹 목록 가져오기

az iot central enrollment-group list --app-id {appid}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--token

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central enrollment-group show

ID별로 등록 그룹에 대한 세부 정보를 가져옵니다.

az iot central enrollment-group show --app-id
                                     --group-id
                                     [--api-version {2022-06-30-preview, 2022-07-31}]
                                     [--central-api-uri]
                                     [--certificate-entry {primary, secondary}]
                                     [--token]

예제

ID별 등록 그룹에 대한 세부 정보 가져오기

az iot central enrollment-group show --app-id {appid} --id {enrollmentGroupId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--group-id --id

등록 그룹에 대한 고유 식별자입니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--certificate-entry --entry

'primary' 및 'secondary'만 허용하는 x509 인증서의 항목 유형입니다.

허용되는 값: primary, secondary

--token

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central enrollment-group update

등록 그룹을 업데이트합니다.

az iot central enrollment-group update --app-id
                                       --group-id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--certificate-entry {primary, secondary}]
                                       [--certificate-path]
                                       [--display-name]
                                       [--etag]
                                       [--provisioning-status {disabled, enabled}]
                                       [--remove-x509 {false, true}]
                                       [--scp]
                                       [--token]
                                       [--type]

예제

등록 그룹 업데이트

az iot central enrollment-group update --app-id {appid} --id {enrollmentGroupId} --display-name {displayName} --type {type} --ps {enabled}

등록 그룹에서 x509 기본 인증서 제거

az iot central enrollment-group update --app-id {appid} --id {enrollmentGroupId} --remove-x509 'true' --entry 'primary'

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--group-id --id

등록 그룹에 대한 고유 식별자입니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--certificate-entry --entry

'primary' 및 'secondary'만 허용하는 x509 인증서의 항목 유형입니다.

허용되는 값: primary, secondary

--certificate-path --cp

기본 인증서를 포함하는 파일의 경로입니다.

--display-name

등록 그룹의 표시 이름입니다.

--etag

등록 그룹 업데이트에서 충돌을 방지하는 데 사용되는 ETag입니다.

--provisioning-status --ps

그룹을 사용하는 디바이스가 IoT Central에 연결할 수 있는지 여부입니다. True 또는 False

허용되는 값: disabled, enabled

Default value: enabled

--remove-x509

x509 인증서를 그룹에서 제거할지 여부입니다. True 또는 False

허용되는 값: false, true

--scp --secondary-certificate-path

보조 인증서를 포함하는 파일의 경로입니다.

--token

--type

그룹을 통해 연결하는 디바이스의 유형입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central enrollment-group verify-certificate

등록 그룹의 기본 또는 보조 x509 인증서를 확인합니다.

서명된 확인 코드가 포함된 인증서를 제공하여 등록 그룹의 기본 또는 보조 x509 인증서를 확인합니다.

확인되지 않은 x509 인증서를 사용하여 등록 그룹을 만든 경우 이 명령을 사용하기 전에 확인되지 않은 x509 인증서 및 확인 코드를 사용하여 확인 인증서를 만들어야 합니다. 'enrollment-group generate-verification-code' 명령을 사용하여 CLI를 통해 확인 코드를 생성할 수 있습니다. 에서 확인 코드를 사용하여 확인 인증서를 만드는 방법에 대해 자세히 알아봅니다 https://learn.microsoft.com/en-us/azure/iot-central/core/how-to-connect-devices-x509.

az iot central enrollment-group verify-certificate --app-id
                                                   --group-id
                                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                                   [--central-api-uri]
                                                   [--certificate-path]
                                                   [--scp]
                                                   [--token]

예제

등록 그룹의 기본 x509 인증서 확인

az iot central enrollment-group verify-certificate --app-id {appid} --id {enrollmentGroupId} --cp {primayCertPath}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--group-id --id

등록 그룹에 대한 고유 식별자입니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--certificate-path --cp

기본 인증서를 포함하는 파일의 경로입니다.

--scp --secondary-certificate-path

보조 인증서를 포함하는 파일의 경로입니다.

--token

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

다음을 통해 공유

az iot central enrollment-group

명령

az iot central enrollment-group create

예제

필수 매개 변수

선택적 매개 변수

az iot central enrollment-group delete

예제

필수 매개 변수

선택적 매개 변수

az iot central enrollment-group generate-verification-code

예제

필수 매개 변수

선택적 매개 변수

az iot central enrollment-group list

예제

필수 매개 변수

선택적 매개 변수

az iot central enrollment-group show

예제

필수 매개 변수

선택적 매개 변수

az iot central enrollment-group update

예제

필수 매개 변수

선택적 매개 변수

az iot central enrollment-group verify-certificate

예제

필수 매개 변수

선택적 매개 변수

추가 리소스